[PATCH] docs: move powerpc under arch

[PATCH] docs: move powerpc under arch

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

---

Changes in v2:
- added relocation of new file vmemmap_dedup.rst
---
 Documentation/ABI/testing/sysfs-bus-papr-pmem             | 2 +-
 Documentation/PCI/pci-error-recovery.rst                  | 4 ++--
 Documentation/arch/index.rst                              | 2 +-
 Documentation/{ => arch}/powerpc/associativity.rst        | 0
 Documentation/{ => arch}/powerpc/booting.rst              | 0
 Documentation/{ => arch}/powerpc/bootwrapper.rst          | 0
 Documentation/{ => arch}/powerpc/cpu_families.rst         | 0
 Documentation/{ => arch}/powerpc/cpu_features.rst         | 0
 Documentation/{ => arch}/powerpc/cxl.rst                  | 0
 Documentation/{ => arch}/powerpc/cxlflash.rst             | 2 +-
 Documentation/{ => arch}/powerpc/dawr-power9.rst          | 0
 Documentation/{ => arch}/powerpc/dexcr.rst                | 0
 Documentation/{ => arch}/powerpc/dscr.rst                 | 0
 .../{ => arch}/powerpc/eeh-pci-error-recovery.rst         | 0
 Documentation/{ => arch}/powerpc/elf_hwcaps.rst           | 6 +++---
 Documentation/{ => arch}/powerpc/elfnote.rst              | 0
 Documentation/{ => arch}/powerpc/features.rst             | 0
 .../{ => arch}/powerpc/firmware-assisted-dump.rst         | 0
 Documentation/{ => arch}/powerpc/hvcs.rst                 | 0
 Documentation/{ => arch}/powerpc/imc.rst                  | 0
 Documentation/{ => arch}/powerpc/index.rst                | 0
 Documentation/{ => arch}/powerpc/isa-versions.rst         | 0
 Documentation/{ => arch}/powerpc/kasan.txt                | 0
 Documentation/{ => arch}/powerpc/kaslr-booke32.rst        | 0
 Documentation/{ => arch}/powerpc/mpc52xx.rst              | 0
 Documentation/{ => arch}/powerpc/papr_hcalls.rst          | 0
 .../{ => arch}/powerpc/pci_iov_resource_on_powernv.rst    | 0
 Documentation/{ => arch}/powerpc/pmu-ebb.rst              | 0
 Documentation/{ => arch}/powerpc/ptrace.rst               | 0
 Documentation/{ => arch}/powerpc/qe_firmware.rst          | 0
 Documentation/{ => arch}/powerpc/syscall64-abi.rst        | 0
 Documentation/{ => arch}/powerpc/transactional_memory.rst | 0
 Documentation/{ => arch}/powerpc/ultravisor.rst           | 0
 Documentation/{ => arch}/powerpc/vas-api.rst              | 0
 Documentation/{ => arch}/powerpc/vcpudispatch_stats.rst   | 0
 Documentation/{ => arch}/powerpc/vmemmap_dedup.rst        | 0
 MAINTAINERS                                               | 8 ++++----
 arch/powerpc/kernel/exceptions-64s.S                      | 6 +++---
 arch/powerpc/kernel/paca.c                                | 2 +-
 arch/powerpc/kvm/book3s_64_entry.S                        | 2 +-
 drivers/soc/fsl/qe/qe.c                                   | 2 +-
 drivers/tty/hvc/hvcs.c                                    | 2 +-
 include/soc/fsl/qe/qe.h                                   | 2 +-
 43 files changed, 20 insertions(+), 20 deletions(-)
 rename Documentation/{ => arch}/powerpc/associativity.rst (100%)
 rename Documentation/{ => arch}/powerpc/booting.rst (100%)
 rename Documentation/{ => arch}/powerpc/bootwrapper.rst (100%)
 rename Documentation/{ => arch}/powerpc/cpu_families.rst (100%)
 rename Documentation/{ => arch}/powerpc/cpu_features.rst (100%)
 rename Documentation/{ => arch}/powerpc/cxl.rst (100%)
 rename Documentation/{ => arch}/powerpc/cxlflash.rst (99%)
 rename Documentation/{ => arch}/powerpc/dawr-power9.rst (100%)
 rename Documentation/{ => arch}/powerpc/dexcr.rst (100%)
 rename Documentation/{ => arch}/powerpc/dscr.rst (100%)
 rename Documentation/{ => arch}/powerpc/eeh-pci-error-recovery.rst (100%)
 rename Documentation/{ => arch}/powerpc/elf_hwcaps.rst (97%)
 rename Documentation/{ => arch}/powerpc/elfnote.rst (100%)
 rename Documentation/{ => arch}/powerpc/features.rst (100%)
 rename Documentation/{ => arch}/powerpc/firmware-assisted-dump.rst (100%)
 rename Documentation/{ => arch}/powerpc/hvcs.rst (100%)
 rename Documentation/{ => arch}/powerpc/imc.rst (100%)
 rename Documentation/{ => arch}/powerpc/index.rst (100%)
 rename Documentation/{ => arch}/powerpc/isa-versions.rst (100%)
 rename Documentation/{ => arch}/powerpc/kasan.txt (100%)
 rename Documentation/{ => arch}/powerpc/kaslr-booke32.rst (100%)
 rename Documentation/{ => arch}/powerpc/mpc52xx.rst (100%)
 rename Documentation/{ => arch}/powerpc/papr_hcalls.rst (100%)
 rename Documentation/{ => arch}/powerpc/pci_iov_resource_on_powernv.rst (100%)
 rename Documentation/{ => arch}/powerpc/pmu-ebb.rst (100%)
 rename Documentation/{ => arch}/powerpc/ptrace.rst (100%)
 rename Documentation/{ => arch}/powerpc/qe_firmware.rst (100%)
 rename Documentation/{ => arch}/powerpc/syscall64-abi.rst (100%)
 rename Documentation/{ => arch}/powerpc/transactional_memory.rst (100%)
 rename Documentation/{ => arch}/powerpc/ultravisor.rst (100%)
 rename Documentation/{ => arch}/powerpc/vas-api.rst (100%)
 rename Documentation/{ => arch}/powerpc/vcpudispatch_stats.rst (100%)
 rename Documentation/{ => arch}/powerpc/vmemmap_dedup.rst (100%)

diff --git a/Documentation/ABI/testing/sysfs-bus-papr-pmem b/Documentation/ABI/testing/sysfs-bus-papr-pmem
index 46cfe02058fd..34ee8c59ab25 100644
--- a/Documentation/ABI/testing/sysfs-bus-papr-pmem
+++ b/Documentation/ABI/testing/sysfs-bus-papr-pmem
@@ -8,7 +8,7 @@ Description:
 		more bits set in the dimm-health-bitmap retrieved in
 		response to H_SCM_HEALTH hcall. The details of the bit
 		flags returned in response to this hcall is available
-		at 'Documentation/powerpc/papr_hcalls.rst' . Below are
+		at 'Documentation/arch/powerpc/papr_hcalls.rst' . Below are
 		the flags reported in this sysfs file:
 
 		* "not_armed"
diff --git a/Documentation/PCI/pci-error-recovery.rst b/Documentation/PCI/pci-error-recovery.rst
index 0c7552a00c8c..42e1e78353f3 100644
--- a/Documentation/PCI/pci-error-recovery.rst
+++ b/Documentation/PCI/pci-error-recovery.rst
@@ -364,7 +364,7 @@ Note, however, not all failures are truly "permanent". Some are
 caused by over-heating, some by a poorly seated card. Many
 PCI error events are caused by software bugs, e.g. DMAs to
 wild addresses or bogus split transactions due to programming
-errors. See the discussion in Documentation/powerpc/eeh-pci-error-recovery.rst
+errors. See the discussion in Documentation/arch/powerpc/eeh-pci-error-recovery.rst
 for additional detail on real-life experience of the causes of
 software errors.
 
@@ -404,7 +404,7 @@ That is, the recovery API only requires that:
 .. note::
 
    Implementation details for the powerpc platform are discussed in
-   the file Documentation/powerpc/eeh-pci-error-recovery.rst
+   the file Documentation/arch/powerpc/eeh-pci-error-recovery.rst
 
    As of this writing, there is a growing list of device drivers with
    patches implementing error recovery. Not all of these patches are in
diff --git a/Documentation/arch/index.rst b/Documentation/arch/index.rst
index 84b80255b851..1bf7a3f1c77b 100644
--- a/Documentation/arch/index.rst
+++ b/Documentation/arch/index.rst
@@ -19,7 +19,7 @@ implementation.
    nios2/index
    openrisc/index
    parisc/index
-   ../powerpc/index
+   powerpc/index
    ../riscv/index
    s390/index
    sh/index
diff --git a/Documentation/powerpc/associativity.rst b/Documentation/arch/powerpc/associativity.rst
similarity index 100%
rename from Documentation/powerpc/associativity.rst
rename to Documentation/arch/powerpc/associativity.rst
diff --git a/Documentation/powerpc/booting.rst b/Documentation/arch/powerpc/booting.rst
similarity index 100%
rename from Documentation/powerpc/booting.rst
rename to Documentation/arch/powerpc/booting.rst
diff --git a/Documentation/powerpc/bootwrapper.rst b/Documentation/arch/powerpc/bootwrapper.rst
similarity index 100%
rename from Documentation/powerpc/bootwrapper.rst
rename to Documentation/arch/powerpc/bootwrapper.rst
diff --git a/Documentation/powerpc/cpu_families.rst b/Documentation/arch/powerpc/cpu_families.rst
similarity index 100%
rename from Documentation/powerpc/cpu_families.rst
rename to Documentation/arch/powerpc/cpu_families.rst
diff --git a/Documentation/powerpc/cpu_features.rst b/Documentation/arch/powerpc/cpu_features.rst
similarity index 100%
rename from Documentation/powerpc/cpu_features.rst
rename to Documentation/arch/powerpc/cpu_features.rst
diff --git a/Documentation/powerpc/cxl.rst b/Documentation/arch/powerpc/cxl.rst
similarity index 100%
rename from Documentation/powerpc/cxl.rst
rename to Documentation/arch/powerpc/cxl.rst
diff --git a/Documentation/powerpc/cxlflash.rst b/Documentation/arch/powerpc/cxlflash.rst
similarity index 99%
rename from Documentation/powerpc/cxlflash.rst
rename to Documentation/arch/powerpc/cxlflash.rst
index cea67931b3b9..e8f488acfa41 100644
--- a/Documentation/powerpc/cxlflash.rst
+++ b/Documentation/arch/powerpc/cxlflash.rst
@@ -32,7 +32,7 @@ Introduction
     responsible for the initialization of the adapter, setting up the
     special path for user space access, and performing error recovery. It
     communicates directly the Flash Accelerator Functional Unit (AFU)
-    as described in Documentation/powerpc/cxl.rst.
+    as described in Documentation/arch/powerpc/cxl.rst.
 
     The cxlflash driver supports two, mutually exclusive, modes of
     operation at the device (LUN) level:
diff --git a/Documentation/powerpc/dawr-power9.rst b/Documentation/arch/powerpc/dawr-power9.rst
similarity index 100%
rename from Documentation/powerpc/dawr-power9.rst
rename to Documentation/arch/powerpc/dawr-power9.rst
diff --git a/Documentation/powerpc/dexcr.rst b/Documentation/arch/powerpc/dexcr.rst
similarity index 100%
rename from Documentation/powerpc/dexcr.rst
rename to Documentation/arch/powerpc/dexcr.rst
diff --git a/Documentation/powerpc/dscr.rst b/Documentation/arch/powerpc/dscr.rst
similarity index 100%
rename from Documentation/powerpc/dscr.rst
rename to Documentation/arch/powerpc/dscr.rst
diff --git a/Documentation/powerpc/eeh-pci-error-recovery.rst b/Documentation/arch/powerpc/eeh-pci-error-recovery.rst
similarity index 100%
rename from Documentation/powerpc/eeh-pci-error-recovery.rst
rename to Documentation/arch/powerpc/eeh-pci-error-recovery.rst
diff --git a/Documentation/powerpc/elf_hwcaps.rst b/Documentation/arch/powerpc/elf_hwcaps.rst
similarity index 97%
rename from Documentation/powerpc/elf_hwcaps.rst
rename to Documentation/arch/powerpc/elf_hwcaps.rst
index 3366e5b18e67..4c896cf077c2 100644
--- a/Documentation/powerpc/elf_hwcaps.rst
+++ b/Documentation/arch/powerpc/elf_hwcaps.rst
@@ -202,7 +202,7 @@ PPC_FEATURE2_VEC_CRYPTO
 
 PPC_FEATURE2_HTM_NOSC
     System calls fail if called in a transactional state, see
-    Documentation/powerpc/syscall64-abi.rst
+    Documentation/arch/powerpc/syscall64-abi.rst
 
 PPC_FEATURE2_ARCH_3_00
     The processor supports the v3.0B / v3.0C userlevel architecture. Processors
@@ -217,11 +217,11 @@ PPC_FEATURE2_DARN
 
 PPC_FEATURE2_SCV
     The scv 0 instruction may be used for system calls, see
-    Documentation/powerpc/syscall64-abi.rst.
+    Documentation/arch/powerpc/syscall64-abi.rst.
 
 PPC_FEATURE2_HTM_NO_SUSPEND
     A limited Transactional Memory facility that does not support suspend is
-    available, see Documentation/powerpc/transactional_memory.rst.
+    available, see Documentation/arch/powerpc/transactional_memory.rst.
 
 PPC_FEATURE2_ARCH_3_1
     The processor supports the v3.1 userlevel architecture. Processors
diff --git a/Documentation/powerpc/elfnote.rst b/Documentation/arch/powerpc/elfnote.rst
similarity index 100%
rename from Documentation/powerpc/elfnote.rst
rename to Documentation/arch/powerpc/elfnote.rst
diff --git a/Documentation/powerpc/features.rst b/Documentation/arch/powerpc/features.rst
similarity index 100%
rename from Documentation/powerpc/features.rst
rename to Documentation/arch/powerpc/features.rst
diff --git a/Documentation/powerpc/firmware-assisted-dump.rst b/Documentation/arch/powerpc/firmware-assisted-dump.rst
similarity index 100%
rename from Documentation/powerpc/firmware-assisted-dump.rst
rename to Documentation/arch/powerpc/firmware-assisted-dump.rst
diff --git a/Documentation/powerpc/hvcs.rst b/Documentation/arch/powerpc/hvcs.rst
similarity index 100%
rename from Documentation/powerpc/hvcs.rst
rename to Documentation/arch/powerpc/hvcs.rst
diff --git a/Documentation/powerpc/imc.rst b/Documentation/arch/powerpc/imc.rst
similarity index 100%
rename from Documentation/powerpc/imc.rst
rename to Documentation/arch/powerpc/imc.rst
diff --git a/Documentation/powerpc/index.rst b/Documentation/arch/powerpc/index.rst
similarity index 100%
rename from Documentation/powerpc/index.rst
rename to Documentation/arch/powerpc/index.rst
diff --git a/Documentation/powerpc/isa-versions.rst b/Documentation/arch/powerpc/isa-versions.rst
similarity index 100%
rename from Documentation/powerpc/isa-versions.rst
rename to Documentation/arch/powerpc/isa-versions.rst
diff --git a/Documentation/powerpc/kasan.txt b/Documentation/arch/powerpc/kasan.txt
similarity index 100%
rename from Documentation/powerpc/kasan.txt
rename to Documentation/arch/powerpc/kasan.txt
diff --git a/Documentation/powerpc/kaslr-booke32.rst b/Documentation/arch/powerpc/kaslr-booke32.rst
similarity index 100%
rename from Documentation/powerpc/kaslr-booke32.rst
rename to Documentation/arch/powerpc/kaslr-booke32.rst
diff --git a/Documentation/powerpc/mpc52xx.rst b/Documentation/arch/powerpc/mpc52xx.rst
similarity index 100%
rename from Documentation/powerpc/mpc52xx.rst
rename to Documentation/arch/powerpc/mpc52xx.rst
diff --git a/Documentation/powerpc/papr_hcalls.rst b/Documentation/arch/powerpc/papr_hcalls.rst
similarity index 100%
rename from Documentation/powerpc/papr_hcalls.rst
rename to Documentation/arch/powerpc/papr_hcalls.rst
diff --git a/Documentation/powerpc/pci_iov_resource_on_powernv.rst b/Documentation/arch/powerpc/pci_iov_resource_on_powernv.rst
similarity index 100%
rename from Documentation/powerpc/pci_iov_resource_on_powernv.rst
rename to Documentation/arch/powerpc/pci_iov_resource_on_powernv.rst
diff --git a/Documentation/powerpc/pmu-ebb.rst b/Documentation/arch/powerpc/pmu-ebb.rst
similarity index 100%
rename from Documentation/powerpc/pmu-ebb.rst
rename to Documentation/arch/powerpc/pmu-ebb.rst
diff --git a/Documentation/powerpc/ptrace.rst b/Documentation/arch/powerpc/ptrace.rst
similarity index 100%
rename from Documentation/powerpc/ptrace.rst
rename to Documentation/arch/powerpc/ptrace.rst
diff --git a/Documentation/powerpc/qe_firmware.rst b/Documentation/arch/powerpc/qe_firmware.rst
similarity index 100%
rename from Documentation/powerpc/qe_firmware.rst
rename to Documentation/arch/powerpc/qe_firmware.rst
diff --git a/Documentation/powerpc/syscall64-abi.rst b/Documentation/arch/powerpc/syscall64-abi.rst
similarity index 100%
rename from Documentation/powerpc/syscall64-abi.rst
rename to Documentation/arch/powerpc/syscall64-abi.rst
diff --git a/Documentation/powerpc/transactional_memory.rst b/Documentation/arch/powerpc/transactional_memory.rst
similarity index 100%
rename from Documentation/powerpc/transactional_memory.rst
rename to Documentation/arch/powerpc/transactional_memory.rst
diff --git a/Documentation/powerpc/ultravisor.rst b/Documentation/arch/powerpc/ultravisor.rst
similarity index 100%
rename from Documentation/powerpc/ultravisor.rst
rename to Documentation/arch/powerpc/ultravisor.rst
diff --git a/Documentation/powerpc/vas-api.rst b/Documentation/arch/powerpc/vas-api.rst
similarity index 100%
rename from Documentation/powerpc/vas-api.rst
rename to Documentation/arch/powerpc/vas-api.rst
diff --git a/Documentation/powerpc/vcpudispatch_stats.rst b/Documentation/arch/powerpc/vcpudispatch_stats.rst
similarity index 100%
rename from Documentation/powerpc/vcpudispatch_stats.rst
rename to Documentation/arch/powerpc/vcpudispatch_stats.rst
diff --git a/Documentation/powerpc/vmemmap_dedup.rst b/Documentation/arch/powerpc/vmemmap_dedup.rst
similarity index 100%
rename from Documentation/powerpc/vmemmap_dedup.rst
rename to Documentation/arch/powerpc/vmemmap_dedup.rst
diff --git a/MAINTAINERS b/MAINTAINERS
index 37b9626ee654..5c770ddd2c73 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -5597,7 +5597,7 @@ M:	Andrew Donnellan <ajd@linux.ibm.com>
 L:	linuxppc-dev@lists.ozlabs.org
 S:	Supported
 F:	Documentation/ABI/testing/sysfs-class-cxl
-F:	Documentation/powerpc/cxl.rst
+F:	Documentation/arch/powerpc/cxl.rst
 F:	arch/powerpc/platforms/powernv/pci-cxl.c
 F:	drivers/misc/cxl/
 F:	include/misc/cxl*
@@ -5609,7 +5609,7 @@ M:	Matthew R. Ochs <mrochs@linux.ibm.com>
 M:	Uma Krishnan <ukrishn@linux.ibm.com>
 L:	linux-scsi@vger.kernel.org
 S:	Supported
-F:	Documentation/powerpc/cxlflash.rst
+F:	Documentation/arch/powerpc/cxlflash.rst
 F:	drivers/scsi/cxlflash/
 F:	include/uapi/scsi/cxlflash_ioctl.h
 
@@ -12093,7 +12093,7 @@ F:	Documentation/ABI/stable/sysfs-firmware-opal-*
 F:	Documentation/devicetree/bindings/i2c/i2c-opal.txt
 F:	Documentation/devicetree/bindings/powerpc/
 F:	Documentation/devicetree/bindings/rtc/rtc-opal.txt
-F:	Documentation/powerpc/
+F:	Documentation/arch/powerpc/
 F:	arch/powerpc/
 F:	drivers/*/*/*pasemi*
 F:	drivers/*/*pasemi*
@@ -16487,7 +16487,7 @@ R:	Oliver O'Halloran <oohall@gmail.com>
 L:	linuxppc-dev@lists.ozlabs.org
 S:	Supported
 F:	Documentation/PCI/pci-error-recovery.rst
-F:	Documentation/powerpc/eeh-pci-error-recovery.rst
+F:	Documentation/arch/powerpc/eeh-pci-error-recovery.rst
 F:	arch/powerpc/include/*/eeh*.h
 F:	arch/powerpc/kernel/eeh*.c
 F:	arch/powerpc/platforms/*/eeh*.c
diff --git a/arch/powerpc/kernel/exceptions-64s.S b/arch/powerpc/kernel/exceptions-64s.S
index c33c8ebf8641..eaf2f167c342 100644
--- a/arch/powerpc/kernel/exceptions-64s.S
+++ b/arch/powerpc/kernel/exceptions-64s.S
@@ -893,7 +893,7 @@ __start_interrupts:
  *
  * Call convention:
  *
- * syscall register convention is in Documentation/powerpc/syscall64-abi.rst
+ * syscall register convention is in Documentation/arch/powerpc/syscall64-abi.rst
  */
 EXC_VIRT_BEGIN(system_call_vectored, 0x3000, 0x1000)
 	/* SCV 0 */
@@ -1952,8 +1952,8 @@ EXC_VIRT_NONE(0x4b00, 0x100)
  * Call convention:
  *
  * syscall and hypercalls register conventions are documented in
- * Documentation/powerpc/syscall64-abi.rst and
- * Documentation/powerpc/papr_hcalls.rst respectively.
+ * Documentation/arch/powerpc/syscall64-abi.rst and
+ * Documentation/arch/powerpc/papr_hcalls.rst respectively.
  *
  * The intersection of volatile registers that don't contain possible
  * inputs is: cr0, xer, ctr. We may use these as scratch regs upon entry
diff --git a/arch/powerpc/kernel/paca.c b/arch/powerpc/kernel/paca.c
index cda4e00b67c1..7502066c3c53 100644
--- a/arch/powerpc/kernel/paca.c
+++ b/arch/powerpc/kernel/paca.c
@@ -68,7 +68,7 @@ static void *__init alloc_shared_lppaca(unsigned long size, unsigned long limit,
 		memblock_set_bottom_up(true);
 
 		/*
-		 * See Documentation/powerpc/ultravisor.rst for more details.
+		 * See Documentation/arch/powerpc/ultravisor.rst for more details.
 		 *
 		 * UV/HV data sharing is in PAGE_SIZE granularity. In order to
 		 * minimize the number of pages shared, align the allocation to
diff --git a/arch/powerpc/kvm/book3s_64_entry.S b/arch/powerpc/kvm/book3s_64_entry.S
index 3b361af87313..a9ab92abffe8 100644
--- a/arch/powerpc/kvm/book3s_64_entry.S
+++ b/arch/powerpc/kvm/book3s_64_entry.S
@@ -19,7 +19,7 @@
 
 /*
  * This is a hcall, so register convention is as
- * Documentation/powerpc/papr_hcalls.rst.
+ * Documentation/arch/powerpc/papr_hcalls.rst.
  *
  * This may also be a syscall from PR-KVM userspace that is to be
  * reflected to the PR guest kernel, so registers may be set up for
diff --git a/drivers/soc/fsl/qe/qe.c b/drivers/soc/fsl/qe/qe.c
index 3ee0c7c1e9a4..70b6eddb867b 100644
--- a/drivers/soc/fsl/qe/qe.c
+++ b/drivers/soc/fsl/qe/qe.c
@@ -430,7 +430,7 @@ static void qe_upload_microcode(const void *base,
 /*
  * Upload a microcode to the I-RAM at a specific address.
  *
- * See Documentation/powerpc/qe_firmware.rst for information on QE microcode
+ * See Documentation/arch/powerpc/qe_firmware.rst for information on QE microcode
  * uploading.
  *
  * Currently, only version 1 is supported, so the 'version' field must be
diff --git a/drivers/tty/hvc/hvcs.c b/drivers/tty/hvc/hvcs.c
index d29fdfe9d93d..98433a53bae1 100644
--- a/drivers/tty/hvc/hvcs.c
+++ b/drivers/tty/hvc/hvcs.c
@@ -47,7 +47,7 @@
  * using the 2.6 Linux kernel kref construct.
  *
  * For direction on installation and usage of this driver please reference
- * Documentation/powerpc/hvcs.rst.
+ * Documentation/arch/powerpc/hvcs.rst.
  */
 
 #include <linux/device.h>
diff --git a/include/soc/fsl/qe/qe.h b/include/soc/fsl/qe/qe.h
index eb5079904cc8..af793f2a0ec4 100644
--- a/include/soc/fsl/qe/qe.h
+++ b/include/soc/fsl/qe/qe.h
@@ -258,7 +258,7 @@ static inline int qe_alive_during_sleep(void)
 
 /* Structure that defines QE firmware binary files.
  *
- * See Documentation/powerpc/qe_firmware.rst for a description of these
+ * See Documentation/arch/powerpc/qe_firmware.rst for a description of these
  * fields.
  */
 struct qe_firmware {
-- 
2.41.0

Re: [PATCH] docs: move powerpc under arch

[Jonathan Corbet]

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>

So this patch appears to have not been picked up, and to have received
no comments.  I'll happily carry it in docs-next, but it would be nice
to have an ack from the powerpc folks...?

Thanks,

jon

Re: [PATCH] docs: move powerpc under arch

[Linas Vepstas]

[-- Attachment #1: Type: text/plain, Size: 1068 bytes --]

Hi Jon,

Got the message; I'm not an active maintainer, haven't been for over a
decade, and cannot comment on style issues. But if all the other arches are
doing this, I see no reason why not. Feel free to interpret this as an
Acked-by: if that's appropriate.

-- linas

On Tue, Oct 3, 2023 at 11:05 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>
>
> So this patch appears to have not been picked up, and to have received
> no comments.  I'll happily carry it in docs-next, but it would be nice
> to have an ack from the powerpc folks...?
>
> Thanks,
>
> jon
>


-- 
Patrick: Are they laughing at us?
Sponge Bob: No, Patrick, they are laughing next to us.

[-- Attachment #2: Type: text/html, Size: 1761 bytes --]

Re: [PATCH] docs: move powerpc under arch

[Michael Ellerman]

On October 4, 2023 3:05:48 AM GMT+11:00, 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>
>
>So this patch appears to have not been picked up, and to have received
>no comments.  I'll happily carry it in docs-next, but it would be nice
>to have an ack from the powerpc folks...?

I acked it a few months back, and said I assumed you were merging it:

https://lore.kernel.org/linuxppc-dev/87bkfwem93.fsf@mail.lhotse/

I don't mind who merges it, I figured you merging it would generate fewer conflicts, but I'm happy to take it if you think that would be better.

Anyway here's another:

Acked-by: Michael Ellerman <mpe@ellerman.id.au> (powerpc)

cheers
-- 
Sent from my Android phone with K-9 Mail. Please excuse my brevity.

Re: [PATCH] docs: move powerpc under arch

[Christophe Leroy]

Le 04/10/2023 à 07:00, Michael Ellerman a écrit :
> 
> 
> On October 4, 2023 3:05:48 AM GMT+11:00, 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>
>>
>> So this patch appears to have not been picked up, and to have received
>> no comments.  I'll happily carry it in docs-next, but it would be nice
>> to have an ack from the powerpc folks...?
> 
> I acked it a few months back, and said I assumed you were merging it:
> 
> https://lore.kernel.org/linuxppc-dev/87bkfwem93.fsf@mail.lhotse/

See 
https://patchwork.ozlabs.org/project/linuxppc-dev/list/?series=&submitter=86378&state=*&q=&archive=&delegate=

Looks like a new version (with exact same title) was sent in August and 
that version didn't include the ack you sent in July on version 1.

> 
> I don't mind who merges it, I figured you merging it would generate fewer conflicts, but I'm happy to take it if you think that would be better.
> 
> Anyway here's another:
> 
> Acked-by: Michael Ellerman <mpe@ellerman.id.au> (powerpc)
> 

Re: [PATCH] docs: move powerpc under arch

[Jonathan Corbet]

Michael Ellerman <michael@ellerman.id.au> writes:

> On October 4, 2023 3:05:48 AM GMT+11:00, 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>
>>
>>So this patch appears to have not been picked up, and to have received
>>no comments.  I'll happily carry it in docs-next, but it would be nice
>>to have an ack from the powerpc folks...?
>
> I acked it a few months back, and said I assumed you were merging it:
>
> https://lore.kernel.org/linuxppc-dev/87bkfwem93.fsf@mail.lhotse/
>
> I don't mind who merges it, I figured you merging it would generate fewer conflicts, but I'm happy to take it if you think that would be better.
>
> Anyway here's another:
>
> Acked-by: Michael Ellerman <mpe@ellerman.id.au> (powerpc)

OK, sorry, somehow I missed that.  I'll apply it shortly.

Thanks,

jon

[PATCH] docs: move powerpc under arch

[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>
---
 Documentation/ABI/testing/sysfs-bus-papr-pmem             | 2 +-
 Documentation/PCI/pci-error-recovery.rst                  | 4 ++--
 Documentation/arch/index.rst                              | 2 +-
 Documentation/{ => arch}/powerpc/associativity.rst        | 0
 Documentation/{ => arch}/powerpc/booting.rst              | 0
 Documentation/{ => arch}/powerpc/bootwrapper.rst          | 0
 Documentation/{ => arch}/powerpc/cpu_families.rst         | 0
 Documentation/{ => arch}/powerpc/cpu_features.rst         | 0
 Documentation/{ => arch}/powerpc/cxl.rst                  | 0
 Documentation/{ => arch}/powerpc/cxlflash.rst             | 2 +-
 Documentation/{ => arch}/powerpc/dawr-power9.rst          | 0
 Documentation/{ => arch}/powerpc/dexcr.rst                | 0
 Documentation/{ => arch}/powerpc/dscr.rst                 | 0
 .../{ => arch}/powerpc/eeh-pci-error-recovery.rst         | 0
 Documentation/{ => arch}/powerpc/elf_hwcaps.rst           | 6 +++---
 Documentation/{ => arch}/powerpc/elfnote.rst              | 0
 Documentation/{ => arch}/powerpc/features.rst             | 0
 .../{ => arch}/powerpc/firmware-assisted-dump.rst         | 0
 Documentation/{ => arch}/powerpc/hvcs.rst                 | 0
 Documentation/{ => arch}/powerpc/imc.rst                  | 0
 Documentation/{ => arch}/powerpc/index.rst                | 0
 Documentation/{ => arch}/powerpc/isa-versions.rst         | 0
 Documentation/{ => arch}/powerpc/kasan.txt                | 0
 Documentation/{ => arch}/powerpc/kaslr-booke32.rst        | 0
 Documentation/{ => arch}/powerpc/mpc52xx.rst              | 0
 Documentation/{ => arch}/powerpc/papr_hcalls.rst          | 0
 .../{ => arch}/powerpc/pci_iov_resource_on_powernv.rst    | 0
 Documentation/{ => arch}/powerpc/pmu-ebb.rst              | 0
 Documentation/{ => arch}/powerpc/ptrace.rst               | 0
 Documentation/{ => arch}/powerpc/qe_firmware.rst          | 0
 Documentation/{ => arch}/powerpc/syscall64-abi.rst        | 0
 Documentation/{ => arch}/powerpc/transactional_memory.rst | 0
 Documentation/{ => arch}/powerpc/ultravisor.rst           | 0
 Documentation/{ => arch}/powerpc/vas-api.rst              | 0
 Documentation/{ => arch}/powerpc/vcpudispatch_stats.rst   | 0
 MAINTAINERS                                               | 8 ++++----
 arch/powerpc/kernel/exceptions-64s.S                      | 6 +++---
 arch/powerpc/kernel/paca.c                                | 2 +-
 arch/powerpc/kvm/book3s_64_entry.S                        | 2 +-
 drivers/soc/fsl/qe/qe.c                                   | 2 +-
 drivers/tty/hvc/hvcs.c                                    | 2 +-
 include/soc/fsl/qe/qe.h                                   | 2 +-
 42 files changed, 20 insertions(+), 20 deletions(-)
 rename Documentation/{ => arch}/powerpc/associativity.rst (100%)
 rename Documentation/{ => arch}/powerpc/booting.rst (100%)
 rename Documentation/{ => arch}/powerpc/bootwrapper.rst (100%)
 rename Documentation/{ => arch}/powerpc/cpu_families.rst (100%)
 rename Documentation/{ => arch}/powerpc/cpu_features.rst (100%)
 rename Documentation/{ => arch}/powerpc/cxl.rst (100%)
 rename Documentation/{ => arch}/powerpc/cxlflash.rst (99%)
 rename Documentation/{ => arch}/powerpc/dawr-power9.rst (100%)
 rename Documentation/{ => arch}/powerpc/dexcr.rst (100%)
 rename Documentation/{ => arch}/powerpc/dscr.rst (100%)
 rename Documentation/{ => arch}/powerpc/eeh-pci-error-recovery.rst (100%)
 rename Documentation/{ => arch}/powerpc/elf_hwcaps.rst (97%)
 rename Documentation/{ => arch}/powerpc/elfnote.rst (100%)
 rename Documentation/{ => arch}/powerpc/features.rst (100%)
 rename Documentation/{ => arch}/powerpc/firmware-assisted-dump.rst (100%)
 rename Documentation/{ => arch}/powerpc/hvcs.rst (100%)
 rename Documentation/{ => arch}/powerpc/imc.rst (100%)
 rename Documentation/{ => arch}/powerpc/index.rst (100%)
 rename Documentation/{ => arch}/powerpc/isa-versions.rst (100%)
 rename Documentation/{ => arch}/powerpc/kasan.txt (100%)
 rename Documentation/{ => arch}/powerpc/kaslr-booke32.rst (100%)
 rename Documentation/{ => arch}/powerpc/mpc52xx.rst (100%)
 rename Documentation/{ => arch}/powerpc/papr_hcalls.rst (100%)
 rename Documentation/{ => arch}/powerpc/pci_iov_resource_on_powernv.rst (100%)
 rename Documentation/{ => arch}/powerpc/pmu-ebb.rst (100%)
 rename Documentation/{ => arch}/powerpc/ptrace.rst (100%)
 rename Documentation/{ => arch}/powerpc/qe_firmware.rst (100%)
 rename Documentation/{ => arch}/powerpc/syscall64-abi.rst (100%)
 rename Documentation/{ => arch}/powerpc/transactional_memory.rst (100%)
 rename Documentation/{ => arch}/powerpc/ultravisor.rst (100%)
 rename Documentation/{ => arch}/powerpc/vas-api.rst (100%)
 rename Documentation/{ => arch}/powerpc/vcpudispatch_stats.rst (100%)

diff --git a/Documentation/ABI/testing/sysfs-bus-papr-pmem b/Documentation/ABI/testing/sysfs-bus-papr-pmem
index 4ac0673901e7..20347eb81530 100644
--- a/Documentation/ABI/testing/sysfs-bus-papr-pmem
+++ b/Documentation/ABI/testing/sysfs-bus-papr-pmem
@@ -8,7 +8,7 @@ Description:
 		more bits set in the dimm-health-bitmap retrieved in
 		response to H_SCM_HEALTH hcall. The details of the bit
 		flags returned in response to this hcall is available
-		at 'Documentation/powerpc/papr_hcalls.rst' . Below are
+		at 'Documentation/arch/powerpc/papr_hcalls.rst' . Below are
 		the flags reported in this sysfs file:
 
 		* "not_armed"
diff --git a/Documentation/PCI/pci-error-recovery.rst b/Documentation/PCI/pci-error-recovery.rst
index c237596f67e3..a394726510bd 100644
--- a/Documentation/PCI/pci-error-recovery.rst
+++ b/Documentation/PCI/pci-error-recovery.rst
@@ -364,7 +364,7 @@ Note, however, not all failures are truly "permanent". Some are
 caused by over-heating, some by a poorly seated card. Many
 PCI error events are caused by software bugs, e.g. DMA's to
 wild addresses or bogus split transactions due to programming
-errors. See the discussion in Documentation/powerpc/eeh-pci-error-recovery.rst
+errors. See the discussion in Documentation/arch/powerpc/eeh-pci-error-recovery.rst
 for additional detail on real-life experience of the causes of
 software errors.
 
@@ -404,7 +404,7 @@ That is, the recovery API only requires that:
 .. note::
 
    Implementation details for the powerpc platform are discussed in
-   the file Documentation/powerpc/eeh-pci-error-recovery.rst
+   the file Documentation/arch/powerpc/eeh-pci-error-recovery.rst
 
    As of this writing, there is a growing list of device drivers with
    patches implementing error recovery. Not all of these patches are in
diff --git a/Documentation/arch/index.rst b/Documentation/arch/index.rst
index 84b80255b851..1bf7a3f1c77b 100644
--- a/Documentation/arch/index.rst
+++ b/Documentation/arch/index.rst
@@ -19,7 +19,7 @@ implementation.
    nios2/index
    openrisc/index
    parisc/index
-   ../powerpc/index
+   powerpc/index
    ../riscv/index
    s390/index
    sh/index
diff --git a/Documentation/powerpc/associativity.rst b/Documentation/arch/powerpc/associativity.rst
similarity index 100%
rename from Documentation/powerpc/associativity.rst
rename to Documentation/arch/powerpc/associativity.rst
diff --git a/Documentation/powerpc/booting.rst b/Documentation/arch/powerpc/booting.rst
similarity index 100%
rename from Documentation/powerpc/booting.rst
rename to Documentation/arch/powerpc/booting.rst
diff --git a/Documentation/powerpc/bootwrapper.rst b/Documentation/arch/powerpc/bootwrapper.rst
similarity index 100%
rename from Documentation/powerpc/bootwrapper.rst
rename to Documentation/arch/powerpc/bootwrapper.rst
diff --git a/Documentation/powerpc/cpu_families.rst b/Documentation/arch/powerpc/cpu_families.rst
similarity index 100%
rename from Documentation/powerpc/cpu_families.rst
rename to Documentation/arch/powerpc/cpu_families.rst
diff --git a/Documentation/powerpc/cpu_features.rst b/Documentation/arch/powerpc/cpu_features.rst
similarity index 100%
rename from Documentation/powerpc/cpu_features.rst
rename to Documentation/arch/powerpc/cpu_features.rst
diff --git a/Documentation/powerpc/cxl.rst b/Documentation/arch/powerpc/cxl.rst
similarity index 100%
rename from Documentation/powerpc/cxl.rst
rename to Documentation/arch/powerpc/cxl.rst
diff --git a/Documentation/powerpc/cxlflash.rst b/Documentation/arch/powerpc/cxlflash.rst
similarity index 99%
rename from Documentation/powerpc/cxlflash.rst
rename to Documentation/arch/powerpc/cxlflash.rst
index cea67931b3b9..e8f488acfa41 100644
--- a/Documentation/powerpc/cxlflash.rst
+++ b/Documentation/arch/powerpc/cxlflash.rst
@@ -32,7 +32,7 @@ Introduction
     responsible for the initialization of the adapter, setting up the
     special path for user space access, and performing error recovery. It
     communicates directly the Flash Accelerator Functional Unit (AFU)
-    as described in Documentation/powerpc/cxl.rst.
+    as described in Documentation/arch/powerpc/cxl.rst.
 
     The cxlflash driver supports two, mutually exclusive, modes of
     operation at the device (LUN) level:
diff --git a/Documentation/powerpc/dawr-power9.rst b/Documentation/arch/powerpc/dawr-power9.rst
similarity index 100%
rename from Documentation/powerpc/dawr-power9.rst
rename to Documentation/arch/powerpc/dawr-power9.rst
diff --git a/Documentation/powerpc/dexcr.rst b/Documentation/arch/powerpc/dexcr.rst
similarity index 100%
rename from Documentation/powerpc/dexcr.rst
rename to Documentation/arch/powerpc/dexcr.rst
diff --git a/Documentation/powerpc/dscr.rst b/Documentation/arch/powerpc/dscr.rst
similarity index 100%
rename from Documentation/powerpc/dscr.rst
rename to Documentation/arch/powerpc/dscr.rst
diff --git a/Documentation/powerpc/eeh-pci-error-recovery.rst b/Documentation/arch/powerpc/eeh-pci-error-recovery.rst
similarity index 100%
rename from Documentation/powerpc/eeh-pci-error-recovery.rst
rename to Documentation/arch/powerpc/eeh-pci-error-recovery.rst
diff --git a/Documentation/powerpc/elf_hwcaps.rst b/Documentation/arch/powerpc/elf_hwcaps.rst
similarity index 97%
rename from Documentation/powerpc/elf_hwcaps.rst
rename to Documentation/arch/powerpc/elf_hwcaps.rst
index 3366e5b18e67..4c896cf077c2 100644
--- a/Documentation/powerpc/elf_hwcaps.rst
+++ b/Documentation/arch/powerpc/elf_hwcaps.rst
@@ -202,7 +202,7 @@ PPC_FEATURE2_VEC_CRYPTO
 
 PPC_FEATURE2_HTM_NOSC
     System calls fail if called in a transactional state, see
-    Documentation/powerpc/syscall64-abi.rst
+    Documentation/arch/powerpc/syscall64-abi.rst
 
 PPC_FEATURE2_ARCH_3_00
     The processor supports the v3.0B / v3.0C userlevel architecture. Processors
@@ -217,11 +217,11 @@ PPC_FEATURE2_DARN
 
 PPC_FEATURE2_SCV
     The scv 0 instruction may be used for system calls, see
-    Documentation/powerpc/syscall64-abi.rst.
+    Documentation/arch/powerpc/syscall64-abi.rst.
 
 PPC_FEATURE2_HTM_NO_SUSPEND
     A limited Transactional Memory facility that does not support suspend is
-    available, see Documentation/powerpc/transactional_memory.rst.
+    available, see Documentation/arch/powerpc/transactional_memory.rst.
 
 PPC_FEATURE2_ARCH_3_1
     The processor supports the v3.1 userlevel architecture. Processors
diff --git a/Documentation/powerpc/elfnote.rst b/Documentation/arch/powerpc/elfnote.rst
similarity index 100%
rename from Documentation/powerpc/elfnote.rst
rename to Documentation/arch/powerpc/elfnote.rst
diff --git a/Documentation/powerpc/features.rst b/Documentation/arch/powerpc/features.rst
similarity index 100%
rename from Documentation/powerpc/features.rst
rename to Documentation/arch/powerpc/features.rst
diff --git a/Documentation/powerpc/firmware-assisted-dump.rst b/Documentation/arch/powerpc/firmware-assisted-dump.rst
similarity index 100%
rename from Documentation/powerpc/firmware-assisted-dump.rst
rename to Documentation/arch/powerpc/firmware-assisted-dump.rst
diff --git a/Documentation/powerpc/hvcs.rst b/Documentation/arch/powerpc/hvcs.rst
similarity index 100%
rename from Documentation/powerpc/hvcs.rst
rename to Documentation/arch/powerpc/hvcs.rst
diff --git a/Documentation/powerpc/imc.rst b/Documentation/arch/powerpc/imc.rst
similarity index 100%
rename from Documentation/powerpc/imc.rst
rename to Documentation/arch/powerpc/imc.rst
diff --git a/Documentation/powerpc/index.rst b/Documentation/arch/powerpc/index.rst
similarity index 100%
rename from Documentation/powerpc/index.rst
rename to Documentation/arch/powerpc/index.rst
diff --git a/Documentation/powerpc/isa-versions.rst b/Documentation/arch/powerpc/isa-versions.rst
similarity index 100%
rename from Documentation/powerpc/isa-versions.rst
rename to Documentation/arch/powerpc/isa-versions.rst
diff --git a/Documentation/powerpc/kasan.txt b/Documentation/arch/powerpc/kasan.txt
similarity index 100%
rename from Documentation/powerpc/kasan.txt
rename to Documentation/arch/powerpc/kasan.txt
diff --git a/Documentation/powerpc/kaslr-booke32.rst b/Documentation/arch/powerpc/kaslr-booke32.rst
similarity index 100%
rename from Documentation/powerpc/kaslr-booke32.rst
rename to Documentation/arch/powerpc/kaslr-booke32.rst
diff --git a/Documentation/powerpc/mpc52xx.rst b/Documentation/arch/powerpc/mpc52xx.rst
similarity index 100%
rename from Documentation/powerpc/mpc52xx.rst
rename to Documentation/arch/powerpc/mpc52xx.rst
diff --git a/Documentation/powerpc/papr_hcalls.rst b/Documentation/arch/powerpc/papr_hcalls.rst
similarity index 100%
rename from Documentation/powerpc/papr_hcalls.rst
rename to Documentation/arch/powerpc/papr_hcalls.rst
diff --git a/Documentation/powerpc/pci_iov_resource_on_powernv.rst b/Documentation/arch/powerpc/pci_iov_resource_on_powernv.rst
similarity index 100%
rename from Documentation/powerpc/pci_iov_resource_on_powernv.rst
rename to Documentation/arch/powerpc/pci_iov_resource_on_powernv.rst
diff --git a/Documentation/powerpc/pmu-ebb.rst b/Documentation/arch/powerpc/pmu-ebb.rst
similarity index 100%
rename from Documentation/powerpc/pmu-ebb.rst
rename to Documentation/arch/powerpc/pmu-ebb.rst
diff --git a/Documentation/powerpc/ptrace.rst b/Documentation/arch/powerpc/ptrace.rst
similarity index 100%
rename from Documentation/powerpc/ptrace.rst
rename to Documentation/arch/powerpc/ptrace.rst
diff --git a/Documentation/powerpc/qe_firmware.rst b/Documentation/arch/powerpc/qe_firmware.rst
similarity index 100%
rename from Documentation/powerpc/qe_firmware.rst
rename to Documentation/arch/powerpc/qe_firmware.rst
diff --git a/Documentation/powerpc/syscall64-abi.rst b/Documentation/arch/powerpc/syscall64-abi.rst
similarity index 100%
rename from Documentation/powerpc/syscall64-abi.rst
rename to Documentation/arch/powerpc/syscall64-abi.rst
diff --git a/Documentation/powerpc/transactional_memory.rst b/Documentation/arch/powerpc/transactional_memory.rst
similarity index 100%
rename from Documentation/powerpc/transactional_memory.rst
rename to Documentation/arch/powerpc/transactional_memory.rst
diff --git a/Documentation/powerpc/ultravisor.rst b/Documentation/arch/powerpc/ultravisor.rst
similarity index 100%
rename from Documentation/powerpc/ultravisor.rst
rename to Documentation/arch/powerpc/ultravisor.rst
diff --git a/Documentation/powerpc/vas-api.rst b/Documentation/arch/powerpc/vas-api.rst
similarity index 100%
rename from Documentation/powerpc/vas-api.rst
rename to Documentation/arch/powerpc/vas-api.rst
diff --git a/Documentation/powerpc/vcpudispatch_stats.rst b/Documentation/arch/powerpc/vcpudispatch_stats.rst
similarity index 100%
rename from Documentation/powerpc/vcpudispatch_stats.rst
rename to Documentation/arch/powerpc/vcpudispatch_stats.rst
diff --git a/MAINTAINERS b/MAINTAINERS
index d1d8a9745761..b444619c26c2 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -5601,7 +5601,7 @@ M:	Andrew Donnellan <ajd@linux.ibm.com>
 L:	linuxppc-dev@lists.ozlabs.org
 S:	Supported
 F:	Documentation/ABI/testing/sysfs-class-cxl
-F:	Documentation/powerpc/cxl.rst
+F:	Documentation/arch/powerpc/cxl.rst
 F:	arch/powerpc/platforms/powernv/pci-cxl.c
 F:	drivers/misc/cxl/
 F:	include/misc/cxl*
@@ -5613,7 +5613,7 @@ M:	Matthew R. Ochs <mrochs@linux.ibm.com>
 M:	Uma Krishnan <ukrishn@linux.ibm.com>
 L:	linux-scsi@vger.kernel.org
 S:	Supported
-F:	Documentation/powerpc/cxlflash.rst
+F:	Documentation/arch/powerpc/cxlflash.rst
 F:	drivers/scsi/cxlflash/
 F:	include/uapi/scsi/cxlflash_ioctl.h
 
@@ -12044,7 +12044,7 @@ F:	Documentation/ABI/stable/sysfs-firmware-opal-*
 F:	Documentation/devicetree/bindings/i2c/i2c-opal.txt
 F:	Documentation/devicetree/bindings/powerpc/
 F:	Documentation/devicetree/bindings/rtc/rtc-opal.txt
-F:	Documentation/powerpc/
+F:	Documentation/arch/powerpc/
 F:	arch/powerpc/
 F:	drivers/*/*/*pasemi*
 F:	drivers/*/*pasemi*
@@ -16392,7 +16392,7 @@ R:	Oliver O'Halloran <oohall@gmail.com>
 L:	linuxppc-dev@lists.ozlabs.org
 S:	Supported
 F:	Documentation/PCI/pci-error-recovery.rst
-F:	Documentation/powerpc/eeh-pci-error-recovery.rst
+F:	Documentation/arch/powerpc/eeh-pci-error-recovery.rst
 F:	arch/powerpc/include/*/eeh*.h
 F:	arch/powerpc/kernel/eeh*.c
 F:	arch/powerpc/platforms/*/eeh*.c
diff --git a/arch/powerpc/kernel/exceptions-64s.S b/arch/powerpc/kernel/exceptions-64s.S
index c33c8ebf8641..eaf2f167c342 100644
--- a/arch/powerpc/kernel/exceptions-64s.S
+++ b/arch/powerpc/kernel/exceptions-64s.S
@@ -893,7 +893,7 @@ __start_interrupts:
  *
  * Call convention:
  *
- * syscall register convention is in Documentation/powerpc/syscall64-abi.rst
+ * syscall register convention is in Documentation/arch/powerpc/syscall64-abi.rst
  */
 EXC_VIRT_BEGIN(system_call_vectored, 0x3000, 0x1000)
 	/* SCV 0 */
@@ -1952,8 +1952,8 @@ EXC_VIRT_NONE(0x4b00, 0x100)
  * Call convention:
  *
  * syscall and hypercalls register conventions are documented in
- * Documentation/powerpc/syscall64-abi.rst and
- * Documentation/powerpc/papr_hcalls.rst respectively.
+ * Documentation/arch/powerpc/syscall64-abi.rst and
+ * Documentation/arch/powerpc/papr_hcalls.rst respectively.
  *
  * The intersection of volatile registers that don't contain possible
  * inputs is: cr0, xer, ctr. We may use these as scratch regs upon entry
diff --git a/arch/powerpc/kernel/paca.c b/arch/powerpc/kernel/paca.c
index cda4e00b67c1..7502066c3c53 100644
--- a/arch/powerpc/kernel/paca.c
+++ b/arch/powerpc/kernel/paca.c
@@ -68,7 +68,7 @@ static void *__init alloc_shared_lppaca(unsigned long size, unsigned long limit,
 		memblock_set_bottom_up(true);
 
 		/*
-		 * See Documentation/powerpc/ultravisor.rst for more details.
+		 * See Documentation/arch/powerpc/ultravisor.rst for more details.
 		 *
 		 * UV/HV data sharing is in PAGE_SIZE granularity. In order to
 		 * minimize the number of pages shared, align the allocation to
diff --git a/arch/powerpc/kvm/book3s_64_entry.S b/arch/powerpc/kvm/book3s_64_entry.S
index 6c2b1d17cb63..0902636f87e5 100644
--- a/arch/powerpc/kvm/book3s_64_entry.S
+++ b/arch/powerpc/kvm/book3s_64_entry.S
@@ -19,7 +19,7 @@
 
 /*
  * This is a hcall, so register convention is as
- * Documentation/powerpc/papr_hcalls.rst.
+ * Documentation/arch/powerpc/papr_hcalls.rst.
  *
  * This may also be a syscall from PR-KVM userspace that is to be
  * reflected to the PR guest kernel, so registers may be set up for
diff --git a/drivers/soc/fsl/qe/qe.c b/drivers/soc/fsl/qe/qe.c
index 58746e570d14..e3580d152cf1 100644
--- a/drivers/soc/fsl/qe/qe.c
+++ b/drivers/soc/fsl/qe/qe.c
@@ -429,7 +429,7 @@ static void qe_upload_microcode(const void *base,
 /*
  * Upload a microcode to the I-RAM at a specific address.
  *
- * See Documentation/powerpc/qe_firmware.rst for information on QE microcode
+ * See Documentation/arch/powerpc/qe_firmware.rst for information on QE microcode
  * uploading.
  *
  * Currently, only version 1 is supported, so the 'version' field must be
diff --git a/drivers/tty/hvc/hvcs.c b/drivers/tty/hvc/hvcs.c
index 1de1a09bf82d..2459387d80b4 100644
--- a/drivers/tty/hvc/hvcs.c
+++ b/drivers/tty/hvc/hvcs.c
@@ -47,7 +47,7 @@
  * using the 2.6 Linux kernel kref construct.
  *
  * For direction on installation and usage of this driver please reference
- * Documentation/powerpc/hvcs.rst.
+ * Documentation/arch/powerpc/hvcs.rst.
  */
 
 #include <linux/device.h>
diff --git a/include/soc/fsl/qe/qe.h b/include/soc/fsl/qe/qe.h
index eb5079904cc8..af793f2a0ec4 100644
--- a/include/soc/fsl/qe/qe.h
+++ b/include/soc/fsl/qe/qe.h
@@ -258,7 +258,7 @@ static inline int qe_alive_during_sleep(void)
 
 /* Structure that defines QE firmware binary files.
  *
- * See Documentation/powerpc/qe_firmware.rst for a description of these
+ * See Documentation/arch/powerpc/qe_firmware.rst for a description of these
  * fields.
  */
 struct qe_firmware {
-- 
2.41.0

Re: [PATCH] docs: move powerpc under arch

[Michael Ellerman]

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>

Fine by me, I assume Jon will take this.

Acked-by: Michael Ellerman <mpe@ellerman.id.au> (powerpc)

cheers

> ---
>  Documentation/ABI/testing/sysfs-bus-papr-pmem             | 2 +-
>  Documentation/PCI/pci-error-recovery.rst                  | 4 ++--
>  Documentation/arch/index.rst                              | 2 +-
>  Documentation/{ => arch}/powerpc/associativity.rst        | 0
>  Documentation/{ => arch}/powerpc/booting.rst              | 0
>  Documentation/{ => arch}/powerpc/bootwrapper.rst          | 0
>  Documentation/{ => arch}/powerpc/cpu_families.rst         | 0
>  Documentation/{ => arch}/powerpc/cpu_features.rst         | 0
>  Documentation/{ => arch}/powerpc/cxl.rst                  | 0
>  Documentation/{ => arch}/powerpc/cxlflash.rst             | 2 +-
>  Documentation/{ => arch}/powerpc/dawr-power9.rst          | 0
>  Documentation/{ => arch}/powerpc/dexcr.rst                | 0
>  Documentation/{ => arch}/powerpc/dscr.rst                 | 0
>  .../{ => arch}/powerpc/eeh-pci-error-recovery.rst         | 0
>  Documentation/{ => arch}/powerpc/elf_hwcaps.rst           | 6 +++---
>  Documentation/{ => arch}/powerpc/elfnote.rst              | 0
>  Documentation/{ => arch}/powerpc/features.rst             | 0
>  .../{ => arch}/powerpc/firmware-assisted-dump.rst         | 0
>  Documentation/{ => arch}/powerpc/hvcs.rst                 | 0
>  Documentation/{ => arch}/powerpc/imc.rst                  | 0
>  Documentation/{ => arch}/powerpc/index.rst                | 0
>  Documentation/{ => arch}/powerpc/isa-versions.rst         | 0
>  Documentation/{ => arch}/powerpc/kasan.txt                | 0
>  Documentation/{ => arch}/powerpc/kaslr-booke32.rst        | 0
>  Documentation/{ => arch}/powerpc/mpc52xx.rst              | 0
>  Documentation/{ => arch}/powerpc/papr_hcalls.rst          | 0
>  .../{ => arch}/powerpc/pci_iov_resource_on_powernv.rst    | 0
>  Documentation/{ => arch}/powerpc/pmu-ebb.rst              | 0
>  Documentation/{ => arch}/powerpc/ptrace.rst               | 0
>  Documentation/{ => arch}/powerpc/qe_firmware.rst          | 0
>  Documentation/{ => arch}/powerpc/syscall64-abi.rst        | 0
>  Documentation/{ => arch}/powerpc/transactional_memory.rst | 0
>  Documentation/{ => arch}/powerpc/ultravisor.rst           | 0
>  Documentation/{ => arch}/powerpc/vas-api.rst              | 0
>  Documentation/{ => arch}/powerpc/vcpudispatch_stats.rst   | 0
>  MAINTAINERS                                               | 8 ++++----
>  arch/powerpc/kernel/exceptions-64s.S                      | 6 +++---
>  arch/powerpc/kernel/paca.c                                | 2 +-
>  arch/powerpc/kvm/book3s_64_entry.S                        | 2 +-
>  drivers/soc/fsl/qe/qe.c                                   | 2 +-
>  drivers/tty/hvc/hvcs.c                                    | 2 +-
>  include/soc/fsl/qe/qe.h                                   | 2 +-
>  42 files changed, 20 insertions(+), 20 deletions(-)
>  rename Documentation/{ => arch}/powerpc/associativity.rst (100%)
>  rename Documentation/{ => arch}/powerpc/booting.rst (100%)
>  rename Documentation/{ => arch}/powerpc/bootwrapper.rst (100%)
>  rename Documentation/{ => arch}/powerpc/cpu_families.rst (100%)
>  rename Documentation/{ => arch}/powerpc/cpu_features.rst (100%)
>  rename Documentation/{ => arch}/powerpc/cxl.rst (100%)
>  rename Documentation/{ => arch}/powerpc/cxlflash.rst (99%)
>  rename Documentation/{ => arch}/powerpc/dawr-power9.rst (100%)
>  rename Documentation/{ => arch}/powerpc/dexcr.rst (100%)
>  rename Documentation/{ => arch}/powerpc/dscr.rst (100%)
>  rename Documentation/{ => arch}/powerpc/eeh-pci-error-recovery.rst (100%)
>  rename Documentation/{ => arch}/powerpc/elf_hwcaps.rst (97%)
>  rename Documentation/{ => arch}/powerpc/elfnote.rst (100%)
>  rename Documentation/{ => arch}/powerpc/features.rst (100%)
>  rename Documentation/{ => arch}/powerpc/firmware-assisted-dump.rst (100%)
>  rename Documentation/{ => arch}/powerpc/hvcs.rst (100%)
>  rename Documentation/{ => arch}/powerpc/imc.rst (100%)
>  rename Documentation/{ => arch}/powerpc/index.rst (100%)
>  rename Documentation/{ => arch}/powerpc/isa-versions.rst (100%)
>  rename Documentation/{ => arch}/powerpc/kasan.txt (100%)
>  rename Documentation/{ => arch}/powerpc/kaslr-booke32.rst (100%)
>  rename Documentation/{ => arch}/powerpc/mpc52xx.rst (100%)
>  rename Documentation/{ => arch}/powerpc/papr_hcalls.rst (100%)
>  rename Documentation/{ => arch}/powerpc/pci_iov_resource_on_powernv.rst (100%)
>  rename Documentation/{ => arch}/powerpc/pmu-ebb.rst (100%)
>  rename Documentation/{ => arch}/powerpc/ptrace.rst (100%)
>  rename Documentation/{ => arch}/powerpc/qe_firmware.rst (100%)
>  rename Documentation/{ => arch}/powerpc/syscall64-abi.rst (100%)
>  rename Documentation/{ => arch}/powerpc/transactional_memory.rst (100%)
>  rename Documentation/{ => arch}/powerpc/ultravisor.rst (100%)
>  rename Documentation/{ => arch}/powerpc/vas-api.rst (100%)
>  rename Documentation/{ => arch}/powerpc/vcpudispatch_stats.rst (100%)
>
> diff --git a/Documentation/ABI/testing/sysfs-bus-papr-pmem b/Documentation/ABI/testing/sysfs-bus-papr-pmem
> index 4ac0673901e7..20347eb81530 100644
> --- a/Documentation/ABI/testing/sysfs-bus-papr-pmem
> +++ b/Documentation/ABI/testing/sysfs-bus-papr-pmem
> @@ -8,7 +8,7 @@ Description:
>  		more bits set in the dimm-health-bitmap retrieved in
>  		response to H_SCM_HEALTH hcall. The details of the bit
>  		flags returned in response to this hcall is available
> -		at 'Documentation/powerpc/papr_hcalls.rst' . Below are
> +		at 'Documentation/arch/powerpc/papr_hcalls.rst' . Below are
>  		the flags reported in this sysfs file:
>  
>  		* "not_armed"
> diff --git a/Documentation/PCI/pci-error-recovery.rst b/Documentation/PCI/pci-error-recovery.rst
> index c237596f67e3..a394726510bd 100644
> --- a/Documentation/PCI/pci-error-recovery.rst
> +++ b/Documentation/PCI/pci-error-recovery.rst
> @@ -364,7 +364,7 @@ Note, however, not all failures are truly "permanent". Some are
>  caused by over-heating, some by a poorly seated card. Many
>  PCI error events are caused by software bugs, e.g. DMA's to
>  wild addresses or bogus split transactions due to programming
> -errors. See the discussion in Documentation/powerpc/eeh-pci-error-recovery.rst
> +errors. See the discussion in Documentation/arch/powerpc/eeh-pci-error-recovery.rst
>  for additional detail on real-life experience of the causes of
>  software errors.
>  
> @@ -404,7 +404,7 @@ That is, the recovery API only requires that:
>  .. note::
>  
>     Implementation details for the powerpc platform are discussed in
> -   the file Documentation/powerpc/eeh-pci-error-recovery.rst
> +   the file Documentation/arch/powerpc/eeh-pci-error-recovery.rst
>  
>     As of this writing, there is a growing list of device drivers with
>     patches implementing error recovery. Not all of these patches are in
> diff --git a/Documentation/arch/index.rst b/Documentation/arch/index.rst
> index 84b80255b851..1bf7a3f1c77b 100644
> --- a/Documentation/arch/index.rst
> +++ b/Documentation/arch/index.rst
> @@ -19,7 +19,7 @@ implementation.
>     nios2/index
>     openrisc/index
>     parisc/index
> -   ../powerpc/index
> +   powerpc/index
>     ../riscv/index
>     s390/index
>     sh/index
> diff --git a/Documentation/powerpc/associativity.rst b/Documentation/arch/powerpc/associativity.rst
> similarity index 100%
> rename from Documentation/powerpc/associativity.rst
> rename to Documentation/arch/powerpc/associativity.rst
> diff --git a/Documentation/powerpc/booting.rst b/Documentation/arch/powerpc/booting.rst
> similarity index 100%
> rename from Documentation/powerpc/booting.rst
> rename to Documentation/arch/powerpc/booting.rst
> diff --git a/Documentation/powerpc/bootwrapper.rst b/Documentation/arch/powerpc/bootwrapper.rst
> similarity index 100%
> rename from Documentation/powerpc/bootwrapper.rst
> rename to Documentation/arch/powerpc/bootwrapper.rst
> diff --git a/Documentation/powerpc/cpu_families.rst b/Documentation/arch/powerpc/cpu_families.rst
> similarity index 100%
> rename from Documentation/powerpc/cpu_families.rst
> rename to Documentation/arch/powerpc/cpu_families.rst
> diff --git a/Documentation/powerpc/cpu_features.rst b/Documentation/arch/powerpc/cpu_features.rst
> similarity index 100%
> rename from Documentation/powerpc/cpu_features.rst
> rename to Documentation/arch/powerpc/cpu_features.rst
> diff --git a/Documentation/powerpc/cxl.rst b/Documentation/arch/powerpc/cxl.rst
> similarity index 100%
> rename from Documentation/powerpc/cxl.rst
> rename to Documentation/arch/powerpc/cxl.rst
> diff --git a/Documentation/powerpc/cxlflash.rst b/Documentation/arch/powerpc/cxlflash.rst
> similarity index 99%
> rename from Documentation/powerpc/cxlflash.rst
> rename to Documentation/arch/powerpc/cxlflash.rst
> index cea67931b3b9..e8f488acfa41 100644
> --- a/Documentation/powerpc/cxlflash.rst
> +++ b/Documentation/arch/powerpc/cxlflash.rst
> @@ -32,7 +32,7 @@ Introduction
>      responsible for the initialization of the adapter, setting up the
>      special path for user space access, and performing error recovery. It
>      communicates directly the Flash Accelerator Functional Unit (AFU)
> -    as described in Documentation/powerpc/cxl.rst.
> +    as described in Documentation/arch/powerpc/cxl.rst.
>  
>      The cxlflash driver supports two, mutually exclusive, modes of
>      operation at the device (LUN) level:
> diff --git a/Documentation/powerpc/dawr-power9.rst b/Documentation/arch/powerpc/dawr-power9.rst
> similarity index 100%
> rename from Documentation/powerpc/dawr-power9.rst
> rename to Documentation/arch/powerpc/dawr-power9.rst
> diff --git a/Documentation/powerpc/dexcr.rst b/Documentation/arch/powerpc/dexcr.rst
> similarity index 100%
> rename from Documentation/powerpc/dexcr.rst
> rename to Documentation/arch/powerpc/dexcr.rst
> diff --git a/Documentation/powerpc/dscr.rst b/Documentation/arch/powerpc/dscr.rst
> similarity index 100%
> rename from Documentation/powerpc/dscr.rst
> rename to Documentation/arch/powerpc/dscr.rst
> diff --git a/Documentation/powerpc/eeh-pci-error-recovery.rst b/Documentation/arch/powerpc/eeh-pci-error-recovery.rst
> similarity index 100%
> rename from Documentation/powerpc/eeh-pci-error-recovery.rst
> rename to Documentation/arch/powerpc/eeh-pci-error-recovery.rst
> diff --git a/Documentation/powerpc/elf_hwcaps.rst b/Documentation/arch/powerpc/elf_hwcaps.rst
> similarity index 97%
> rename from Documentation/powerpc/elf_hwcaps.rst
> rename to Documentation/arch/powerpc/elf_hwcaps.rst
> index 3366e5b18e67..4c896cf077c2 100644
> --- a/Documentation/powerpc/elf_hwcaps.rst
> +++ b/Documentation/arch/powerpc/elf_hwcaps.rst
> @@ -202,7 +202,7 @@ PPC_FEATURE2_VEC_CRYPTO
>  
>  PPC_FEATURE2_HTM_NOSC
>      System calls fail if called in a transactional state, see
> -    Documentation/powerpc/syscall64-abi.rst
> +    Documentation/arch/powerpc/syscall64-abi.rst
>  
>  PPC_FEATURE2_ARCH_3_00
>      The processor supports the v3.0B / v3.0C userlevel architecture. Processors
> @@ -217,11 +217,11 @@ PPC_FEATURE2_DARN
>  
>  PPC_FEATURE2_SCV
>      The scv 0 instruction may be used for system calls, see
> -    Documentation/powerpc/syscall64-abi.rst.
> +    Documentation/arch/powerpc/syscall64-abi.rst.
>  
>  PPC_FEATURE2_HTM_NO_SUSPEND
>      A limited Transactional Memory facility that does not support suspend is
> -    available, see Documentation/powerpc/transactional_memory.rst.
> +    available, see Documentation/arch/powerpc/transactional_memory.rst.
>  
>  PPC_FEATURE2_ARCH_3_1
>      The processor supports the v3.1 userlevel architecture. Processors
> diff --git a/Documentation/powerpc/elfnote.rst b/Documentation/arch/powerpc/elfnote.rst
> similarity index 100%
> rename from Documentation/powerpc/elfnote.rst
> rename to Documentation/arch/powerpc/elfnote.rst
> diff --git a/Documentation/powerpc/features.rst b/Documentation/arch/powerpc/features.rst
> similarity index 100%
> rename from Documentation/powerpc/features.rst
> rename to Documentation/arch/powerpc/features.rst
> diff --git a/Documentation/powerpc/firmware-assisted-dump.rst b/Documentation/arch/powerpc/firmware-assisted-dump.rst
> similarity index 100%
> rename from Documentation/powerpc/firmware-assisted-dump.rst
> rename to Documentation/arch/powerpc/firmware-assisted-dump.rst
> diff --git a/Documentation/powerpc/hvcs.rst b/Documentation/arch/powerpc/hvcs.rst
> similarity index 100%
> rename from Documentation/powerpc/hvcs.rst
> rename to Documentation/arch/powerpc/hvcs.rst
> diff --git a/Documentation/powerpc/imc.rst b/Documentation/arch/powerpc/imc.rst
> similarity index 100%
> rename from Documentation/powerpc/imc.rst
> rename to Documentation/arch/powerpc/imc.rst
> diff --git a/Documentation/powerpc/index.rst b/Documentation/arch/powerpc/index.rst
> similarity index 100%
> rename from Documentation/powerpc/index.rst
> rename to Documentation/arch/powerpc/index.rst
> diff --git a/Documentation/powerpc/isa-versions.rst b/Documentation/arch/powerpc/isa-versions.rst
> similarity index 100%
> rename from Documentation/powerpc/isa-versions.rst
> rename to Documentation/arch/powerpc/isa-versions.rst
> diff --git a/Documentation/powerpc/kasan.txt b/Documentation/arch/powerpc/kasan.txt
> similarity index 100%
> rename from Documentation/powerpc/kasan.txt
> rename to Documentation/arch/powerpc/kasan.txt
> diff --git a/Documentation/powerpc/kaslr-booke32.rst b/Documentation/arch/powerpc/kaslr-booke32.rst
> similarity index 100%
> rename from Documentation/powerpc/kaslr-booke32.rst
> rename to Documentation/arch/powerpc/kaslr-booke32.rst
> diff --git a/Documentation/powerpc/mpc52xx.rst b/Documentation/arch/powerpc/mpc52xx.rst
> similarity index 100%
> rename from Documentation/powerpc/mpc52xx.rst
> rename to Documentation/arch/powerpc/mpc52xx.rst
> diff --git a/Documentation/powerpc/papr_hcalls.rst b/Documentation/arch/powerpc/papr_hcalls.rst
> similarity index 100%
> rename from Documentation/powerpc/papr_hcalls.rst
> rename to Documentation/arch/powerpc/papr_hcalls.rst
> diff --git a/Documentation/powerpc/pci_iov_resource_on_powernv.rst b/Documentation/arch/powerpc/pci_iov_resource_on_powernv.rst
> similarity index 100%
> rename from Documentation/powerpc/pci_iov_resource_on_powernv.rst
> rename to Documentation/arch/powerpc/pci_iov_resource_on_powernv.rst
> diff --git a/Documentation/powerpc/pmu-ebb.rst b/Documentation/arch/powerpc/pmu-ebb.rst
> similarity index 100%
> rename from Documentation/powerpc/pmu-ebb.rst
> rename to Documentation/arch/powerpc/pmu-ebb.rst
> diff --git a/Documentation/powerpc/ptrace.rst b/Documentation/arch/powerpc/ptrace.rst
> similarity index 100%
> rename from Documentation/powerpc/ptrace.rst
> rename to Documentation/arch/powerpc/ptrace.rst
> diff --git a/Documentation/powerpc/qe_firmware.rst b/Documentation/arch/powerpc/qe_firmware.rst
> similarity index 100%
> rename from Documentation/powerpc/qe_firmware.rst
> rename to Documentation/arch/powerpc/qe_firmware.rst
> diff --git a/Documentation/powerpc/syscall64-abi.rst b/Documentation/arch/powerpc/syscall64-abi.rst
> similarity index 100%
> rename from Documentation/powerpc/syscall64-abi.rst
> rename to Documentation/arch/powerpc/syscall64-abi.rst
> diff --git a/Documentation/powerpc/transactional_memory.rst b/Documentation/arch/powerpc/transactional_memory.rst
> similarity index 100%
> rename from Documentation/powerpc/transactional_memory.rst
> rename to Documentation/arch/powerpc/transactional_memory.rst
> diff --git a/Documentation/powerpc/ultravisor.rst b/Documentation/arch/powerpc/ultravisor.rst
> similarity index 100%
> rename from Documentation/powerpc/ultravisor.rst
> rename to Documentation/arch/powerpc/ultravisor.rst
> diff --git a/Documentation/powerpc/vas-api.rst b/Documentation/arch/powerpc/vas-api.rst
> similarity index 100%
> rename from Documentation/powerpc/vas-api.rst
> rename to Documentation/arch/powerpc/vas-api.rst
> diff --git a/Documentation/powerpc/vcpudispatch_stats.rst b/Documentation/arch/powerpc/vcpudispatch_stats.rst
> similarity index 100%
> rename from Documentation/powerpc/vcpudispatch_stats.rst
> rename to Documentation/arch/powerpc/vcpudispatch_stats.rst
> diff --git a/MAINTAINERS b/MAINTAINERS
> index d1d8a9745761..b444619c26c2 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -5601,7 +5601,7 @@ M:	Andrew Donnellan <ajd@linux.ibm.com>
>  L:	linuxppc-dev@lists.ozlabs.org
>  S:	Supported
>  F:	Documentation/ABI/testing/sysfs-class-cxl
> -F:	Documentation/powerpc/cxl.rst
> +F:	Documentation/arch/powerpc/cxl.rst
>  F:	arch/powerpc/platforms/powernv/pci-cxl.c
>  F:	drivers/misc/cxl/
>  F:	include/misc/cxl*
> @@ -5613,7 +5613,7 @@ M:	Matthew R. Ochs <mrochs@linux.ibm.com>
>  M:	Uma Krishnan <ukrishn@linux.ibm.com>
>  L:	linux-scsi@vger.kernel.org
>  S:	Supported
> -F:	Documentation/powerpc/cxlflash.rst
> +F:	Documentation/arch/powerpc/cxlflash.rst
>  F:	drivers/scsi/cxlflash/
>  F:	include/uapi/scsi/cxlflash_ioctl.h
>  
> @@ -12044,7 +12044,7 @@ F:	Documentation/ABI/stable/sysfs-firmware-opal-*
>  F:	Documentation/devicetree/bindings/i2c/i2c-opal.txt
>  F:	Documentation/devicetree/bindings/powerpc/
>  F:	Documentation/devicetree/bindings/rtc/rtc-opal.txt
> -F:	Documentation/powerpc/
> +F:	Documentation/arch/powerpc/
>  F:	arch/powerpc/
>  F:	drivers/*/*/*pasemi*
>  F:	drivers/*/*pasemi*
> @@ -16392,7 +16392,7 @@ R:	Oliver O'Halloran <oohall@gmail.com>
>  L:	linuxppc-dev@lists.ozlabs.org
>  S:	Supported
>  F:	Documentation/PCI/pci-error-recovery.rst
> -F:	Documentation/powerpc/eeh-pci-error-recovery.rst
> +F:	Documentation/arch/powerpc/eeh-pci-error-recovery.rst
>  F:	arch/powerpc/include/*/eeh*.h
>  F:	arch/powerpc/kernel/eeh*.c
>  F:	arch/powerpc/platforms/*/eeh*.c
> diff --git a/arch/powerpc/kernel/exceptions-64s.S b/arch/powerpc/kernel/exceptions-64s.S
> index c33c8ebf8641..eaf2f167c342 100644
> --- a/arch/powerpc/kernel/exceptions-64s.S
> +++ b/arch/powerpc/kernel/exceptions-64s.S
> @@ -893,7 +893,7 @@ __start_interrupts:
>   *
>   * Call convention:
>   *
> - * syscall register convention is in Documentation/powerpc/syscall64-abi.rst
> + * syscall register convention is in Documentation/arch/powerpc/syscall64-abi.rst
>   */
>  EXC_VIRT_BEGIN(system_call_vectored, 0x3000, 0x1000)
>  	/* SCV 0 */
> @@ -1952,8 +1952,8 @@ EXC_VIRT_NONE(0x4b00, 0x100)
>   * Call convention:
>   *
>   * syscall and hypercalls register conventions are documented in
> - * Documentation/powerpc/syscall64-abi.rst and
> - * Documentation/powerpc/papr_hcalls.rst respectively.
> + * Documentation/arch/powerpc/syscall64-abi.rst and
> + * Documentation/arch/powerpc/papr_hcalls.rst respectively.
>   *
>   * The intersection of volatile registers that don't contain possible
>   * inputs is: cr0, xer, ctr. We may use these as scratch regs upon entry
> diff --git a/arch/powerpc/kernel/paca.c b/arch/powerpc/kernel/paca.c
> index cda4e00b67c1..7502066c3c53 100644
> --- a/arch/powerpc/kernel/paca.c
> +++ b/arch/powerpc/kernel/paca.c
> @@ -68,7 +68,7 @@ static void *__init alloc_shared_lppaca(unsigned long size, unsigned long limit,
>  		memblock_set_bottom_up(true);
>  
>  		/*
> -		 * See Documentation/powerpc/ultravisor.rst for more details.
> +		 * See Documentation/arch/powerpc/ultravisor.rst for more details.
>  		 *
>  		 * UV/HV data sharing is in PAGE_SIZE granularity. In order to
>  		 * minimize the number of pages shared, align the allocation to
> diff --git a/arch/powerpc/kvm/book3s_64_entry.S b/arch/powerpc/kvm/book3s_64_entry.S
> index 6c2b1d17cb63..0902636f87e5 100644
> --- a/arch/powerpc/kvm/book3s_64_entry.S
> +++ b/arch/powerpc/kvm/book3s_64_entry.S
> @@ -19,7 +19,7 @@
>  
>  /*
>   * This is a hcall, so register convention is as
> - * Documentation/powerpc/papr_hcalls.rst.
> + * Documentation/arch/powerpc/papr_hcalls.rst.
>   *
>   * This may also be a syscall from PR-KVM userspace that is to be
>   * reflected to the PR guest kernel, so registers may be set up for
> diff --git a/drivers/soc/fsl/qe/qe.c b/drivers/soc/fsl/qe/qe.c
> index 58746e570d14..e3580d152cf1 100644
> --- a/drivers/soc/fsl/qe/qe.c
> +++ b/drivers/soc/fsl/qe/qe.c
> @@ -429,7 +429,7 @@ static void qe_upload_microcode(const void *base,
>  /*
>   * Upload a microcode to the I-RAM at a specific address.
>   *
> - * See Documentation/powerpc/qe_firmware.rst for information on QE microcode
> + * See Documentation/arch/powerpc/qe_firmware.rst for information on QE microcode
>   * uploading.
>   *
>   * Currently, only version 1 is supported, so the 'version' field must be
> diff --git a/drivers/tty/hvc/hvcs.c b/drivers/tty/hvc/hvcs.c
> index 1de1a09bf82d..2459387d80b4 100644
> --- a/drivers/tty/hvc/hvcs.c
> +++ b/drivers/tty/hvc/hvcs.c
> @@ -47,7 +47,7 @@
>   * using the 2.6 Linux kernel kref construct.
>   *
>   * For direction on installation and usage of this driver please reference
> - * Documentation/powerpc/hvcs.rst.
> + * Documentation/arch/powerpc/hvcs.rst.
>   */
>  
>  #include <linux/device.h>
> diff --git a/include/soc/fsl/qe/qe.h b/include/soc/fsl/qe/qe.h
> index eb5079904cc8..af793f2a0ec4 100644
> --- a/include/soc/fsl/qe/qe.h
> +++ b/include/soc/fsl/qe/qe.h
> @@ -258,7 +258,7 @@ static inline int qe_alive_during_sleep(void)
>  
>  /* Structure that defines QE firmware binary files.
>   *
> - * See Documentation/powerpc/qe_firmware.rst for a description of these
> + * See Documentation/arch/powerpc/qe_firmware.rst for a description of these
>   * fields.
>   */
>  struct qe_firmware {
> -- 
> 2.41.0