[v3] docs: move loongarch under arch

Message ID 20230717192456.453124-1-costa.shul@redhat.com
State New
Headers
Series [v3] docs: move loongarch under arch |

Commit Message

Costa Shulyupin July 17, 2023, 7:24 p.m. UTC
  and fix all in-tree references.

Architecture-specific documentation is being moved into Documentation/arch/
as a way of cleaning up the top-level documentation directory and making
the docs hierarchy more closely match the source hierarchy.

Signed-off-by: Costa Shulyupin <costa.shul@redhat.com>

---

Changes:
v3: fixed typo in drivers/irqchip/Kconfig
v2: added fix of MAINTAINERS and drivers/irqchip/Kconfig

I'll continue with the rest architectures.
Thank you.
---
 Documentation/arch/index.rst                                  | 2 +-
 Documentation/{ => arch}/loongarch/booting.rst                | 0
 Documentation/{ => arch}/loongarch/features.rst               | 0
 Documentation/{ => arch}/loongarch/index.rst                  | 0
 Documentation/{ => arch}/loongarch/introduction.rst           | 0
 Documentation/{ => arch}/loongarch/irq-chip-model.rst         | 0
 Documentation/translations/zh_CN/arch/index.rst               | 2 +-
 .../translations/zh_CN/{ => arch}/loongarch/booting.rst       | 4 ++--
 .../translations/zh_CN/{ => arch}/loongarch/features.rst      | 4 ++--
 .../translations/zh_CN/{ => arch}/loongarch/index.rst         | 4 ++--
 .../translations/zh_CN/{ => arch}/loongarch/introduction.rst  | 4 ++--
 .../zh_CN/{ => arch}/loongarch/irq-chip-model.rst             | 4 ++--
 MAINTAINERS                                                   | 4 ++--
 drivers/irqchip/Kconfig                                       | 2 +-
 14 files changed, 15 insertions(+), 15 deletions(-)
 rename Documentation/{ => arch}/loongarch/booting.rst (100%)
 rename Documentation/{ => arch}/loongarch/features.rst (100%)
 rename Documentation/{ => arch}/loongarch/index.rst (100%)
 rename Documentation/{ => arch}/loongarch/introduction.rst (100%)
 rename Documentation/{ => arch}/loongarch/irq-chip-model.rst (100%)
 rename Documentation/translations/zh_CN/{ => arch}/loongarch/booting.rst (94%)
 rename Documentation/translations/zh_CN/{ => arch}/loongarch/features.rst (61%)
 rename Documentation/translations/zh_CN/{ => arch}/loongarch/index.rst (78%)
 rename Documentation/translations/zh_CN/{ => arch}/loongarch/introduction.rst (99%)
 rename Documentation/translations/zh_CN/{ => arch}/loongarch/irq-chip-model.rst (98%)
  

Comments

Yanteng Si July 18, 2023, 2:16 a.m. UTC | #1
在 2023/7/18 03:24, Costa Shulyupin 写道:
> and fix all in-tree references.
>
> Architecture-specific documentation is being moved into Documentation/arch/
> as a way of cleaning up the top-level documentation directory and making
> the docs hierarchy more closely match the source hierarchy.
>
> Signed-off-by: Costa Shulyupin <costa.shul@redhat.com>

Reviewed-by: Yanteng Si <siyanteng@loongson.cn>


Thanks,

Yanteng

> ---
>
> Changes:
> v3: fixed typo in drivers/irqchip/Kconfig
> v2: added fix of MAINTAINERS and drivers/irqchip/Kconfig
>
> I'll continue with the rest architectures.
> Thank you.
> ---
>   Documentation/arch/index.rst                                  | 2 +-
>   Documentation/{ => arch}/loongarch/booting.rst                | 0
>   Documentation/{ => arch}/loongarch/features.rst               | 0
>   Documentation/{ => arch}/loongarch/index.rst                  | 0
>   Documentation/{ => arch}/loongarch/introduction.rst           | 0
>   Documentation/{ => arch}/loongarch/irq-chip-model.rst         | 0
>   Documentation/translations/zh_CN/arch/index.rst               | 2 +-
>   .../translations/zh_CN/{ => arch}/loongarch/booting.rst       | 4 ++--
>   .../translations/zh_CN/{ => arch}/loongarch/features.rst      | 4 ++--
>   .../translations/zh_CN/{ => arch}/loongarch/index.rst         | 4 ++--
>   .../translations/zh_CN/{ => arch}/loongarch/introduction.rst  | 4 ++--
>   .../zh_CN/{ => arch}/loongarch/irq-chip-model.rst             | 4 ++--
>   MAINTAINERS                                                   | 4 ++--
>   drivers/irqchip/Kconfig                                       | 2 +-
>   14 files changed, 15 insertions(+), 15 deletions(-)
>   rename Documentation/{ => arch}/loongarch/booting.rst (100%)
>   rename Documentation/{ => arch}/loongarch/features.rst (100%)
>   rename Documentation/{ => arch}/loongarch/index.rst (100%)
>   rename Documentation/{ => arch}/loongarch/introduction.rst (100%)
>   rename Documentation/{ => arch}/loongarch/irq-chip-model.rst (100%)
>   rename Documentation/translations/zh_CN/{ => arch}/loongarch/booting.rst (94%)
>   rename Documentation/translations/zh_CN/{ => arch}/loongarch/features.rst (61%)
>   rename Documentation/translations/zh_CN/{ => arch}/loongarch/index.rst (78%)
>   rename Documentation/translations/zh_CN/{ => arch}/loongarch/introduction.rst (99%)
>   rename Documentation/translations/zh_CN/{ => arch}/loongarch/irq-chip-model.rst (98%)
>
> diff --git a/Documentation/arch/index.rst b/Documentation/arch/index.rst
> index 8458b88e9b79..4b6b1beebad6 100644
> --- a/Documentation/arch/index.rst
> +++ b/Documentation/arch/index.rst
> @@ -13,7 +13,7 @@ implementation.
>      arm/index
>      arm64/index
>      ia64/index
> -   ../loongarch/index
> +   loongarch/index
>      m68k/index
>      ../mips/index
>      nios2/index
> diff --git a/Documentation/loongarch/booting.rst b/Documentation/arch/loongarch/booting.rst
> similarity index 100%
> rename from Documentation/loongarch/booting.rst
> rename to Documentation/arch/loongarch/booting.rst
> diff --git a/Documentation/loongarch/features.rst b/Documentation/arch/loongarch/features.rst
> similarity index 100%
> rename from Documentation/loongarch/features.rst
> rename to Documentation/arch/loongarch/features.rst
> diff --git a/Documentation/loongarch/index.rst b/Documentation/arch/loongarch/index.rst
> similarity index 100%
> rename from Documentation/loongarch/index.rst
> rename to Documentation/arch/loongarch/index.rst
> diff --git a/Documentation/loongarch/introduction.rst b/Documentation/arch/loongarch/introduction.rst
> similarity index 100%
> rename from Documentation/loongarch/introduction.rst
> rename to Documentation/arch/loongarch/introduction.rst
> diff --git a/Documentation/loongarch/irq-chip-model.rst b/Documentation/arch/loongarch/irq-chip-model.rst
> similarity index 100%
> rename from Documentation/loongarch/irq-chip-model.rst
> rename to Documentation/arch/loongarch/irq-chip-model.rst
> diff --git a/Documentation/translations/zh_CN/arch/index.rst b/Documentation/translations/zh_CN/arch/index.rst
> index 6fa0cb671009..d4c1c729dde2 100644
> --- a/Documentation/translations/zh_CN/arch/index.rst
> +++ b/Documentation/translations/zh_CN/arch/index.rst
> @@ -13,7 +13,7 @@
>      ../riscv/index
>      openrisc/index
>      parisc/index
> -   ../loongarch/index
> +   loongarch/index
>   
>   TODOList:
>   
> diff --git a/Documentation/translations/zh_CN/loongarch/booting.rst b/Documentation/translations/zh_CN/arch/loongarch/booting.rst
> similarity index 94%
> rename from Documentation/translations/zh_CN/loongarch/booting.rst
> rename to Documentation/translations/zh_CN/arch/loongarch/booting.rst
> index fb6440c438f0..d2f55872904e 100644
> --- a/Documentation/translations/zh_CN/loongarch/booting.rst
> +++ b/Documentation/translations/zh_CN/arch/loongarch/booting.rst
> @@ -1,8 +1,8 @@
>   .. SPDX-License-Identifier: GPL-2.0
>   
> -.. include:: ../disclaimer-zh_CN.rst
> +.. include:: ../../disclaimer-zh_CN.rst
>   
> -:Original: Documentation/loongarch/booting.rst
> +:Original: Documentation/arch/loongarch/booting.rst
>   
>   :翻译:
>   
> diff --git a/Documentation/translations/zh_CN/loongarch/features.rst b/Documentation/translations/zh_CN/arch/loongarch/features.rst
> similarity index 61%
> rename from Documentation/translations/zh_CN/loongarch/features.rst
> rename to Documentation/translations/zh_CN/arch/loongarch/features.rst
> index 3886e635ec06..82bfac180bdc 100644
> --- a/Documentation/translations/zh_CN/loongarch/features.rst
> +++ b/Documentation/translations/zh_CN/arch/loongarch/features.rst
> @@ -1,8 +1,8 @@
>   .. SPDX-License-Identifier: GPL-2.0
>   
> -.. include:: ../disclaimer-zh_CN.rst
> +.. include:: ../../disclaimer-zh_CN.rst
>   
> -:Original: Documentation/loongarch/features.rst
> +:Original: Documentation/arch/loongarch/features.rst
>   :Translator: Huacai Chen <chenhuacai@loongson.cn>
>   
>   .. kernel-feat:: $srctree/Documentation/features loongarch
> diff --git a/Documentation/translations/zh_CN/loongarch/index.rst b/Documentation/translations/zh_CN/arch/loongarch/index.rst
> similarity index 78%
> rename from Documentation/translations/zh_CN/loongarch/index.rst
> rename to Documentation/translations/zh_CN/arch/loongarch/index.rst
> index 0273a08342f7..4bd24f5ffed1 100644
> --- a/Documentation/translations/zh_CN/loongarch/index.rst
> +++ b/Documentation/translations/zh_CN/arch/loongarch/index.rst
> @@ -1,8 +1,8 @@
>   .. SPDX-License-Identifier: GPL-2.0
>   
> -.. include:: ../disclaimer-zh_CN.rst
> +.. include:: ../../disclaimer-zh_CN.rst
>   
> -:Original: Documentation/loongarch/index.rst
> +:Original: Documentation/arch/loongarch/index.rst
>   :Translator: Huacai Chen <chenhuacai@loongson.cn>
>   
>   =================
> diff --git a/Documentation/translations/zh_CN/loongarch/introduction.rst b/Documentation/translations/zh_CN/arch/loongarch/introduction.rst
> similarity index 99%
> rename from Documentation/translations/zh_CN/loongarch/introduction.rst
> rename to Documentation/translations/zh_CN/arch/loongarch/introduction.rst
> index 470c38ae2caf..cba04befc950 100644
> --- a/Documentation/translations/zh_CN/loongarch/introduction.rst
> +++ b/Documentation/translations/zh_CN/arch/loongarch/introduction.rst
> @@ -1,8 +1,8 @@
>   .. SPDX-License-Identifier: GPL-2.0
>   
> -.. include:: ../disclaimer-zh_CN.rst
> +.. include:: ../../disclaimer-zh_CN.rst
>   
> -:Original: Documentation/loongarch/introduction.rst
> +:Original: Documentation/arch/loongarch/introduction.rst
>   :Translator: Huacai Chen <chenhuacai@loongson.cn>
>   
>   =============
> diff --git a/Documentation/translations/zh_CN/loongarch/irq-chip-model.rst b/Documentation/translations/zh_CN/arch/loongarch/irq-chip-model.rst
> similarity index 98%
> rename from Documentation/translations/zh_CN/loongarch/irq-chip-model.rst
> rename to Documentation/translations/zh_CN/arch/loongarch/irq-chip-model.rst
> index fb5d23b49ed5..f1e9ab18206c 100644
> --- a/Documentation/translations/zh_CN/loongarch/irq-chip-model.rst
> +++ b/Documentation/translations/zh_CN/arch/loongarch/irq-chip-model.rst
> @@ -1,8 +1,8 @@
>   .. SPDX-License-Identifier: GPL-2.0
>   
> -.. include:: ../disclaimer-zh_CN.rst
> +.. include:: ../../disclaimer-zh_CN.rst
>   
> -:Original: Documentation/loongarch/irq-chip-model.rst
> +:Original: Documentation/arch/loongarch/irq-chip-model.rst
>   :Translator: Huacai Chen <chenhuacai@loongson.cn>
>   
>   ==================================
> diff --git a/MAINTAINERS b/MAINTAINERS
> index d0ccb621a660..b68512f1b65f 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -12282,8 +12282,8 @@ R:	WANG Xuerui <kernel@xen0n.name>
>   L:	loongarch@lists.linux.dev
>   S:	Maintained
>   T:	git git://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson.git
> -F:	Documentation/loongarch/
> -F:	Documentation/translations/zh_CN/loongarch/
> +F:	Documentation/arch/loongarch/
> +F:	Documentation/translations/zh_CN/arch/loongarch/
>   F:	arch/loongarch/
>   F:	drivers/*/*loongarch*
>   
> diff --git a/drivers/irqchip/Kconfig b/drivers/irqchip/Kconfig
> index 4b9036c6d45b..f7149d0f3d45 100644
> --- a/drivers/irqchip/Kconfig
> +++ b/drivers/irqchip/Kconfig
> @@ -567,7 +567,7 @@ config IRQ_LOONGARCH_CPU
>   	help
>   	  Support for the LoongArch CPU Interrupt Controller. For details of
>   	  irq chip hierarchy on LoongArch platforms please read the document
> -	  Documentation/loongarch/irq-chip-model.rst.
> +	  Documentation/arch/loongarch/irq-chip-model.rst.
>   
>   config LOONGSON_LIOINTC
>   	bool "Loongson Local I/O Interrupt Controller"
  
Jonathan Corbet July 21, 2023, 8:02 p.m. UTC | #2
Costa Shulyupin <costa.shul@redhat.com> writes:

> and fix all in-tree references.
>
> Architecture-specific documentation is being moved into Documentation/arch/
> as a way of cleaning up the top-level documentation directory and making
> the docs hierarchy more closely match the source hierarchy.
>
> Signed-off-by: Costa Shulyupin <costa.shul@redhat.com>
>

This, I think, is ready to apply, but I sure would like an ack from the
loongarch maintainers.  As it stands, please let me know if you object,
otherwise I'll apply this in the near future.

Thanks,

jon
  
Huacai Chen July 22, 2023, 2:38 a.m. UTC | #3
Hi, Jonathan,

On Sat, Jul 22, 2023 at 4:02 AM Jonathan Corbet <corbet@lwn.net> wrote:
>
> Costa Shulyupin <costa.shul@redhat.com> writes:
>
> > and fix all in-tree references.
> >
> > Architecture-specific documentation is being moved into Documentation/arch/
> > as a way of cleaning up the top-level documentation directory and making
> > the docs hierarchy more closely match the source hierarchy.
> >
> > Signed-off-by: Costa Shulyupin <costa.shul@redhat.com>
> >
>
> This, I think, is ready to apply, but I sure would like an ack from the
> loongarch maintainers.  As it stands, please let me know if you object,
> otherwise I'll apply this in the near future.
This looks good to me.
Acked-by: Huacai Chen <chenhuacai@loongson.cn>

>
> Thanks,
>
> jon
  
Jonathan Corbet July 31, 2023, 4:31 p.m. UTC | #4
Costa Shulyupin <costa.shul@redhat.com> writes:

> and fix all in-tree references.
>
> Architecture-specific documentation is being moved into Documentation/arch/
> as a way of cleaning up the top-level documentation directory and making
> the docs hierarchy more closely match the source hierarchy.
>
> Signed-off-by: Costa Shulyupin <costa.shul@redhat.com>
>
> ---
>
> Changes:
> v3: fixed typo in drivers/irqchip/Kconfig
> v2: added fix of MAINTAINERS and drivers/irqchip/Kconfig
>
> I'll continue with the rest architectures.
> Thank you.
> ---

Applied, thanks.

jon
  

Patch

diff --git a/Documentation/arch/index.rst b/Documentation/arch/index.rst
index 8458b88e9b79..4b6b1beebad6 100644
--- a/Documentation/arch/index.rst
+++ b/Documentation/arch/index.rst
@@ -13,7 +13,7 @@  implementation.
    arm/index
    arm64/index
    ia64/index
-   ../loongarch/index
+   loongarch/index
    m68k/index
    ../mips/index
    nios2/index
diff --git a/Documentation/loongarch/booting.rst b/Documentation/arch/loongarch/booting.rst
similarity index 100%
rename from Documentation/loongarch/booting.rst
rename to Documentation/arch/loongarch/booting.rst
diff --git a/Documentation/loongarch/features.rst b/Documentation/arch/loongarch/features.rst
similarity index 100%
rename from Documentation/loongarch/features.rst
rename to Documentation/arch/loongarch/features.rst
diff --git a/Documentation/loongarch/index.rst b/Documentation/arch/loongarch/index.rst
similarity index 100%
rename from Documentation/loongarch/index.rst
rename to Documentation/arch/loongarch/index.rst
diff --git a/Documentation/loongarch/introduction.rst b/Documentation/arch/loongarch/introduction.rst
similarity index 100%
rename from Documentation/loongarch/introduction.rst
rename to Documentation/arch/loongarch/introduction.rst
diff --git a/Documentation/loongarch/irq-chip-model.rst b/Documentation/arch/loongarch/irq-chip-model.rst
similarity index 100%
rename from Documentation/loongarch/irq-chip-model.rst
rename to Documentation/arch/loongarch/irq-chip-model.rst
diff --git a/Documentation/translations/zh_CN/arch/index.rst b/Documentation/translations/zh_CN/arch/index.rst
index 6fa0cb671009..d4c1c729dde2 100644
--- a/Documentation/translations/zh_CN/arch/index.rst
+++ b/Documentation/translations/zh_CN/arch/index.rst
@@ -13,7 +13,7 @@ 
    ../riscv/index
    openrisc/index
    parisc/index
-   ../loongarch/index
+   loongarch/index
 
 TODOList:
 
diff --git a/Documentation/translations/zh_CN/loongarch/booting.rst b/Documentation/translations/zh_CN/arch/loongarch/booting.rst
similarity index 94%
rename from Documentation/translations/zh_CN/loongarch/booting.rst
rename to Documentation/translations/zh_CN/arch/loongarch/booting.rst
index fb6440c438f0..d2f55872904e 100644
--- a/Documentation/translations/zh_CN/loongarch/booting.rst
+++ b/Documentation/translations/zh_CN/arch/loongarch/booting.rst
@@ -1,8 +1,8 @@ 
 .. SPDX-License-Identifier: GPL-2.0
 
-.. include:: ../disclaimer-zh_CN.rst
+.. include:: ../../disclaimer-zh_CN.rst
 
-:Original: Documentation/loongarch/booting.rst
+:Original: Documentation/arch/loongarch/booting.rst
 
 :翻译:
 
diff --git a/Documentation/translations/zh_CN/loongarch/features.rst b/Documentation/translations/zh_CN/arch/loongarch/features.rst
similarity index 61%
rename from Documentation/translations/zh_CN/loongarch/features.rst
rename to Documentation/translations/zh_CN/arch/loongarch/features.rst
index 3886e635ec06..82bfac180bdc 100644
--- a/Documentation/translations/zh_CN/loongarch/features.rst
+++ b/Documentation/translations/zh_CN/arch/loongarch/features.rst
@@ -1,8 +1,8 @@ 
 .. SPDX-License-Identifier: GPL-2.0
 
-.. include:: ../disclaimer-zh_CN.rst
+.. include:: ../../disclaimer-zh_CN.rst
 
-:Original: Documentation/loongarch/features.rst
+:Original: Documentation/arch/loongarch/features.rst
 :Translator: Huacai Chen <chenhuacai@loongson.cn>
 
 .. kernel-feat:: $srctree/Documentation/features loongarch
diff --git a/Documentation/translations/zh_CN/loongarch/index.rst b/Documentation/translations/zh_CN/arch/loongarch/index.rst
similarity index 78%
rename from Documentation/translations/zh_CN/loongarch/index.rst
rename to Documentation/translations/zh_CN/arch/loongarch/index.rst
index 0273a08342f7..4bd24f5ffed1 100644
--- a/Documentation/translations/zh_CN/loongarch/index.rst
+++ b/Documentation/translations/zh_CN/arch/loongarch/index.rst
@@ -1,8 +1,8 @@ 
 .. SPDX-License-Identifier: GPL-2.0
 
-.. include:: ../disclaimer-zh_CN.rst
+.. include:: ../../disclaimer-zh_CN.rst
 
-:Original: Documentation/loongarch/index.rst
+:Original: Documentation/arch/loongarch/index.rst
 :Translator: Huacai Chen <chenhuacai@loongson.cn>
 
 =================
diff --git a/Documentation/translations/zh_CN/loongarch/introduction.rst b/Documentation/translations/zh_CN/arch/loongarch/introduction.rst
similarity index 99%
rename from Documentation/translations/zh_CN/loongarch/introduction.rst
rename to Documentation/translations/zh_CN/arch/loongarch/introduction.rst
index 470c38ae2caf..cba04befc950 100644
--- a/Documentation/translations/zh_CN/loongarch/introduction.rst
+++ b/Documentation/translations/zh_CN/arch/loongarch/introduction.rst
@@ -1,8 +1,8 @@ 
 .. SPDX-License-Identifier: GPL-2.0
 
-.. include:: ../disclaimer-zh_CN.rst
+.. include:: ../../disclaimer-zh_CN.rst
 
-:Original: Documentation/loongarch/introduction.rst
+:Original: Documentation/arch/loongarch/introduction.rst
 :Translator: Huacai Chen <chenhuacai@loongson.cn>
 
 =============
diff --git a/Documentation/translations/zh_CN/loongarch/irq-chip-model.rst b/Documentation/translations/zh_CN/arch/loongarch/irq-chip-model.rst
similarity index 98%
rename from Documentation/translations/zh_CN/loongarch/irq-chip-model.rst
rename to Documentation/translations/zh_CN/arch/loongarch/irq-chip-model.rst
index fb5d23b49ed5..f1e9ab18206c 100644
--- a/Documentation/translations/zh_CN/loongarch/irq-chip-model.rst
+++ b/Documentation/translations/zh_CN/arch/loongarch/irq-chip-model.rst
@@ -1,8 +1,8 @@ 
 .. SPDX-License-Identifier: GPL-2.0
 
-.. include:: ../disclaimer-zh_CN.rst
+.. include:: ../../disclaimer-zh_CN.rst
 
-:Original: Documentation/loongarch/irq-chip-model.rst
+:Original: Documentation/arch/loongarch/irq-chip-model.rst
 :Translator: Huacai Chen <chenhuacai@loongson.cn>
 
 ==================================
diff --git a/MAINTAINERS b/MAINTAINERS
index d0ccb621a660..b68512f1b65f 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -12282,8 +12282,8 @@  R:	WANG Xuerui <kernel@xen0n.name>
 L:	loongarch@lists.linux.dev
 S:	Maintained
 T:	git git://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson.git
-F:	Documentation/loongarch/
-F:	Documentation/translations/zh_CN/loongarch/
+F:	Documentation/arch/loongarch/
+F:	Documentation/translations/zh_CN/arch/loongarch/
 F:	arch/loongarch/
 F:	drivers/*/*loongarch*
 
diff --git a/drivers/irqchip/Kconfig b/drivers/irqchip/Kconfig
index 4b9036c6d45b..f7149d0f3d45 100644
--- a/drivers/irqchip/Kconfig
+++ b/drivers/irqchip/Kconfig
@@ -567,7 +567,7 @@  config IRQ_LOONGARCH_CPU
 	help
 	  Support for the LoongArch CPU Interrupt Controller. For details of
 	  irq chip hierarchy on LoongArch platforms please read the document
-	  Documentation/loongarch/irq-chip-model.rst.
+	  Documentation/arch/loongarch/irq-chip-model.rst.
 
 config LOONGSON_LIOINTC
 	bool "Loongson Local I/O Interrupt Controller"