Skip to contentSkip to conversation

docs: move loongarch under arch

PATCH Superseded Costa Shulyupin 5 participants 10 messages Jul 17, 2023 – Jul 31, 2023

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

PATCH 1/1 docs: move loongarch under arch

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.

---
 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 ++--
 12 files changed, 12 insertions(+), 12 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%)
Documentation/arch/index.rst +1 -1
index 8458b88e9b79..4b6b1beebad6 100644
@@ -13,7 +13,7 @@ implementation.
    arm/index
    arm64/index
    ia64/index
-   ../loongarch/index
+   loongarch/index
    m68k/index
    ../mips/index
    nios2/index
Documentation/arch/loongarch/booting.rst renamed from Documentation/loongarch/booting.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/booting.rst
rename to Documentation/arch/loongarch/booting.rst
Documentation/arch/loongarch/features.rst renamed from Documentation/loongarch/features.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/features.rst
rename to Documentation/arch/loongarch/features.rst
Documentation/arch/loongarch/index.rst renamed from Documentation/loongarch/index.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/index.rst
rename to Documentation/arch/loongarch/index.rst
Documentation/arch/loongarch/introduction.rst renamed from Documentation/loongarch/introduction.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/introduction.rst
rename to Documentation/arch/loongarch/introduction.rst
Documentation/arch/loongarch/irq-chip-model.rst renamed from Documentation/loongarch/irq-chip-model.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/irq-chip-model.rst
rename to Documentation/arch/loongarch/irq-chip-model.rst
Documentation/translations/zh_CN/arch/index.rst +1 -1
index 6fa0cb671009..d4c1c729dde2 100644
@@ -13,7 +13,7 @@
    ../riscv/index
    openrisc/index
    parisc/index
-   ../loongarch/index
+   loongarch/index
 
 TODOList:
 
Documentation/translations/zh_CN/arch/loongarch/booting.rst renamed from Documentation/translations/zh_CN/loongarch/booting.rst +2 -2
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
@@ -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
 
 :翻译:
 
Documentation/translations/zh_CN/arch/loongarch/features.rst renamed from Documentation/translations/zh_CN/loongarch/features.rst +2 -2
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
@@ -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 <[email protected]>
 
 .. kernel-feat:: $srctree/Documentation/features loongarch
Documentation/translations/zh_CN/arch/loongarch/index.rst renamed from Documentation/translations/zh_CN/loongarch/index.rst +2 -2
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
@@ -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 <[email protected]>
 
 =================
Documentation/translations/zh_CN/arch/loongarch/introduction.rst renamed from Documentation/translations/zh_CN/loongarch/introduction.rst +2 -2
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
@@ -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 <[email protected]>
 
 =============
Documentation/translations/zh_CN/arch/loongarch/irq-chip-model.rst renamed from Documentation/translations/zh_CN/loongarch/irq-chip-model.rst +2 -2
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
@@ -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 <[email protected]>
 
 ==================================
Signature · 1 line
2.41.0
reviewer Reviewed-by on v1 1/1
#1 lore raw
Quoted 7 lines · 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.

Thanks.

Quoted 46 lines
---
 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 ++--
 12 files changed, 12 insertions(+), 12 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%)
Documentation/arch/loongarch/booting.rst renamed from Documentation/loongarch/booting.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/booting.rst
rename to Documentation/arch/loongarch/booting.rst
Documentation/arch/loongarch/features.rst renamed from Documentation/loongarch/features.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/features.rst
rename to Documentation/arch/loongarch/features.rst
Documentation/arch/loongarch/index.rst renamed from Documentation/loongarch/index.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/index.rst
rename to Documentation/arch/loongarch/index.rst
Documentation/arch/loongarch/introduction.rst renamed from Documentation/loongarch/introduction.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/introduction.rst
rename to Documentation/arch/loongarch/introduction.rst
Documentation/arch/loongarch/irq-chip-model.rst renamed from Documentation/loongarch/irq-chip-model.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/irq-chip-model.rst
rename to Documentation/arch/loongarch/irq-chip-model.rst
Signature · 1 line
~Randy
maintainer
#2 lore raw
In reply to Costa Shulyupin
Quoted 23 lines · 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.

---
 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 ++--
 12 files changed, 12 insertions(+), 12 deletions(-)
 rename Documentation/{ => arch}/loongarch/booting.rst (100%)
 rename Documentation/{ => arch}/loongarch/features.rst (100%)
Quoted 8 lines
 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%)

A couple of things:

- I'm slowly working in this area...indeed, I have a loongarch move already done, I just haven't posted it yet. So please talk to me if you want to do more of these.

- If you do a move like this, you need to fix up the collateral damage. There are references to Documentation/loongarch in MAINTAINERS and drivers/irqchip/Kconfig that need to be fixed as well.

Thanks,

jon

#3 lore raw

PATCH v2 1/1 docs: move loongarch under arch

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.

---

Changes:
- 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%)
Documentation/arch/index.rst +1 -1
index 8458b88e9b79..4b6b1beebad6 100644
@@ -13,7 +13,7 @@ implementation.
    arm/index
    arm64/index
    ia64/index
-   ../loongarch/index
+   loongarch/index
    m68k/index
    ../mips/index
    nios2/index
Documentation/arch/loongarch/booting.rst renamed from Documentation/loongarch/booting.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/booting.rst
rename to Documentation/arch/loongarch/booting.rst
Documentation/arch/loongarch/features.rst renamed from Documentation/loongarch/features.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/features.rst
rename to Documentation/arch/loongarch/features.rst
Documentation/arch/loongarch/index.rst renamed from Documentation/loongarch/index.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/index.rst
rename to Documentation/arch/loongarch/index.rst
Documentation/arch/loongarch/introduction.rst renamed from Documentation/loongarch/introduction.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/introduction.rst
rename to Documentation/arch/loongarch/introduction.rst
Documentation/arch/loongarch/irq-chip-model.rst renamed from Documentation/loongarch/irq-chip-model.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/irq-chip-model.rst
rename to Documentation/arch/loongarch/irq-chip-model.rst
Documentation/translations/zh_CN/arch/index.rst +1 -1
index 6fa0cb671009..d4c1c729dde2 100644
@@ -13,7 +13,7 @@
    ../riscv/index
    openrisc/index
    parisc/index
-   ../loongarch/index
+   loongarch/index
 
 TODOList:
 
Documentation/translations/zh_CN/arch/loongarch/booting.rst renamed from Documentation/translations/zh_CN/loongarch/booting.rst +2 -2
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
@@ -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
 
 :翻译:
 
Documentation/translations/zh_CN/arch/loongarch/features.rst renamed from Documentation/translations/zh_CN/loongarch/features.rst +2 -2
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
@@ -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 <[email protected]>
 
 .. kernel-feat:: $srctree/Documentation/features loongarch
Documentation/translations/zh_CN/arch/loongarch/index.rst renamed from Documentation/translations/zh_CN/loongarch/index.rst +2 -2
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
@@ -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 <[email protected]>
 
 =================
Documentation/translations/zh_CN/arch/loongarch/introduction.rst renamed from Documentation/translations/zh_CN/loongarch/introduction.rst +2 -2
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
@@ -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 <[email protected]>
 
 =============
Documentation/translations/zh_CN/arch/loongarch/irq-chip-model.rst renamed from Documentation/translations/zh_CN/loongarch/irq-chip-model.rst +2 -2
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
@@ -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 <[email protected]>
 
 ==================================
MAINTAINERS +2 -2
index d0ccb621a660..b68512f1b65f 100644
@@ -12282,8 +12282,8 @@ R:	WANG Xuerui <[email protected]>
 L:	[email protected]
 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*
 
drivers/irqchip/Kconfig +1 -1
index 4b9036c6d45b..5e54032f07c6 100644
@@ -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/oongarch/irq-chip-model.rst.
 
 config LOONGSON_LIOINTC
 	bool "Loongson Local I/O Interrupt Controller"
Signature · 1 line
2.41.0
maintainer
#4 lore raw
Quoted 11 lines · 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.

---

Changes:
- added fix of MAINTAINERS and drivers/irqchip/Kconfig

Um ....

drivers/irqchip/Kconfig config IRQ_LOONGARCH_CPU · line 570

Quoted 10 lines
drivers/irqchip/Kconfig +1 -1
index 4b9036c6d45b..5e54032f07c6 100644
@@ -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/oongarch/irq-chip-model.rst.

Can you please try to be a bit more careful than that?

Thanks,

jon

#5 lore raw

PATCH v3 1/1 docs: move loongarch under arch

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.

---

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%)
Documentation/arch/index.rst +1 -1
index 8458b88e9b79..4b6b1beebad6 100644
@@ -13,7 +13,7 @@ implementation.
    arm/index
    arm64/index
    ia64/index
-   ../loongarch/index
+   loongarch/index
    m68k/index
    ../mips/index
    nios2/index
Documentation/arch/loongarch/booting.rst renamed from Documentation/loongarch/booting.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/booting.rst
rename to Documentation/arch/loongarch/booting.rst
Documentation/arch/loongarch/features.rst renamed from Documentation/loongarch/features.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/features.rst
rename to Documentation/arch/loongarch/features.rst
Documentation/arch/loongarch/index.rst renamed from Documentation/loongarch/index.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/index.rst
rename to Documentation/arch/loongarch/index.rst
Documentation/arch/loongarch/introduction.rst renamed from Documentation/loongarch/introduction.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/introduction.rst
rename to Documentation/arch/loongarch/introduction.rst
Documentation/arch/loongarch/irq-chip-model.rst renamed from Documentation/loongarch/irq-chip-model.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/irq-chip-model.rst
rename to Documentation/arch/loongarch/irq-chip-model.rst
Documentation/translations/zh_CN/arch/index.rst +1 -1
index 6fa0cb671009..d4c1c729dde2 100644
@@ -13,7 +13,7 @@
    ../riscv/index
    openrisc/index
    parisc/index
-   ../loongarch/index
+   loongarch/index
 
 TODOList:
 
Documentation/translations/zh_CN/arch/loongarch/booting.rst renamed from Documentation/translations/zh_CN/loongarch/booting.rst +2 -2
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
@@ -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
 
 :翻译:
 
Documentation/translations/zh_CN/arch/loongarch/features.rst renamed from Documentation/translations/zh_CN/loongarch/features.rst +2 -2
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
@@ -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 <[email protected]>
 
 .. kernel-feat:: $srctree/Documentation/features loongarch
Documentation/translations/zh_CN/arch/loongarch/index.rst renamed from Documentation/translations/zh_CN/loongarch/index.rst +2 -2
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
@@ -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 <[email protected]>
 
 =================
Documentation/translations/zh_CN/arch/loongarch/introduction.rst renamed from Documentation/translations/zh_CN/loongarch/introduction.rst +2 -2
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
@@ -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 <[email protected]>
 
 =============
Documentation/translations/zh_CN/arch/loongarch/irq-chip-model.rst renamed from Documentation/translations/zh_CN/loongarch/irq-chip-model.rst +2 -2
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
@@ -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 <[email protected]>
 
 ==================================
MAINTAINERS +2 -2
index d0ccb621a660..b68512f1b65f 100644
@@ -12282,8 +12282,8 @@ R:	WANG Xuerui <[email protected]>
 L:	[email protected]
 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*
 
drivers/irqchip/Kconfig +1 -1
index 4b9036c6d45b..f7149d0f3d45 100644
@@ -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"
Signature · 1 line
2.41.0
Reviewed-by on v3 1/1
#6 lore raw
Quoted 7 lines · 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.

Thanks,

Yanteng

Quoted 199 lines

---

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%)

Documentation/arch/index.rst +1 -1
index 8458b88e9b79..4b6b1beebad6 100644
@@ -13,7 +13,7 @@ implementation.
     arm/index
     arm64/index
     ia64/index
-   ../loongarch/index
+   loongarch/index
     m68k/index
     ../mips/index
     nios2/index
Documentation/arch/loongarch/booting.rst renamed from Documentation/loongarch/booting.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/booting.rst
rename to Documentation/arch/loongarch/booting.rst
Documentation/arch/loongarch/features.rst renamed from Documentation/loongarch/features.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/features.rst
rename to Documentation/arch/loongarch/features.rst
Documentation/arch/loongarch/index.rst renamed from Documentation/loongarch/index.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/index.rst
rename to Documentation/arch/loongarch/index.rst
Documentation/arch/loongarch/introduction.rst renamed from Documentation/loongarch/introduction.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/introduction.rst
rename to Documentation/arch/loongarch/introduction.rst
Documentation/arch/loongarch/irq-chip-model.rst renamed from Documentation/loongarch/irq-chip-model.rst +0 -0
similarity index 100%
rename from Documentation/loongarch/irq-chip-model.rst
rename to Documentation/arch/loongarch/irq-chip-model.rst
Documentation/translations/zh_CN/arch/index.rst +1 -1
index 6fa0cb671009..d4c1c729dde2 100644
@@ -13,7 +13,7 @@
     ../riscv/index
     openrisc/index
     parisc/index
-   ../loongarch/index
+   loongarch/index
 
  TODOList:
 
Documentation/translations/zh_CN/arch/loongarch/booting.rst renamed from Documentation/translations/zh_CN/loongarch/booting.rst +2 -2
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
@@ -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
 
  :翻译:
 
Documentation/translations/zh_CN/arch/loongarch/features.rst renamed from Documentation/translations/zh_CN/loongarch/features.rst +2 -2
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
@@ -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 <[email protected]>
 
  .. kernel-feat:: $srctree/Documentation/features loongarch
Documentation/translations/zh_CN/arch/loongarch/index.rst renamed from Documentation/translations/zh_CN/loongarch/index.rst +2 -2
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
@@ -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 <[email protected]>
 
  =================
Documentation/translations/zh_CN/arch/loongarch/introduction.rst renamed from Documentation/translations/zh_CN/loongarch/introduction.rst +2 -2
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
@@ -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 <[email protected]>
 
  =============
Documentation/translations/zh_CN/arch/loongarch/irq-chip-model.rst renamed from Documentation/translations/zh_CN/loongarch/irq-chip-model.rst +2 -2
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
@@ -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 <[email protected]>
 
  ==================================
MAINTAINERS +2 -2
index d0ccb621a660..b68512f1b65f 100644
@@ -12282,8 +12282,8 @@ R:	WANG Xuerui <[email protected]>
  L:	[email protected]
  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*
 
drivers/irqchip/Kconfig +1 -1
index 4b9036c6d45b..f7149d0f3d45 100644
@@ -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"
maintainer
#7 lore raw
In reply to Costa Shulyupin
Quoted 8 lines · 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.

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

maintainer Acked-by
#8 lore raw

Hi, Jonathan,

Quoted 9 lines · Jonathan Corbet
Quoted 6 lines · 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.

Quoted 6 lines
Quoted 2 lines

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.

Quoted 4 lines

Thanks,

jon

maintainer Applied
#9 lore raw
In reply to Costa Shulyupin
Quoted 10 lines · 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.

---

Quoted 7 lines

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