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

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

[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.

Signed-off-by: SeongJae Park <sj@kernel.org>
---
 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%)

diff --git a/Documentation/translations/ko_KR/index.rst b/Documentation/translations/ko_KR/index.rst
index 4add6b2fe1f2..2d51f1481310 100644
--- a/Documentation/translations/ko_KR/index.rst
+++ b/Documentation/translations/ko_KR/index.rst
@@ -11,7 +11,7 @@
 .. toctree::
    :maxdepth: 1
 
-   howto
+   process/howto
 
 
 리눅스 커널 메모리 배리어
diff --git a/Documentation/translations/ko_KR/howto.rst b/Documentation/translations/ko_KR/process/howto.rst
similarity index 100%
rename from Documentation/translations/ko_KR/howto.rst
rename to Documentation/translations/ko_KR/process/howto.rst
-- 
2.39.2

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

[SeongJae Park]

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.

Signed-off-by: SeongJae Park <sj@kernel.org>
---
 .../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

diff --git a/Documentation/translations/ko_KR/core-api/wrappers/memory-barriers.rst b/Documentation/translations/ko_KR/core-api/wrappers/memory-barriers.rst
new file mode 100644
index 000000000000..526ae534dd86
--- /dev/null
+++ b/Documentation/translations/ko_KR/core-api/wrappers/memory-barriers.rst
@@ -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
diff --git a/Documentation/translations/ko_KR/index.rst b/Documentation/translations/ko_KR/index.rst
index 2d51f1481310..a20772f9d61c 100644
--- a/Documentation/translations/ko_KR/index.rst
+++ b/Documentation/translations/ko_KR/index.rst
@@ -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
-- 
2.39.2

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

[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/

Signed-off-by: SeongJae Park <sj@kernel.org>
---
 Documentation/filesystems/9p.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/filesystems/9p.rst b/Documentation/filesystems/9p.rst
index 1e0e0bb6fdf9..50dc82f33726 100644
--- a/Documentation/filesystems/9p.rst
+++ b/Documentation/filesystems/9p.rst
@@ -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
 =====
-- 
2.39.2

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

[Dominique Martinet]

SeongJae Park wrote on Sun, Aug 25, 2024 at 06:09:49PM -0700:
> 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/
> 
> Signed-off-by: SeongJae Park <sj@kernel.org>

Sorry, we (9p maintainers) slacked on this one - there's been a better
patch for this one:
https://lkml.kernel.org/r/20240725180041.80862-1-linux@treblig.org

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,
-- 
Dominique

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

[SeongJae Park]

On Mon, 26 Aug 2024 10:18:47 +0900 Dominique Martinet <asmadeus@codewreck.org> wrote:

> SeongJae Park wrote on Sun, Aug 25, 2024 at 06:09:49PM -0700:
> > 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/
> > 
> > Signed-off-by: SeongJae Park <sj@kernel.org>
> 
> Sorry, we (9p maintainers) slacked on this one - there's been a better
> patch for this one:
> https://lkml.kernel.org/r/20240725180041.80862-1-linux@treblig.org
> 
> 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.

> 
> 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.

> (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

> 
> 
> Thanks,
> -- 
> Dominique

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

[Jonathan Corbet]

Dominique Martinet <asmadeus@codewreck.org> writes:

> SeongJae Park wrote on Sun, Aug 25, 2024 at 06:09:49PM -0700:
>> 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/
>> 
>> Signed-off-by: SeongJae Park <sj@kernel.org>
>
> Sorry, we (9p maintainers) slacked on this one - there's been a better
> patch for this one:
> https://lkml.kernel.org/r/20240725180041.80862-1-linux@treblig.org
>
> 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

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

[Jonathan Corbet]

SeongJae Park <sj@kernel.org> writes:

> 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.
>
> Signed-off-by: SeongJae Park <sj@kernel.org>
> ---
>  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