docs: fix broken references to text files

Several references got broken due to txt to ReST conversion.

Several of them can be automatically fixed with:

	scripts/documentation-file-ref-check --fix

Reviewed-by: Mathieu Poirier <mathieu.poirier@linaro.org> # hwtracing/coresight/Kconfig
Reviewed-by: Paul E. McKenney <paulmck@kernel.org> # memory-barrier.txt
Acked-by: Alex Shi <alex.shi@linux.alibaba.com> # translations/zh_CN
Acked-by: Federico Vaga <federico.vaga@vaga.pv.it> # translations/it_IT
Acked-by: Marc Zyngier <maz@kernel.org> # kvm/arm64
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/6f919ddb83a33b5f2a63b6b5f0575737bb2b36aa.1586881715.git.mchehab+huawei@kernel.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
This commit is contained in:
Mauro Carvalho Chehab 2020-04-14 18:48:35 +02:00 committed by Jonathan Corbet
parent f9faa90899
commit 72ef5e52b3
23 changed files with 36 additions and 36 deletions

View File

@ -620,7 +620,7 @@ because the CPUs that the Linux kernel supports don't do writes
until they are certain (1) that the write will actually happen, (2) until they are certain (1) that the write will actually happen, (2)
of the location of the write, and (3) of the value to be written. of the location of the write, and (3) of the value to be written.
But please carefully read the "CONTROL DEPENDENCIES" section and the But please carefully read the "CONTROL DEPENDENCIES" section and the
Documentation/RCU/rcu_dereference.txt file: The compiler can and does Documentation/RCU/rcu_dereference.rst file: The compiler can and does
break dependencies in a great many highly creative ways. break dependencies in a great many highly creative ways.
CPU 1 CPU 2 CPU 1 CPU 2

View File

@ -107,7 +107,7 @@ and elsewhere regarding submitting Linux kernel patches.
and why. and why.
26) If any ioctl's are added by the patch, then also update 26) If any ioctl's are added by the patch, then also update
``Documentation/ioctl/ioctl-number.rst``. ``Documentation/userspace-api/ioctl/ioctl-number.rst``.
27) If your modified source code depends on or uses any of the kernel 27) If your modified source code depends on or uses any of the kernel
APIs or features that are related to the following ``Kconfig`` symbols, APIs or features that are related to the following ``Kconfig`` symbols,

View File

@ -117,7 +117,7 @@ sottomissione delle patch, in particolare
sorgenti che ne spieghi la logica: cosa fanno e perché. sorgenti che ne spieghi la logica: cosa fanno e perché.
25) Se la patch aggiunge nuove chiamate ioctl, allora aggiornate 25) Se la patch aggiunge nuove chiamate ioctl, allora aggiornate
``Documentation/ioctl/ioctl-number.rst``. ``Documentation/userspace-api/ioctl/ioctl-number.rst``.
26) Se il codice che avete modificato dipende o usa una qualsiasi interfaccia o 26) Se il codice che avete modificato dipende o usa una qualsiasi interfaccia o
funzionalità del kernel che è associata a uno dei seguenti simboli funzionalità del kernel che è associata a uno dei seguenti simboli

View File

@ -641,7 +641,7 @@ P 는 짝수 번호 캐시 라인에 저장되어 있고, 변수 B 는 홀수
리눅스 커널이 지원하는 CPU 들은 (1) 쓰기가 정말로 일어날지, (2) 쓰기가 어디에 리눅스 커널이 지원하는 CPU 들은 (1) 쓰기가 정말로 일어날지, (2) 쓰기가 어디에
이루어질지, 그리고 (3) 쓰여질 값을 확실히 알기 전까지는 쓰기를 수행하지 않기 이루어질지, 그리고 (3) 쓰여질 값을 확실히 알기 전까지는 쓰기를 수행하지 않기
때문입니다. 하지만 "컨트롤 의존성" 섹션과 때문입니다. 하지만 "컨트롤 의존성" 섹션과
Documentation/RCU/rcu_dereference.txt 파일을 주의 깊게 읽어 주시기 바랍니다: Documentation/RCU/rcu_dereference.rst 파일을 주의 깊게 읽어 주시기 바랍니다:
컴파일러는 매우 창의적인 많은 방법으로 종속성을 깰 수 있습니다. 컴파일러는 매우 창의적인 많은 방법으로 종속성을 깰 수 있습니다.
CPU 1 CPU 2 CPU 1 CPU 2

View File

@ -281,7 +281,7 @@ drivers/ 包含了每个已为特定总线上的设备而挂载的驱动程序
假定驱动没有跨越多个总线类型)。 假定驱动没有跨越多个总线类型)。
fs/ 包含了一个为文件系统设立的目录。现在每个想要导出属性的文件系统必须 fs/ 包含了一个为文件系统设立的目录。现在每个想要导出属性的文件系统必须
在 fs/ 下创建自己的层次结构(参见Documentation/filesystems/fuse.txt)。 在 fs/ 下创建自己的层次结构(参见Documentation/filesystems/fuse.rst)。
dev/ 包含两个子目录: char/ 和 block/。在这两个子目录中,有以 dev/ 包含两个子目录: char/ 和 block/。在这两个子目录中,有以
<major>:<minor> 格式命名的符号链接。这些符号链接指向 sysfs 目录 <major>:<minor> 格式命名的符号链接。这些符号链接指向 sysfs 目录

View File

@ -97,7 +97,7 @@ Linux内核补丁提交清单
24) 所有内存屏障例如 ``barrier()``, ``rmb()``, ``wmb()`` 都需要源代码中的注 24) 所有内存屏障例如 ``barrier()``, ``rmb()``, ``wmb()`` 都需要源代码中的注
释来解释它们正在执行的操作及其原因的逻辑。 释来解释它们正在执行的操作及其原因的逻辑。
25) 如果补丁添加了任何ioctl那么也要更新 ``Documentation/ioctl/ioctl-number.rst`` 25) 如果补丁添加了任何ioctl那么也要更新 ``Documentation/userspace-api/ioctl/ioctl-number.rst``
26) 如果修改后的源代码依赖或使用与以下 ``Kconfig`` 符号相关的任何内核API或 26) 如果修改后的源代码依赖或使用与以下 ``Kconfig`` 符号相关的任何内核API或
功能,则在禁用相关 ``Kconfig`` 符号和/或 ``=m`` (如果该选项可用)的情况 功能,则在禁用相关 ``Kconfig`` 符号和/或 ``=m`` (如果该选项可用)的情况

View File

@ -76,5 +76,5 @@ It is advisable that one or more 64k pages are set aside for the purpose of
these structures and not used for other purposes, this enables the guest to map these structures and not used for other purposes, this enables the guest to map
the region using 64k pages and avoids conflicting attributes with other memory. the region using 64k pages and avoids conflicting attributes with other memory.
For the user space interface see Documentation/virt/kvm/devices/vcpu.txt For the user space interface see Documentation/virt/kvm/devices/vcpu.rst
section "3. GROUP: KVM_ARM_VCPU_PVTIME_CTRL". section "3. GROUP: KVM_ARM_VCPU_PVTIME_CTRL".

View File

@ -110,5 +110,5 @@ Returns:
Specifies the base address of the stolen time structure for this VCPU. The Specifies the base address of the stolen time structure for this VCPU. The
base address must be 64 byte aligned and exist within a valid guest memory base address must be 64 byte aligned and exist within a valid guest memory
region. See Documentation/virt/kvm/arm/pvtime.txt for more information region. See Documentation/virt/kvm/arm/pvtime.rst for more information
including the layout of the stolen time structure. including the layout of the stolen time structure.

View File

@ -22,7 +22,7 @@ S390:
number in R1. number in R1.
For further information on the S390 diagnose call as supported by KVM, For further information on the S390 diagnose call as supported by KVM,
refer to Documentation/virt/kvm/s390-diag.txt. refer to Documentation/virt/kvm/s390-diag.rst.
PowerPC: PowerPC:
It uses R3-R10 and hypercall number in R11. R4-R11 are used as output registers. It uses R3-R10 and hypercall number in R11. R4-R11 are used as output registers.
@ -30,7 +30,7 @@ PowerPC:
KVM hypercalls uses 4 byte opcode, that are patched with 'hypercall-instructions' KVM hypercalls uses 4 byte opcode, that are patched with 'hypercall-instructions'
property inside the device tree's /hypervisor node. property inside the device tree's /hypervisor node.
For more information refer to Documentation/virt/kvm/ppc-pv.txt For more information refer to Documentation/virt/kvm/ppc-pv.rst
MIPS: MIPS:
KVM hypercalls use the HYPCALL instruction with code 0 and the hypercall KVM hypercalls use the HYPCALL instruction with code 0 and the hypercall

View File

@ -31,7 +31,7 @@
* Struct fields are always 32 or 64 bit aligned, depending on them being 32 * Struct fields are always 32 or 64 bit aligned, depending on them being 32
* or 64 bit wide respectively. * or 64 bit wide respectively.
* *
* See Documentation/virt/kvm/ppc-pv.txt * See Documentation/virt/kvm/ppc-pv.rst
*/ */
struct kvm_vcpu_arch_shared { struct kvm_vcpu_arch_shared {
__u64 scratch1; __u64 scratch1;

View File

@ -161,7 +161,7 @@ config DRM_LOAD_EDID_FIRMWARE
monitor are unable to provide appropriate EDID data. Since this monitor are unable to provide appropriate EDID data. Since this
feature is provided as a workaround for broken hardware, the feature is provided as a workaround for broken hardware, the
default case is N. Details and instructions how to build your own default case is N. Details and instructions how to build your own
EDID data are given in Documentation/driver-api/edid.rst. EDID data are given in Documentation/admin-guide/edid.rst.
config DRM_DP_CEC config DRM_DP_CEC
bool "Enable DisplayPort CEC-Tunneling-over-AUX HDMI support" bool "Enable DisplayPort CEC-Tunneling-over-AUX HDMI support"

View File

@ -741,7 +741,7 @@ static const struct drm_ioctl_desc drm_ioctls[] = {
* }; * };
* *
* Please make sure that you follow all the best practices from * Please make sure that you follow all the best practices from
* ``Documentation/ioctl/botching-up-ioctls.rst``. Note that drm_ioctl() * ``Documentation/process/botching-up-ioctls.rst``. Note that drm_ioctl()
* automatically zero-extends structures, hence make sure you can add more stuff * automatically zero-extends structures, hence make sure you can add more stuff
* at the end, i.e. don't put a variable sized array there. * at the end, i.e. don't put a variable sized array there.
* *

View File

@ -107,7 +107,7 @@ config CORESIGHT_CPU_DEBUG
can quickly get to know program counter (PC), secure state, can quickly get to know program counter (PC), secure state,
exception level, etc. Before use debugging functionality, platform exception level, etc. Before use debugging functionality, platform
needs to ensure the clock domain and power domain are enabled needs to ensure the clock domain and power domain are enabled
properly, please refer Documentation/trace/coresight-cpu-debug.rst properly, please refer Documentation/trace/coresight/coresight-cpu-debug.rst
for detailed description and the example for usage. for detailed description and the example for usage.
config CORESIGHT_CTI config CORESIGHT_CTI

View File

@ -69,7 +69,7 @@ config VFAT_FS
The VFAT support enlarges your kernel by about 10 KB and it only The VFAT support enlarges your kernel by about 10 KB and it only
works if you said Y to the "DOS FAT fs support" above. Please read works if you said Y to the "DOS FAT fs support" above. Please read
the file <file:Documentation/filesystems/vfat.txt> for details. If the file <file:Documentation/filesystems/vfat.rst> for details. If
unsure, say Y. unsure, say Y.
To compile this as a module, choose M here: the module will be called To compile this as a module, choose M here: the module will be called
@ -82,7 +82,7 @@ config FAT_DEFAULT_CODEPAGE
help help
This option should be set to the codepage of your FAT filesystems. This option should be set to the codepage of your FAT filesystems.
It can be overridden with the "codepage" mount option. It can be overridden with the "codepage" mount option.
See <file:Documentation/filesystems/vfat.txt> for more information. See <file:Documentation/filesystems/vfat.rst> for more information.
config FAT_DEFAULT_IOCHARSET config FAT_DEFAULT_IOCHARSET
string "Default iocharset for FAT" string "Default iocharset for FAT"
@ -96,7 +96,7 @@ config FAT_DEFAULT_IOCHARSET
Note that "utf8" is not recommended for FAT filesystems. Note that "utf8" is not recommended for FAT filesystems.
If unsure, you shouldn't set "utf8" here - select the next option If unsure, you shouldn't set "utf8" here - select the next option
instead if you would like to use UTF-8 encoded file names by default. instead if you would like to use UTF-8 encoded file names by default.
See <file:Documentation/filesystems/vfat.txt> for more information. See <file:Documentation/filesystems/vfat.rst> for more information.
Enable any character sets you need in File Systems/Native Language Enable any character sets you need in File Systems/Native Language
Support. Support.
@ -114,4 +114,4 @@ config FAT_DEFAULT_UTF8
Say Y if you use UTF-8 encoding for file names, N otherwise. Say Y if you use UTF-8 encoding for file names, N otherwise.
See <file:Documentation/filesystems/vfat.txt> for more information. See <file:Documentation/filesystems/vfat.rst> for more information.

View File

@ -12,7 +12,7 @@ config FUSE_FS
although chances are your distribution already has that library although chances are your distribution already has that library
installed if you've installed the "fuse" package itself. installed if you've installed the "fuse" package itself.
See <file:Documentation/filesystems/fuse.txt> for more information. See <file:Documentation/filesystems/fuse.rst> for more information.
See <file:Documentation/Changes> for needed library/utility version. See <file:Documentation/Changes> for needed library/utility version.
If you want to develop a userspace FS, or if you want to use If you want to develop a userspace FS, or if you want to use

View File

@ -2081,7 +2081,7 @@ static void end_polls(struct fuse_conn *fc)
* The same effect is usually achievable through killing the filesystem daemon * The same effect is usually achievable through killing the filesystem daemon
* and all users of the filesystem. The exception is the combination of an * and all users of the filesystem. The exception is the combination of an
* asynchronous request and the tricky deadlock (see * asynchronous request and the tricky deadlock (see
* Documentation/filesystems/fuse.txt). * Documentation/filesystems/fuse.rst).
* *
* Aborting requests under I/O goes as follows: 1: Separate out unlocked * Aborting requests under I/O goes as follows: 1: Separate out unlocked
* requests, they should be finished off immediately. Locked requests will be * requests, they should be finished off immediately. Locked requests will be

View File

@ -9,7 +9,7 @@ config OVERLAY_FS
'lower' filesystem is either hidden or, in the case of directories, 'lower' filesystem is either hidden or, in the case of directories,
merged with the 'upper' object. merged with the 'upper' object.
For more information see Documentation/filesystems/overlayfs.txt For more information see Documentation/filesystems/overlayfs.rst
config OVERLAY_FS_REDIRECT_DIR config OVERLAY_FS_REDIRECT_DIR
bool "Overlayfs: turn on redirect directory feature by default" bool "Overlayfs: turn on redirect directory feature by default"
@ -38,7 +38,7 @@ config OVERLAY_FS_REDIRECT_ALWAYS_FOLLOW
If backward compatibility is not an issue, then it is safe and If backward compatibility is not an issue, then it is safe and
recommended to say N here. recommended to say N here.
For more information, see Documentation/filesystems/overlayfs.txt For more information, see Documentation/filesystems/overlayfs.rst
If unsure, say Y. If unsure, say Y.
@ -103,7 +103,7 @@ config OVERLAY_FS_XINO_AUTO
If compatibility with applications that expect 32bit inodes is not an If compatibility with applications that expect 32bit inodes is not an
issue, then it is safe and recommended to say Y here. issue, then it is safe and recommended to say Y here.
For more information, see Documentation/filesystems/overlayfs.txt For more information, see Documentation/filesystems/overlayfs.rst
If unsure, say N. If unsure, say N.

View File

@ -1219,7 +1219,7 @@ void unpin_user_pages(struct page **pages, unsigned long npages);
* used to track the pincount (instead using of the GUP_PIN_COUNTING_BIAS * used to track the pincount (instead using of the GUP_PIN_COUNTING_BIAS
* scheme). * scheme).
* *
* For more information, please see Documentation/vm/pin_user_pages.rst. * For more information, please see Documentation/core-api/pin_user_pages.rst.
* *
* @page: pointer to page to be queried. * @page: pointer to page to be queried.
* @Return: True, if it is likely that the page has been "dma-pinned". * @Return: True, if it is likely that the page has been "dma-pinned".
@ -2834,7 +2834,7 @@ struct page *follow_page(struct vm_area_struct *vma, unsigned long address,
* releasing pages: get_user_pages*() pages must be released via put_page(), * releasing pages: get_user_pages*() pages must be released via put_page(),
* while pin_user_pages*() pages must be released via unpin_user_page(). * while pin_user_pages*() pages must be released via unpin_user_page().
* *
* Please see Documentation/vm/pin_user_pages.rst for more information. * Please see Documentation/core-api/pin_user_pages.rst for more information.
*/ */
static inline int vm_fault_to_errno(vm_fault_t vm_fault, int foll_flags) static inline int vm_fault_to_errno(vm_fault_t vm_fault, int foll_flags)

View File

@ -2,7 +2,7 @@
/* /*
* include/uapi/linux/ethtool_netlink.h - netlink interface for ethtool * include/uapi/linux/ethtool_netlink.h - netlink interface for ethtool
* *
* See Documentation/networking/ethtool-netlink.txt in kernel source tree for * See Documentation/networking/ethtool-netlink.rst in kernel source tree for
* doucumentation of the interface. * doucumentation of the interface.
*/ */

View File

@ -36,7 +36,7 @@
#include <linux/types.h> #include <linux/types.h>
#include <linux/ioctl.h> #include <linux/ioctl.h>
/* Documentation/ioctl/ioctl-number.rst */ /* Documentation/userspace-api/ioctl/ioctl-number.rst */
#define RDMA_IOCTL_MAGIC 0x1b #define RDMA_IOCTL_MAGIC 0x1b
#define RDMA_VERBS_IOCTL \ #define RDMA_VERBS_IOCTL \
_IOWR(RDMA_IOCTL_MAGIC, 1, struct ib_uverbs_ioctl_hdr) _IOWR(RDMA_IOCTL_MAGIC, 1, struct ib_uverbs_ioctl_hdr)

View File

@ -2843,9 +2843,9 @@ EXPORT_SYMBOL_GPL(get_user_pages_fast);
* the arguments here are identical. * the arguments here are identical.
* *
* FOLL_PIN means that the pages must be released via unpin_user_page(). Please * FOLL_PIN means that the pages must be released via unpin_user_page(). Please
* see Documentation/vm/pin_user_pages.rst for further details. * see Documentation/core-api/pin_user_pages.rst for further details.
* *
* This is intended for Case 1 (DIO) in Documentation/vm/pin_user_pages.rst. It * This is intended for Case 1 (DIO) in Documentation/core-api/pin_user_pages.rst. It
* is NOT intended for Case 2 (RDMA: long-term pins). * is NOT intended for Case 2 (RDMA: long-term pins).
*/ */
int pin_user_pages_fast(unsigned long start, int nr_pages, int pin_user_pages_fast(unsigned long start, int nr_pages,
@ -2883,9 +2883,9 @@ EXPORT_SYMBOL_GPL(pin_user_pages_fast);
* the arguments here are identical. * the arguments here are identical.
* *
* FOLL_PIN means that the pages must be released via unpin_user_page(). Please * FOLL_PIN means that the pages must be released via unpin_user_page(). Please
* see Documentation/vm/pin_user_pages.rst for details. * see Documentation/core-api/pin_user_pages.rst for details.
* *
* This is intended for Case 1 (DIO) in Documentation/vm/pin_user_pages.rst. It * This is intended for Case 1 (DIO) in Documentation/core-api/pin_user_pages.rst. It
* is NOT intended for Case 2 (RDMA: long-term pins). * is NOT intended for Case 2 (RDMA: long-term pins).
*/ */
long pin_user_pages_remote(struct task_struct *tsk, struct mm_struct *mm, long pin_user_pages_remote(struct task_struct *tsk, struct mm_struct *mm,
@ -2919,9 +2919,9 @@ EXPORT_SYMBOL(pin_user_pages_remote);
* FOLL_PIN is set. * FOLL_PIN is set.
* *
* FOLL_PIN means that the pages must be released via unpin_user_page(). Please * FOLL_PIN means that the pages must be released via unpin_user_page(). Please
* see Documentation/vm/pin_user_pages.rst for details. * see Documentation/core-api/pin_user_pages.rst for details.
* *
* This is intended for Case 1 (DIO) in Documentation/vm/pin_user_pages.rst. It * This is intended for Case 1 (DIO) in Documentation/core-api/pin_user_pages.rst. It
* is NOT intended for Case 2 (RDMA: long-term pins). * is NOT intended for Case 2 (RDMA: long-term pins).
*/ */
long pin_user_pages(unsigned long start, unsigned long nr_pages, long pin_user_pages(unsigned long start, unsigned long nr_pages,

View File

@ -301,7 +301,7 @@ static unsigned long vgic_v3_uaccess_read_pending(struct kvm_vcpu *vcpu,
* pending state of interrupt is latched in pending_latch variable. * pending state of interrupt is latched in pending_latch variable.
* Userspace will save and restore pending state and line_level * Userspace will save and restore pending state and line_level
* separately. * separately.
* Refer to Documentation/virt/kvm/devices/arm-vgic-v3.txt * Refer to Documentation/virt/kvm/devices/arm-vgic-v3.rst
* for handling of ISPENDR and ICPENDR. * for handling of ISPENDR and ICPENDR.
*/ */
for (i = 0; i < len * 8; i++) { for (i = 0; i < len * 8; i++) {

View File

@ -42,7 +42,7 @@
VGIC_AFFINITY_LEVEL(val, 3)) VGIC_AFFINITY_LEVEL(val, 3))
/* /*
* As per Documentation/virt/kvm/devices/arm-vgic-v3.txt, * As per Documentation/virt/kvm/devices/arm-vgic-v3.rst,
* below macros are defined for CPUREG encoding. * below macros are defined for CPUREG encoding.
*/ */
#define KVM_REG_ARM_VGIC_SYSREG_OP0_MASK 0x000000000000c000 #define KVM_REG_ARM_VGIC_SYSREG_OP0_MASK 0x000000000000c000
@ -63,7 +63,7 @@
KVM_REG_ARM_VGIC_SYSREG_OP2_MASK) KVM_REG_ARM_VGIC_SYSREG_OP2_MASK)
/* /*
* As per Documentation/virt/kvm/devices/arm-vgic-its.txt, * As per Documentation/virt/kvm/devices/arm-vgic-its.rst,
* below macros are defined for ITS table entry encoding. * below macros are defined for ITS table entry encoding.
*/ */
#define KVM_ITS_CTE_VALID_SHIFT 63 #define KVM_ITS_CTE_VALID_SHIFT 63