Skip to contentSkip to conversation

Docs/translations/ko_KR: link howto.rst with other language versions

PATCH Applied SeongJae Park 3 participants 7 messages Aug 26, 2024

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/3 Docs/translations/ko_KR: link howto.rst with other language versions

The menu for documents of other available languages is created for documents in same file hierarchy under the translations/ directory. Because howto.rst of Korean translation is at the root of translations/ directory while that for English is under howto/ directory, the Korean translation is not linked with other available language versions via the menu. Move the document under the same hierarchy to make it be linked with other langauge versions.

---
 Documentation/translations/ko_KR/index.rst               | 2 +-
 Documentation/translations/ko_KR/{ => process}/howto.rst | 0
 2 files changed, 1 insertion(+), 1 deletion(-)
 rename Documentation/translations/ko_KR/{ => process}/howto.rst (100%)
Documentation/translations/ko_KR/index.rst +1 -1
index 4add6b2fe1f2..2d51f1481310 100644
@@ -11,7 +11,7 @@
 .. toctree::
    :maxdepth: 1
 
-   howto
+   process/howto
 
 
 리눅스 커널 메모리 배리어
Documentation/translations/ko_KR/process/howto.rst renamed from Documentation/translations/ko_KR/howto.rst +0 -0
similarity index 100%
rename from Documentation/translations/ko_KR/howto.rst
rename to Documentation/translations/ko_KR/process/howto.rst
Signature · 1 line
2.39.2
#1 lore raw

PATCH 2/3 Docs/translations/ko_KR: link memory-barriers wrapper with other language versions

The menu for documents of other available languages is created for documents in same file hierarchy under the translations/ directory. Because memory-barriers.txt of Korean translation is at the root index of translations/ directory while that for English is on core-api/wrappers/memory-barriers.rst, the Korean translation is not linked with other available language versions via the menu. Move the document under the same directory hierarchy to make it linked with other language versions.

---
 .../core-api/wrappers/memory-barriers.rst      | 18 ++++++++++++++++++
 Documentation/translations/ko_KR/index.rst     | 14 ++------------
 2 files changed, 20 insertions(+), 12 deletions(-)
 create mode 100644 Documentation/translations/ko_KR/core-api/wrappers/memory-barriers.rst
Documentation/translations/ko_KR/core-api/wrappers/memory-barriers.rst new file +18 -0
new file mode 100644
index 000000000000..526ae534dd86
@@ -0,0 +1,18 @@
+.. SPDX-License-Identifier: GPL-2.0
+   This is a simple wrapper to bring memory-barriers.txt into the RST world
+   until such a time as that file can be converted directly.
+
+=========================
+리눅스 커널 메모리 배리어
+=========================
+
+.. raw:: latex
+
+    \footnotesize
+
+.. include:: ../../memory-barriers.txt
+    :literal:
+
+.. raw:: latex
+
+    \normalsize
Documentation/translations/ko_KR/index.rst +2 -12
index 2d51f1481310..a20772f9d61c 100644
@@ -12,18 +12,8 @@
    :maxdepth: 1
 
    process/howto
-
-
-리눅스 커널 메모리 배리어
--------------------------
-
-.. raw:: latex
-
-    \footnotesize
-
-.. include:: ./memory-barriers.txt
-    :literal:
+   core-api/wrappers/memory-barriers.rst
 
 .. raw:: latex
 
-    }\kerneldocEndKR
+       }\kerneldocEndKR
Signature · 1 line
2.39.2
#2 lore raw

PATCH 3/3 Docs/filesystems/9p: Convert a goo.gl URL to original one

In reply to SeongJae Park

Google URL shortner will be unavailable soon[1]. Replace a shortened URL on 9p.rst with its original one.

[1] https://developers.googleblog.com/en/google-url-shortener-links-will-no-longer-be-available/

---
 Documentation/filesystems/9p.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
Documentation/filesystems/9p.rst +1 -1
index 1e0e0bb6fdf9..50dc82f33726 100644
@@ -31,7 +31,7 @@ Other applications are described in the following papers:
 	* PROSE I/O: Using 9p to enable Application Partitions
 	  http://plan9.escet.urjc.es/iwp9/cready/PROSE_iwp9_2006.pdf
 	* VirtFS: A Virtualization Aware File System pass-through
-	  http://goo.gl/3WPDg
+          https://www.sciweavers.org/publications/virtfs-virtualization-aware-file-system-pass-through
 
 Usage
 =====
Signature · 1 line
2.39.2
#3 lore raw

Re: [PATCH 3/3] Docs/filesystems/9p: Convert a goo.gl URL to original one

SeongJae Park wrote on Sun, Aug 25, 2024 at 06:09:49PM -0700:

Quoted 6 lines

Google URL shortner will be unavailable soon[1]. Replace a shortened URL on 9p.rst with its original one.

[1] https://developers.googleblog.com/en/google-url-shortener-links-will-no-longer-be-available/

Sorry, we (9p maintainers) slacked on this one - there's been a better patch for this one:
https://lkml.kernel.org/r/[email protected]

The sciweavers link doesn't actually work, so it doesn't make sense to replace as is.
(although you could argue that it's probably been broken forever an nobody noticed, so it could just as well be removed...)

There's no patch queued for 9p, so if you (Jonathan) want to take the other patch please feel free to.
If it goes through the 9p tree it'll get in the next time we send something as I don't feel the need to send Linus a PR just for this, so that might be a couple of months further down.
(I don't like patch series where folks are added in Cc on individual patches because it's never clear who is expected to grab the patch in the end...)

Thanks,

Signature · 1 line
Dominique
#4 lore raw

Re: [PATCH 3/3] Docs/filesystems/9p: Convert a goo.gl URL to original one

Quoted 8 lines · On Mon, 26 Aug 2024 10:18:47 +0900 Dominique Martinet <[email protected]>…

SeongJae Park wrote on Sun, Aug 25, 2024 at 06:09:49PM -0700:

Quoted 6 lines

Google URL shortner will be unavailable soon[1]. Replace a shortened URL on 9p.rst with its original one.

[1] https://developers.googleblog.com/en/google-url-shortener-links-will-no-longer-be-available/

Quoted 8 lines

Sorry, we (9p maintainers) slacked on this one - there's been a better patch for this one:
https://lkml.kernel.org/r/[email protected]

The sciweavers link doesn't actually work, so it doesn't make sense to replace as is.
(although you could argue that it's probably been broken forever an nobody noticed, so it could just as well be removed...)

No problem. I agree the other patch is better.

Quoted 6 lines

There's no patch queued for 9p, so if you (Jonathan) want to take the other patch please feel free to.
If it goes through the 9p tree it'll get in the next time we send something as I don't feel the need to send Linus a PR just for this, so that might be a couple of months further down.

Either ways look good to me.

Quoted 3 lines

(I don't like patch series where folks are added in Cc on individual patches because it's never clear who is expected to grab the patch in the end...)

Sorry for that. I thoght lore.kernel.org should help getting the context, but I understand no one can convince all. I'll try to take a different approach if I have a chance to send patches to you next time.

Thanks,
SJ

Quoted 5 lines

Thanks,

Signature · 1 line
Dominique
maintainer
#5 lore raw

Re: [PATCH 3/3] Docs/filesystems/9p: Convert a goo.gl URL to original one

In reply to Dominique Martinet
Quoted 12 lines · Dominique Martinet

SeongJae Park wrote on Sun, Aug 25, 2024 at 06:09:49PM -0700:

Quoted 6 lines

Google URL shortner will be unavailable soon[1]. Replace a shortened URL on 9p.rst with its original one.

[1] https://developers.googleblog.com/en/google-url-shortener-links-will-no-longer-be-available/

Sorry, we (9p maintainers) slacked on this one - there's been a better patch for this one:
https://lkml.kernel.org/r/[email protected]

Quoted 7 lines

The sciweavers link doesn't actually work, so it doesn't make sense to replace as is.
(although you could argue that it's probably been broken forever an nobody noticed, so it could just as well be removed...)

There's no patch queued for 9p, so if you (Jonathan) want to take the other patch please feel free to.

It wasn't sent to me ... how did we ever manage without b4? I've applied, it, thanks.

jon

maintainer Applied
#6 lore raw
In reply to SeongJae Park
Quoted 8 lines · SeongJae Park

The menu for documents of other available languages is created for documents in same file hierarchy under the translations/ directory. Because howto.rst of Korean translation is at the root of translations/ directory while that for English is under howto/ directory, the Korean translation is not linked with other available language versions via the menu. Move the document under the same hierarchy to make it be linked with other langauge versions.

Quoted 6 lines
---
 Documentation/translations/ko_KR/index.rst               | 2 +-
 Documentation/translations/ko_KR/{ => process}/howto.rst | 0
 2 files changed, 1 insertion(+), 1 deletion(-)
 rename Documentation/translations/ko_KR/{ => process}/howto.rst (100%)

I've applied the first two patches, thanks.

jon