* [PATCH 00/22] Some documentation fixes @ 2019-05-29 23:23 Mauro Carvalho Chehab 2019-05-29 23:23 ` [PATCH 09/22] docs: mark orphan documents as such Mauro Carvalho Chehab 0 siblings, 1 reply; 5+ messages in thread From: Mauro Carvalho Chehab @ 2019-05-29 23:23 UTC (permalink / raw) To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel, Jonathan Corbet, xen-devel, linux-kselftest, linux-amlogic, linux-gpio, linux-pm, devel, keyrings, dri-devel, linux-integrity, linux-mtd, patches, devicetree, netdev, alsa-devel, devel, virtualization, linux-mm, linux-pci, linux-acpi, linuxppc-dev, linux-security-module, linux-i2c, kvm, bpf, x86 Fix several warnings and broken links. This series was generated against linux-next, but was rebased to be applied at docs-next. It should apply cleanly on either tree. There's a git tree with all of them applied on the top of docs/docs-next at: https://git.linuxtv.org/mchehab/experimental.git/log/?h=fix_doc_links_v2 Mauro Carvalho Chehab (21): ABI: sysfs-devices-system-cpu: point to the right docs isdn: mISDN: remove a bogus reference to a non-existing doc dt: fix broken references to nand.txt docs: zh_CN: get rid of basic_profiling.txt doc: it_IT: fix reference to magic-number.rst docs: mm: numaperf.rst: get rid of a build warning docs: bpf: get rid of two warnings docs: mark orphan documents as such docs: amd-memory-encryption.rst get rid of warnings gpu: amdgpu: fix broken amdgpu_dma_buf.c references gpu: i915.rst: Fix references to renamed files docs: zh_CN: avoid duplicate citation references docs: vm: hmm.rst: fix some warnings docs: it: license-rules.rst: get rid of warnings docs: gpio: driver.rst: fix a bad tag docs: soundwire: locking: fix tags for a code-block docs: security: trusted-encrypted.rst: fix code-block tag docs: security: core.rst: Fix several warnings docs: net: dpio-driver.rst: fix two codeblock warnings docs: net: sja1105.rst: fix table format docs: fix broken documentation links Otto Sabart (1): mfd: madera: Fix bad reference to pinctrl.txt file .../ABI/testing/sysfs-devices-system-cpu | 3 +- Documentation/accelerators/ocxl.rst | 2 + Documentation/acpi/dsd/leds.txt | 2 +- .../admin-guide/kernel-parameters.rst | 6 +- .../admin-guide/kernel-parameters.txt | 16 ++--- Documentation/admin-guide/mm/numaperf.rst | 5 +- Documentation/admin-guide/ras.rst | 2 +- Documentation/arm/stm32/overview.rst | 2 + .../arm/stm32/stm32f429-overview.rst | 2 + .../arm/stm32/stm32f746-overview.rst | 2 + .../arm/stm32/stm32f769-overview.rst | 2 + .../arm/stm32/stm32h743-overview.rst | 2 + .../arm/stm32/stm32mp157-overview.rst | 2 + Documentation/bpf/btf.rst | 2 + .../bindings/mtd/amlogic,meson-nand.txt | 2 +- .../devicetree/bindings/mtd/gpmc-nand.txt | 2 +- .../devicetree/bindings/mtd/marvell-nand.txt | 2 +- .../devicetree/bindings/mtd/tango-nand.txt | 2 +- .../devicetree/bindings/net/fsl-enetc.txt | 7 +- .../bindings/pci/amlogic,meson-pcie.txt | 2 +- .../regulator/qcom,rpmh-regulator.txt | 2 +- .../devicetree/booting-without-of.txt | 2 +- Documentation/driver-api/gpio/board.rst | 2 +- Documentation/driver-api/gpio/consumer.rst | 2 +- Documentation/driver-api/gpio/driver.rst | 2 +- .../driver-api/soundwire/locking.rst | 4 +- .../firmware-guide/acpi/enumeration.rst | 2 +- .../firmware-guide/acpi/method-tracing.rst | 2 +- Documentation/gpu/amdgpu.rst | 4 +- Documentation/gpu/i915.rst | 6 +- Documentation/gpu/msm-crash-dump.rst | 2 + Documentation/i2c/instantiating-devices | 2 +- Documentation/interconnect/interconnect.rst | 2 + Documentation/laptops/lg-laptop.rst | 2 + .../freescale/dpaa2/dpio-driver.rst | 4 +- Documentation/networking/dsa/sja1105.rst | 6 +- Documentation/powerpc/isa-versions.rst | 2 + Documentation/security/keys/core.rst | 16 +++-- .../security/keys/trusted-encrypted.rst | 4 +- Documentation/sysctl/kernel.txt | 4 +- .../translations/it_IT/process/howto.rst | 2 +- .../it_IT/process/license-rules.rst | 28 ++++---- .../it_IT/process/magic-number.rst | 2 +- .../it_IT/process/stable-kernel-rules.rst | 4 +- .../translations/zh_CN/basic_profiling.txt | 71 ------------------- .../translations/zh_CN/process/4.Coding.rst | 2 +- .../zh_CN/process/management-style.rst | 4 +- .../zh_CN/process/programming-language.rst | 28 ++++---- .../virtual/kvm/amd-memory-encryption.rst | 5 ++ Documentation/virtual/kvm/vcpu-requests.rst | 2 + Documentation/vm/hmm.rst | 9 ++- Documentation/x86/x86_64/5level-paging.rst | 2 +- Documentation/x86/x86_64/boot-options.rst | 4 +- .../x86/x86_64/fake-numa-for-cpusets.rst | 2 +- MAINTAINERS | 6 +- arch/arm/Kconfig | 2 +- arch/arm64/kernel/kexec_image.c | 2 +- arch/powerpc/Kconfig | 2 +- arch/x86/Kconfig | 16 ++--- arch/x86/Kconfig.debug | 2 +- arch/x86/boot/header.S | 2 +- arch/x86/entry/entry_64.S | 2 +- arch/x86/include/asm/bootparam_utils.h | 2 +- arch/x86/include/asm/page_64_types.h | 2 +- arch/x86/include/asm/pgtable_64_types.h | 2 +- arch/x86/kernel/cpu/microcode/amd.c | 2 +- arch/x86/kernel/kexec-bzimage64.c | 2 +- arch/x86/kernel/pci-dma.c | 2 +- arch/x86/mm/tlb.c | 2 +- arch/x86/platform/pvh/enlighten.c | 2 +- drivers/acpi/Kconfig | 10 +-- drivers/isdn/mISDN/dsp_core.c | 2 - drivers/net/ethernet/faraday/ftgmac100.c | 2 +- .../fieldbus/Documentation/fieldbus_dev.txt | 4 +- drivers/vhost/vhost.c | 2 +- include/acpi/acpi_drivers.h | 2 +- include/linux/fs_context.h | 2 +- include/linux/lsm_hooks.h | 2 +- include/linux/mfd/madera/pdata.h | 3 +- mm/Kconfig | 2 +- security/Kconfig | 2 +- tools/include/linux/err.h | 2 +- .../Documentation/stack-validation.txt | 4 +- tools/testing/selftests/x86/protection_keys.c | 2 +- 84 files changed, 183 insertions(+), 212 deletions(-) delete mode 100644 Documentation/translations/zh_CN/basic_profiling.txt -- 2.21.0 ^ permalink raw reply [flat|nested] 5+ messages in thread
* [PATCH 09/22] docs: mark orphan documents as such 2019-05-29 23:23 [PATCH 00/22] Some documentation fixes Mauro Carvalho Chehab @ 2019-05-29 23:23 ` Mauro Carvalho Chehab 2019-05-30 8:30 ` Paolo Bonzini 2019-06-03 7:32 ` Christophe Leroy 0 siblings, 2 replies; 5+ messages in thread From: Mauro Carvalho Chehab @ 2019-05-29 23:23 UTC (permalink / raw) To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel, Jonathan Corbet, Frederic Barrat, Andrew Donnellan, Maxime Coquelin, Alexandre Torgue, Maarten Lankhorst, Maxime Ripard, Sean Paul, David Airlie, Daniel Vetter, Georgi Djakov, Matan Ziv-Av, Benjamin Herrenschmidt, Paul Mackerras, Michael Ellerman, Paolo Bonzini, Radim Krčmář, linuxppc-dev, linux-stm32, linux-arm-kernel, dri-devel, linux-pm, platform-driver-x86, kvm Sphinx doesn't like orphan documents: Documentation/accelerators/ocxl.rst: WARNING: document isn't included in any toctree Documentation/arm/stm32/overview.rst: WARNING: document isn't included in any toctree Documentation/arm/stm32/stm32f429-overview.rst: WARNING: document isn't included in any toctree Documentation/arm/stm32/stm32f746-overview.rst: WARNING: document isn't included in any toctree Documentation/arm/stm32/stm32f769-overview.rst: WARNING: document isn't included in any toctree Documentation/arm/stm32/stm32h743-overview.rst: WARNING: document isn't included in any toctree Documentation/arm/stm32/stm32mp157-overview.rst: WARNING: document isn't included in any toctree Documentation/gpu/msm-crash-dump.rst: WARNING: document isn't included in any toctree Documentation/interconnect/interconnect.rst: WARNING: document isn't included in any toctree Documentation/laptops/lg-laptop.rst: WARNING: document isn't included in any toctree Documentation/powerpc/isa-versions.rst: WARNING: document isn't included in any toctree Documentation/virtual/kvm/amd-memory-encryption.rst: WARNING: document isn't included in any toctree Documentation/virtual/kvm/vcpu-requests.rst: WARNING: document isn't included in any toctree So, while they aren't on any toctree, add :orphan: to them, in order to silent this warning. Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> --- Documentation/accelerators/ocxl.rst | 2 ++ Documentation/arm/stm32/overview.rst | 2 ++ Documentation/arm/stm32/stm32f429-overview.rst | 2 ++ Documentation/arm/stm32/stm32f746-overview.rst | 2 ++ Documentation/arm/stm32/stm32f769-overview.rst | 2 ++ Documentation/arm/stm32/stm32h743-overview.rst | 2 ++ Documentation/arm/stm32/stm32mp157-overview.rst | 2 ++ Documentation/gpu/msm-crash-dump.rst | 2 ++ Documentation/interconnect/interconnect.rst | 2 ++ Documentation/laptops/lg-laptop.rst | 2 ++ Documentation/powerpc/isa-versions.rst | 2 ++ Documentation/virtual/kvm/amd-memory-encryption.rst | 2 ++ Documentation/virtual/kvm/vcpu-requests.rst | 2 ++ 13 files changed, 26 insertions(+) diff --git a/Documentation/accelerators/ocxl.rst b/Documentation/accelerators/ocxl.rst index 14cefc020e2d..b1cea19a90f5 100644 --- a/Documentation/accelerators/ocxl.rst +++ b/Documentation/accelerators/ocxl.rst @@ -1,3 +1,5 @@ +:orphan: + ======================================================== OpenCAPI (Open Coherent Accelerator Processor Interface) ======================================================== diff --git a/Documentation/arm/stm32/overview.rst b/Documentation/arm/stm32/overview.rst index 85cfc8410798..f7e734153860 100644 --- a/Documentation/arm/stm32/overview.rst +++ b/Documentation/arm/stm32/overview.rst @@ -1,3 +1,5 @@ +:orphan: + ======================== STM32 ARM Linux Overview ======================== diff --git a/Documentation/arm/stm32/stm32f429-overview.rst b/Documentation/arm/stm32/stm32f429-overview.rst index 18feda97f483..65bbb1c3b423 100644 --- a/Documentation/arm/stm32/stm32f429-overview.rst +++ b/Documentation/arm/stm32/stm32f429-overview.rst @@ -1,3 +1,5 @@ +:orphan: + STM32F429 Overview ================== diff --git a/Documentation/arm/stm32/stm32f746-overview.rst b/Documentation/arm/stm32/stm32f746-overview.rst index b5f4b6ce7656..42d593085015 100644 --- a/Documentation/arm/stm32/stm32f746-overview.rst +++ b/Documentation/arm/stm32/stm32f746-overview.rst @@ -1,3 +1,5 @@ +:orphan: + STM32F746 Overview ================== diff --git a/Documentation/arm/stm32/stm32f769-overview.rst b/Documentation/arm/stm32/stm32f769-overview.rst index 228656ced2fe..f6adac862b17 100644 --- a/Documentation/arm/stm32/stm32f769-overview.rst +++ b/Documentation/arm/stm32/stm32f769-overview.rst @@ -1,3 +1,5 @@ +:orphan: + STM32F769 Overview ================== diff --git a/Documentation/arm/stm32/stm32h743-overview.rst b/Documentation/arm/stm32/stm32h743-overview.rst index 3458dc00095d..c525835e7473 100644 --- a/Documentation/arm/stm32/stm32h743-overview.rst +++ b/Documentation/arm/stm32/stm32h743-overview.rst @@ -1,3 +1,5 @@ +:orphan: + STM32H743 Overview ================== diff --git a/Documentation/arm/stm32/stm32mp157-overview.rst b/Documentation/arm/stm32/stm32mp157-overview.rst index 62e176d47ca7..2c52cd020601 100644 --- a/Documentation/arm/stm32/stm32mp157-overview.rst +++ b/Documentation/arm/stm32/stm32mp157-overview.rst @@ -1,3 +1,5 @@ +:orphan: + STM32MP157 Overview =================== diff --git a/Documentation/gpu/msm-crash-dump.rst b/Documentation/gpu/msm-crash-dump.rst index 757cd257e0d8..240ef200f76c 100644 --- a/Documentation/gpu/msm-crash-dump.rst +++ b/Documentation/gpu/msm-crash-dump.rst @@ -1,3 +1,5 @@ +:orphan: + ===================== MSM Crash Dump Format ===================== diff --git a/Documentation/interconnect/interconnect.rst b/Documentation/interconnect/interconnect.rst index c3e004893796..56e331dab70e 100644 --- a/Documentation/interconnect/interconnect.rst +++ b/Documentation/interconnect/interconnect.rst @@ -1,5 +1,7 @@ .. SPDX-License-Identifier: GPL-2.0 +:orphan: + ===================================== GENERIC SYSTEM INTERCONNECT SUBSYSTEM ===================================== diff --git a/Documentation/laptops/lg-laptop.rst b/Documentation/laptops/lg-laptop.rst index aa503ee9b3bc..f2c2ffe31101 100644 --- a/Documentation/laptops/lg-laptop.rst +++ b/Documentation/laptops/lg-laptop.rst @@ -1,5 +1,7 @@ .. SPDX-License-Identifier: GPL-2.0+ +:orphan: + LG Gram laptop extra features ============================= diff --git a/Documentation/powerpc/isa-versions.rst b/Documentation/powerpc/isa-versions.rst index 812e20cc898c..66c24140ebf1 100644 --- a/Documentation/powerpc/isa-versions.rst +++ b/Documentation/powerpc/isa-versions.rst @@ -1,3 +1,5 @@ +:orphan: + CPU to ISA Version Mapping ========================== diff --git a/Documentation/virtual/kvm/amd-memory-encryption.rst b/Documentation/virtual/kvm/amd-memory-encryption.rst index 659bbc093b52..33d697ab8a58 100644 --- a/Documentation/virtual/kvm/amd-memory-encryption.rst +++ b/Documentation/virtual/kvm/amd-memory-encryption.rst @@ -1,3 +1,5 @@ +:orphan: + ====================================== Secure Encrypted Virtualization (SEV) ====================================== diff --git a/Documentation/virtual/kvm/vcpu-requests.rst b/Documentation/virtual/kvm/vcpu-requests.rst index 5feb3706a7ae..c1807a1b92e6 100644 --- a/Documentation/virtual/kvm/vcpu-requests.rst +++ b/Documentation/virtual/kvm/vcpu-requests.rst @@ -1,3 +1,5 @@ +:orphan: + ================= KVM VCPU Requests ================= -- 2.21.0 ^ permalink raw reply related [flat|nested] 5+ messages in thread
* Re: [PATCH 09/22] docs: mark orphan documents as such 2019-05-29 23:23 ` [PATCH 09/22] docs: mark orphan documents as such Mauro Carvalho Chehab @ 2019-05-30 8:30 ` Paolo Bonzini 2019-06-03 7:32 ` Christophe Leroy 1 sibling, 0 replies; 5+ messages in thread From: Paolo Bonzini @ 2019-05-30 8:30 UTC (permalink / raw) To: Mauro Carvalho Chehab, Linux Doc Mailing List Cc: Mauro Carvalho Chehab, linux-kernel, Jonathan Corbet, Frederic Barrat, Andrew Donnellan, Maxime Coquelin, Alexandre Torgue, Maarten Lankhorst, Maxime Ripard, Sean Paul, David Airlie, Daniel Vetter, Georgi Djakov, Matan Ziv-Av, Benjamin Herrenschmidt, Paul Mackerras, Michael Ellerman, Radim Krčmář, linuxppc-dev, linux-stm32, linux-arm-kernel, dri-devel, linux-pm, platform-driver-x86, kvm On 30/05/19 01:23, Mauro Carvalho Chehab wrote: > Sphinx doesn't like orphan documents: > > Documentation/accelerators/ocxl.rst: WARNING: document isn't included in any toctree > Documentation/arm/stm32/overview.rst: WARNING: document isn't included in any toctree > Documentation/arm/stm32/stm32f429-overview.rst: WARNING: document isn't included in any toctree > Documentation/arm/stm32/stm32f746-overview.rst: WARNING: document isn't included in any toctree > Documentation/arm/stm32/stm32f769-overview.rst: WARNING: document isn't included in any toctree > Documentation/arm/stm32/stm32h743-overview.rst: WARNING: document isn't included in any toctree > Documentation/arm/stm32/stm32mp157-overview.rst: WARNING: document isn't included in any toctree > Documentation/gpu/msm-crash-dump.rst: WARNING: document isn't included in any toctree > Documentation/interconnect/interconnect.rst: WARNING: document isn't included in any toctree > Documentation/laptops/lg-laptop.rst: WARNING: document isn't included in any toctree > Documentation/powerpc/isa-versions.rst: WARNING: document isn't included in any toctree > Documentation/virtual/kvm/amd-memory-encryption.rst: WARNING: document isn't included in any toctree > Documentation/virtual/kvm/vcpu-requests.rst: WARNING: document isn't included in any toctree > > So, while they aren't on any toctree, add :orphan: to them, in order > to silent this warning. > > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> Please leave out KVM, I'll fix that instead. Thanks for the report! Paolo > --- > Documentation/accelerators/ocxl.rst | 2 ++ > Documentation/arm/stm32/overview.rst | 2 ++ > Documentation/arm/stm32/stm32f429-overview.rst | 2 ++ > Documentation/arm/stm32/stm32f746-overview.rst | 2 ++ > Documentation/arm/stm32/stm32f769-overview.rst | 2 ++ > Documentation/arm/stm32/stm32h743-overview.rst | 2 ++ > Documentation/arm/stm32/stm32mp157-overview.rst | 2 ++ > Documentation/gpu/msm-crash-dump.rst | 2 ++ > Documentation/interconnect/interconnect.rst | 2 ++ > Documentation/laptops/lg-laptop.rst | 2 ++ > Documentation/powerpc/isa-versions.rst | 2 ++ > Documentation/virtual/kvm/amd-memory-encryption.rst | 2 ++ > Documentation/virtual/kvm/vcpu-requests.rst | 2 ++ > 13 files changed, 26 insertions(+) > > diff --git a/Documentation/accelerators/ocxl.rst b/Documentation/accelerators/ocxl.rst > index 14cefc020e2d..b1cea19a90f5 100644 > --- a/Documentation/accelerators/ocxl.rst > +++ b/Documentation/accelerators/ocxl.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > ======================================================== > OpenCAPI (Open Coherent Accelerator Processor Interface) > ======================================================== > diff --git a/Documentation/arm/stm32/overview.rst b/Documentation/arm/stm32/overview.rst > index 85cfc8410798..f7e734153860 100644 > --- a/Documentation/arm/stm32/overview.rst > +++ b/Documentation/arm/stm32/overview.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > ======================== > STM32 ARM Linux Overview > ======================== > diff --git a/Documentation/arm/stm32/stm32f429-overview.rst b/Documentation/arm/stm32/stm32f429-overview.rst > index 18feda97f483..65bbb1c3b423 100644 > --- a/Documentation/arm/stm32/stm32f429-overview.rst > +++ b/Documentation/arm/stm32/stm32f429-overview.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > STM32F429 Overview > ================== > > diff --git a/Documentation/arm/stm32/stm32f746-overview.rst b/Documentation/arm/stm32/stm32f746-overview.rst > index b5f4b6ce7656..42d593085015 100644 > --- a/Documentation/arm/stm32/stm32f746-overview.rst > +++ b/Documentation/arm/stm32/stm32f746-overview.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > STM32F746 Overview > ================== > > diff --git a/Documentation/arm/stm32/stm32f769-overview.rst b/Documentation/arm/stm32/stm32f769-overview.rst > index 228656ced2fe..f6adac862b17 100644 > --- a/Documentation/arm/stm32/stm32f769-overview.rst > +++ b/Documentation/arm/stm32/stm32f769-overview.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > STM32F769 Overview > ================== > > diff --git a/Documentation/arm/stm32/stm32h743-overview.rst b/Documentation/arm/stm32/stm32h743-overview.rst > index 3458dc00095d..c525835e7473 100644 > --- a/Documentation/arm/stm32/stm32h743-overview.rst > +++ b/Documentation/arm/stm32/stm32h743-overview.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > STM32H743 Overview > ================== > > diff --git a/Documentation/arm/stm32/stm32mp157-overview.rst b/Documentation/arm/stm32/stm32mp157-overview.rst > index 62e176d47ca7..2c52cd020601 100644 > --- a/Documentation/arm/stm32/stm32mp157-overview.rst > +++ b/Documentation/arm/stm32/stm32mp157-overview.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > STM32MP157 Overview > =================== > > diff --git a/Documentation/gpu/msm-crash-dump.rst b/Documentation/gpu/msm-crash-dump.rst > index 757cd257e0d8..240ef200f76c 100644 > --- a/Documentation/gpu/msm-crash-dump.rst > +++ b/Documentation/gpu/msm-crash-dump.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > ===================== > MSM Crash Dump Format > ===================== > diff --git a/Documentation/interconnect/interconnect.rst b/Documentation/interconnect/interconnect.rst > index c3e004893796..56e331dab70e 100644 > --- a/Documentation/interconnect/interconnect.rst > +++ b/Documentation/interconnect/interconnect.rst > @@ -1,5 +1,7 @@ > .. SPDX-License-Identifier: GPL-2.0 > > +:orphan: > + > ===================================== > GENERIC SYSTEM INTERCONNECT SUBSYSTEM > ===================================== > diff --git a/Documentation/laptops/lg-laptop.rst b/Documentation/laptops/lg-laptop.rst > index aa503ee9b3bc..f2c2ffe31101 100644 > --- a/Documentation/laptops/lg-laptop.rst > +++ b/Documentation/laptops/lg-laptop.rst > @@ -1,5 +1,7 @@ > .. SPDX-License-Identifier: GPL-2.0+ > > +:orphan: > + > LG Gram laptop extra features > ============================= > > diff --git a/Documentation/powerpc/isa-versions.rst b/Documentation/powerpc/isa-versions.rst > index 812e20cc898c..66c24140ebf1 100644 > --- a/Documentation/powerpc/isa-versions.rst > +++ b/Documentation/powerpc/isa-versions.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > CPU to ISA Version Mapping > ========================== > > diff --git a/Documentation/virtual/kvm/amd-memory-encryption.rst b/Documentation/virtual/kvm/amd-memory-encryption.rst > index 659bbc093b52..33d697ab8a58 100644 > --- a/Documentation/virtual/kvm/amd-memory-encryption.rst > +++ b/Documentation/virtual/kvm/amd-memory-encryption.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > ====================================== > Secure Encrypted Virtualization (SEV) > ====================================== > diff --git a/Documentation/virtual/kvm/vcpu-requests.rst b/Documentation/virtual/kvm/vcpu-requests.rst > index 5feb3706a7ae..c1807a1b92e6 100644 > --- a/Documentation/virtual/kvm/vcpu-requests.rst > +++ b/Documentation/virtual/kvm/vcpu-requests.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > ================= > KVM VCPU Requests > ================= > ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH 09/22] docs: mark orphan documents as such 2019-05-29 23:23 ` [PATCH 09/22] docs: mark orphan documents as such Mauro Carvalho Chehab 2019-05-30 8:30 ` Paolo Bonzini @ 2019-06-03 7:32 ` Christophe Leroy 2019-06-04 10:10 ` Mauro Carvalho Chehab 1 sibling, 1 reply; 5+ messages in thread From: Christophe Leroy @ 2019-06-03 7:32 UTC (permalink / raw) To: Mauro Carvalho Chehab, Linux Doc Mailing List Cc: kvm, Radim Krčmář, Maxime Ripard, dri-devel, platform-driver-x86, Paul Mackerras, linux-stm32, Alexandre Torgue, Jonathan Corbet, David Airlie, Andrew Donnellan, linux-pm, Maarten Lankhorst, Matan Ziv-Av, Mauro Carvalho Chehab, Daniel Vetter, Sean Paul, linux-arm-kernel, linux-kernel, Maxime Coquelin, Frederic Barrat, Paolo Bonzini, linuxppc-dev, Georgi Djakov Le 30/05/2019 à 01:23, Mauro Carvalho Chehab a écrit : > Sphinx doesn't like orphan documents: > > Documentation/accelerators/ocxl.rst: WARNING: document isn't included in any toctree > Documentation/arm/stm32/overview.rst: WARNING: document isn't included in any toctree > Documentation/arm/stm32/stm32f429-overview.rst: WARNING: document isn't included in any toctree > Documentation/arm/stm32/stm32f746-overview.rst: WARNING: document isn't included in any toctree > Documentation/arm/stm32/stm32f769-overview.rst: WARNING: document isn't included in any toctree > Documentation/arm/stm32/stm32h743-overview.rst: WARNING: document isn't included in any toctree > Documentation/arm/stm32/stm32mp157-overview.rst: WARNING: document isn't included in any toctree > Documentation/gpu/msm-crash-dump.rst: WARNING: document isn't included in any toctree > Documentation/interconnect/interconnect.rst: WARNING: document isn't included in any toctree > Documentation/laptops/lg-laptop.rst: WARNING: document isn't included in any toctree > Documentation/powerpc/isa-versions.rst: WARNING: document isn't included in any toctree > Documentation/virtual/kvm/amd-memory-encryption.rst: WARNING: document isn't included in any toctree > Documentation/virtual/kvm/vcpu-requests.rst: WARNING: document isn't included in any toctree > > So, while they aren't on any toctree, add :orphan: to them, in order > to silent this warning. Are those files really not meant to be included in a toctree ? Shouldn't we include them in the relevant toctree instead of just shutting up Sphinx warnings ? Christophe > > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> > --- > Documentation/accelerators/ocxl.rst | 2 ++ > Documentation/arm/stm32/overview.rst | 2 ++ > Documentation/arm/stm32/stm32f429-overview.rst | 2 ++ > Documentation/arm/stm32/stm32f746-overview.rst | 2 ++ > Documentation/arm/stm32/stm32f769-overview.rst | 2 ++ > Documentation/arm/stm32/stm32h743-overview.rst | 2 ++ > Documentation/arm/stm32/stm32mp157-overview.rst | 2 ++ > Documentation/gpu/msm-crash-dump.rst | 2 ++ > Documentation/interconnect/interconnect.rst | 2 ++ > Documentation/laptops/lg-laptop.rst | 2 ++ > Documentation/powerpc/isa-versions.rst | 2 ++ > Documentation/virtual/kvm/amd-memory-encryption.rst | 2 ++ > Documentation/virtual/kvm/vcpu-requests.rst | 2 ++ > 13 files changed, 26 insertions(+) > > diff --git a/Documentation/accelerators/ocxl.rst b/Documentation/accelerators/ocxl.rst > index 14cefc020e2d..b1cea19a90f5 100644 > --- a/Documentation/accelerators/ocxl.rst > +++ b/Documentation/accelerators/ocxl.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > ======================================================== > OpenCAPI (Open Coherent Accelerator Processor Interface) > ======================================================== > diff --git a/Documentation/arm/stm32/overview.rst b/Documentation/arm/stm32/overview.rst > index 85cfc8410798..f7e734153860 100644 > --- a/Documentation/arm/stm32/overview.rst > +++ b/Documentation/arm/stm32/overview.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > ======================== > STM32 ARM Linux Overview > ======================== > diff --git a/Documentation/arm/stm32/stm32f429-overview.rst b/Documentation/arm/stm32/stm32f429-overview.rst > index 18feda97f483..65bbb1c3b423 100644 > --- a/Documentation/arm/stm32/stm32f429-overview.rst > +++ b/Documentation/arm/stm32/stm32f429-overview.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > STM32F429 Overview > ================== > > diff --git a/Documentation/arm/stm32/stm32f746-overview.rst b/Documentation/arm/stm32/stm32f746-overview.rst > index b5f4b6ce7656..42d593085015 100644 > --- a/Documentation/arm/stm32/stm32f746-overview.rst > +++ b/Documentation/arm/stm32/stm32f746-overview.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > STM32F746 Overview > ================== > > diff --git a/Documentation/arm/stm32/stm32f769-overview.rst b/Documentation/arm/stm32/stm32f769-overview.rst > index 228656ced2fe..f6adac862b17 100644 > --- a/Documentation/arm/stm32/stm32f769-overview.rst > +++ b/Documentation/arm/stm32/stm32f769-overview.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > STM32F769 Overview > ================== > > diff --git a/Documentation/arm/stm32/stm32h743-overview.rst b/Documentation/arm/stm32/stm32h743-overview.rst > index 3458dc00095d..c525835e7473 100644 > --- a/Documentation/arm/stm32/stm32h743-overview.rst > +++ b/Documentation/arm/stm32/stm32h743-overview.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > STM32H743 Overview > ================== > > diff --git a/Documentation/arm/stm32/stm32mp157-overview.rst b/Documentation/arm/stm32/stm32mp157-overview.rst > index 62e176d47ca7..2c52cd020601 100644 > --- a/Documentation/arm/stm32/stm32mp157-overview.rst > +++ b/Documentation/arm/stm32/stm32mp157-overview.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > STM32MP157 Overview > =================== > > diff --git a/Documentation/gpu/msm-crash-dump.rst b/Documentation/gpu/msm-crash-dump.rst > index 757cd257e0d8..240ef200f76c 100644 > --- a/Documentation/gpu/msm-crash-dump.rst > +++ b/Documentation/gpu/msm-crash-dump.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > ===================== > MSM Crash Dump Format > ===================== > diff --git a/Documentation/interconnect/interconnect.rst b/Documentation/interconnect/interconnect.rst > index c3e004893796..56e331dab70e 100644 > --- a/Documentation/interconnect/interconnect.rst > +++ b/Documentation/interconnect/interconnect.rst > @@ -1,5 +1,7 @@ > .. SPDX-License-Identifier: GPL-2.0 > > +:orphan: > + > ===================================== > GENERIC SYSTEM INTERCONNECT SUBSYSTEM > ===================================== > diff --git a/Documentation/laptops/lg-laptop.rst b/Documentation/laptops/lg-laptop.rst > index aa503ee9b3bc..f2c2ffe31101 100644 > --- a/Documentation/laptops/lg-laptop.rst > +++ b/Documentation/laptops/lg-laptop.rst > @@ -1,5 +1,7 @@ > .. SPDX-License-Identifier: GPL-2.0+ > > +:orphan: > + > LG Gram laptop extra features > ============================= > > diff --git a/Documentation/powerpc/isa-versions.rst b/Documentation/powerpc/isa-versions.rst > index 812e20cc898c..66c24140ebf1 100644 > --- a/Documentation/powerpc/isa-versions.rst > +++ b/Documentation/powerpc/isa-versions.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > CPU to ISA Version Mapping > ========================== > > diff --git a/Documentation/virtual/kvm/amd-memory-encryption.rst b/Documentation/virtual/kvm/amd-memory-encryption.rst > index 659bbc093b52..33d697ab8a58 100644 > --- a/Documentation/virtual/kvm/amd-memory-encryption.rst > +++ b/Documentation/virtual/kvm/amd-memory-encryption.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > ====================================== > Secure Encrypted Virtualization (SEV) > ====================================== > diff --git a/Documentation/virtual/kvm/vcpu-requests.rst b/Documentation/virtual/kvm/vcpu-requests.rst > index 5feb3706a7ae..c1807a1b92e6 100644 > --- a/Documentation/virtual/kvm/vcpu-requests.rst > +++ b/Documentation/virtual/kvm/vcpu-requests.rst > @@ -1,3 +1,5 @@ > +:orphan: > + > ================= > KVM VCPU Requests > ================= > ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH 09/22] docs: mark orphan documents as such 2019-06-03 7:32 ` Christophe Leroy @ 2019-06-04 10:10 ` Mauro Carvalho Chehab 0 siblings, 0 replies; 5+ messages in thread From: Mauro Carvalho Chehab @ 2019-06-04 10:10 UTC (permalink / raw) To: Christophe Leroy Cc: Linux Doc Mailing List, kvm, Radim Krčmář, Maxime Ripard, dri-devel, platform-driver-x86, Paul Mackerras, linux-stm32, Alexandre Torgue, Jonathan Corbet, David Airlie, Andrew Donnellan, linux-pm, Maarten Lankhorst, Matan Ziv-Av, Mauro Carvalho Chehab, Daniel Vetter, Sean Paul, linux-arm-kernel, linux-kernel, Maxime Coquelin, Frederic Barrat, Paolo Bonzini, linuxppc-dev, Georgi Djakov Em Mon, 3 Jun 2019 09:32:54 +0200 Christophe Leroy <christophe.leroy@c-s.fr> escreveu: > Le 30/05/2019 à 01:23, Mauro Carvalho Chehab a écrit : > > Sphinx doesn't like orphan documents: > > > > Documentation/accelerators/ocxl.rst: WARNING: document isn't included in any toctree > > Documentation/arm/stm32/overview.rst: WARNING: document isn't included in any toctree > > Documentation/arm/stm32/stm32f429-overview.rst: WARNING: document isn't included in any toctree > > Documentation/arm/stm32/stm32f746-overview.rst: WARNING: document isn't included in any toctree > > Documentation/arm/stm32/stm32f769-overview.rst: WARNING: document isn't included in any toctree > > Documentation/arm/stm32/stm32h743-overview.rst: WARNING: document isn't included in any toctree > > Documentation/arm/stm32/stm32mp157-overview.rst: WARNING: document isn't included in any toctree > > Documentation/gpu/msm-crash-dump.rst: WARNING: document isn't included in any toctree > > Documentation/interconnect/interconnect.rst: WARNING: document isn't included in any toctree > > Documentation/laptops/lg-laptop.rst: WARNING: document isn't included in any toctree > > Documentation/powerpc/isa-versions.rst: WARNING: document isn't included in any toctree > > Documentation/virtual/kvm/amd-memory-encryption.rst: WARNING: document isn't included in any toctree > > Documentation/virtual/kvm/vcpu-requests.rst: WARNING: document isn't included in any toctree > > > > So, while they aren't on any toctree, add :orphan: to them, in order > > to silent this warning. > > Are those files really not meant to be included in a toctree ? > > Shouldn't we include them in the relevant toctree instead of just > shutting up Sphinx warnings ? This is a good point. My understanding is that those orphaned docs are there for two reasons: 1) someone created a new document as .rst but there's no index.rst file yet, as there are lots of other documents already there not converted. That's the case, for example, of the ones under Documentation/arm; 2) They're part of an undergoing effort of converting stuff to ReST. One opted to keep it orphaned temporarily in order to avoid merge conflicts. That's said, I have myself a big (/86 patches and growing) series with do a huge step on txt->rst conversion (it covers a significant amount of documentation). On this series, I'm removing the orphaned tags for several files (including, for example, those at Documentation/arm). Yet, it is a lot easier to see if such series is not introducing warnings regressions if we first address those. It should be notice that discovering the orphaned files should be as simple as: git grep -l ":orphan:" Documentation > > Christophe > > > > > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> > > --- > > Documentation/accelerators/ocxl.rst | 2 ++ > > Documentation/arm/stm32/overview.rst | 2 ++ > > Documentation/arm/stm32/stm32f429-overview.rst | 2 ++ > > Documentation/arm/stm32/stm32f746-overview.rst | 2 ++ > > Documentation/arm/stm32/stm32f769-overview.rst | 2 ++ > > Documentation/arm/stm32/stm32h743-overview.rst | 2 ++ > > Documentation/arm/stm32/stm32mp157-overview.rst | 2 ++ > > Documentation/gpu/msm-crash-dump.rst | 2 ++ > > Documentation/interconnect/interconnect.rst | 2 ++ > > Documentation/laptops/lg-laptop.rst | 2 ++ > > Documentation/powerpc/isa-versions.rst | 2 ++ > > Documentation/virtual/kvm/amd-memory-encryption.rst | 2 ++ > > Documentation/virtual/kvm/vcpu-requests.rst | 2 ++ > > 13 files changed, 26 insertions(+) > > > > diff --git a/Documentation/accelerators/ocxl.rst b/Documentation/accelerators/ocxl.rst > > index 14cefc020e2d..b1cea19a90f5 100644 > > --- a/Documentation/accelerators/ocxl.rst > > +++ b/Documentation/accelerators/ocxl.rst > > @@ -1,3 +1,5 @@ > > +:orphan: > > + > > ======================================================== > > OpenCAPI (Open Coherent Accelerator Processor Interface) > > ======================================================== > > diff --git a/Documentation/arm/stm32/overview.rst b/Documentation/arm/stm32/overview.rst > > index 85cfc8410798..f7e734153860 100644 > > --- a/Documentation/arm/stm32/overview.rst > > +++ b/Documentation/arm/stm32/overview.rst > > @@ -1,3 +1,5 @@ > > +:orphan: > > + > > ======================== > > STM32 ARM Linux Overview > > ======================== > > diff --git a/Documentation/arm/stm32/stm32f429-overview.rst b/Documentation/arm/stm32/stm32f429-overview.rst > > index 18feda97f483..65bbb1c3b423 100644 > > --- a/Documentation/arm/stm32/stm32f429-overview.rst > > +++ b/Documentation/arm/stm32/stm32f429-overview.rst > > @@ -1,3 +1,5 @@ > > +:orphan: > > + > > STM32F429 Overview > > ================== > > > > diff --git a/Documentation/arm/stm32/stm32f746-overview.rst b/Documentation/arm/stm32/stm32f746-overview.rst > > index b5f4b6ce7656..42d593085015 100644 > > --- a/Documentation/arm/stm32/stm32f746-overview.rst > > +++ b/Documentation/arm/stm32/stm32f746-overview.rst > > @@ -1,3 +1,5 @@ > > +:orphan: > > + > > STM32F746 Overview > > ================== > > > > diff --git a/Documentation/arm/stm32/stm32f769-overview.rst b/Documentation/arm/stm32/stm32f769-overview.rst > > index 228656ced2fe..f6adac862b17 100644 > > --- a/Documentation/arm/stm32/stm32f769-overview.rst > > +++ b/Documentation/arm/stm32/stm32f769-overview.rst > > @@ -1,3 +1,5 @@ > > +:orphan: > > + > > STM32F769 Overview > > ================== > > > > diff --git a/Documentation/arm/stm32/stm32h743-overview.rst b/Documentation/arm/stm32/stm32h743-overview.rst > > index 3458dc00095d..c525835e7473 100644 > > --- a/Documentation/arm/stm32/stm32h743-overview.rst > > +++ b/Documentation/arm/stm32/stm32h743-overview.rst > > @@ -1,3 +1,5 @@ > > +:orphan: > > + > > STM32H743 Overview > > ================== > > > > diff --git a/Documentation/arm/stm32/stm32mp157-overview.rst b/Documentation/arm/stm32/stm32mp157-overview.rst > > index 62e176d47ca7..2c52cd020601 100644 > > --- a/Documentation/arm/stm32/stm32mp157-overview.rst > > +++ b/Documentation/arm/stm32/stm32mp157-overview.rst > > @@ -1,3 +1,5 @@ > > +:orphan: > > + > > STM32MP157 Overview > > =================== > > > > diff --git a/Documentation/gpu/msm-crash-dump.rst b/Documentation/gpu/msm-crash-dump.rst > > index 757cd257e0d8..240ef200f76c 100644 > > --- a/Documentation/gpu/msm-crash-dump.rst > > +++ b/Documentation/gpu/msm-crash-dump.rst > > @@ -1,3 +1,5 @@ > > +:orphan: > > + > > ===================== > > MSM Crash Dump Format > > ===================== > > diff --git a/Documentation/interconnect/interconnect.rst b/Documentation/interconnect/interconnect.rst > > index c3e004893796..56e331dab70e 100644 > > --- a/Documentation/interconnect/interconnect.rst > > +++ b/Documentation/interconnect/interconnect.rst > > @@ -1,5 +1,7 @@ > > .. SPDX-License-Identifier: GPL-2.0 > > > > +:orphan: > > + > > ===================================== > > GENERIC SYSTEM INTERCONNECT SUBSYSTEM > > ===================================== > > diff --git a/Documentation/laptops/lg-laptop.rst b/Documentation/laptops/lg-laptop.rst > > index aa503ee9b3bc..f2c2ffe31101 100644 > > --- a/Documentation/laptops/lg-laptop.rst > > +++ b/Documentation/laptops/lg-laptop.rst > > @@ -1,5 +1,7 @@ > > .. SPDX-License-Identifier: GPL-2.0+ > > > > +:orphan: > > + > > LG Gram laptop extra features > > ============================= > > > > diff --git a/Documentation/powerpc/isa-versions.rst b/Documentation/powerpc/isa-versions.rst > > index 812e20cc898c..66c24140ebf1 100644 > > --- a/Documentation/powerpc/isa-versions.rst > > +++ b/Documentation/powerpc/isa-versions.rst > > @@ -1,3 +1,5 @@ > > +:orphan: > > + > > CPU to ISA Version Mapping > > ========================== > > > > diff --git a/Documentation/virtual/kvm/amd-memory-encryption.rst b/Documentation/virtual/kvm/amd-memory-encryption.rst > > index 659bbc093b52..33d697ab8a58 100644 > > --- a/Documentation/virtual/kvm/amd-memory-encryption.rst > > +++ b/Documentation/virtual/kvm/amd-memory-encryption.rst > > @@ -1,3 +1,5 @@ > > +:orphan: > > + > > ====================================== > > Secure Encrypted Virtualization (SEV) > > ====================================== > > diff --git a/Documentation/virtual/kvm/vcpu-requests.rst b/Documentation/virtual/kvm/vcpu-requests.rst > > index 5feb3706a7ae..c1807a1b92e6 100644 > > --- a/Documentation/virtual/kvm/vcpu-requests.rst > > +++ b/Documentation/virtual/kvm/vcpu-requests.rst > > @@ -1,3 +1,5 @@ > > +:orphan: > > + > > ================= > > KVM VCPU Requests > > ================= > > Thanks, Mauro ^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2019-06-04 10:11 UTC | newest] Thread overview: 5+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2019-05-29 23:23 [PATCH 00/22] Some documentation fixes Mauro Carvalho Chehab 2019-05-29 23:23 ` [PATCH 09/22] docs: mark orphan documents as such Mauro Carvalho Chehab 2019-05-30 8:30 ` Paolo Bonzini 2019-06-03 7:32 ` Christophe Leroy 2019-06-04 10:10 ` Mauro Carvalho Chehab
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).