From nobody Mon Feb 9 09:35:37 2026 Received: from bali.collaboradmins.com (bali.collaboradmins.com [148.251.105.195]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id DA03C282EE; Fri, 4 Apr 2025 15:38:05 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=148.251.105.195 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1743781090; cv=none; b=iKqITIsbxioyHzx6Py2vXb+8KnMWfzNEF06BSGkPhhvlbBhGp0LAadqJxzNeJN5NU3NuQfkyDetNe2XirELwgKWBOXQftrZFiUaM9p84xpC0z6Z19WvEr5Ao5Lfxx30Vn82CHW+8aEih18vdsJpcK1zLiJ7q306JlqgDCUojqns= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1743781090; c=relaxed/simple; bh=gbIykWe4fzepIDe0YwQ2VSk/51H1RW4tv6OJdF3JyuM=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:To:Cc; b=Pza9F7x5Fmj1T80tcdoWcIUTMIANdQzTwizOsikUYiPIbTzbEZ3YBOXpJlk/T+TnqDewBVnW+RPtqMxwjWWZwbOLf6TS1WbiPT3Sp9ZreaT0wBYcdA47Byms3FgKyAyvLFZlo1YoV4vboZyUCHlNIKs/4qVirrKB5iJJMrDsaQY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=collabora.com; spf=pass smtp.mailfrom=collabora.com; dkim=pass (2048-bit key) header.d=collabora.com header.i=@collabora.com header.b=fPBNzaEr; arc=none smtp.client-ip=148.251.105.195 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=collabora.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=collabora.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=collabora.com header.i=@collabora.com header.b="fPBNzaEr" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=collabora.com; s=mail; t=1743781083; bh=gbIykWe4fzepIDe0YwQ2VSk/51H1RW4tv6OJdF3JyuM=; h=From:Date:Subject:To:Cc:From; b=fPBNzaErOsuYBXdwp9N98h51jPNfvKrSh891Aqs8kAir2IMzIILnEKUz2R4yBoNoF T3sjO3aD17LC3OTy6i7w+wEwP49PptoKKjq3oiicymZZAC/phtg4izrXv1SMgfxRVK or5JRG9Fq7oz38nCatTHH1TMjPVMcTAkXP0moRqSBlKknfbicBTUZ57Wsbu7QtxFsT W7KVJP56xmS2c+pvFp6T9YU2ZmDOczI9VeD5uPR9K588+uhReIdPHbEdHPtff11+aS KuzljhPraUTrsc7uxd84E541EtwnQXFCf/5SoxYNRpvEPltsaxIlddd21b0FN7x7xS Chdu8fN0uFFug== Received: from [192.168.1.63] (unknown [70.107.117.78]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: nfraprado) by bali.collaboradmins.com (Postfix) with ESMTPSA id 6D87017E00AC; Fri, 4 Apr 2025 17:37:57 +0200 (CEST) From: =?utf-8?q?N=C3=ADcolas_F=2E_R=2E_A=2E_Prado?= Date: Fri, 04 Apr 2025 11:37:28 -0400 Subject: [PATCH] docs: Remove literal markup from Documentation/ paths Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250404-doc-paths-unliteral-v1-1-74718785444e@collabora.com> X-B4-Tracking: v=1; b=H4sIALf872cC/x3MQQqAIBBA0avErBsws0VdJVpoM+VAWGhFEN49a fkW/7+QOAonGKoXIt+SZA8FTV3B7G1YGYWKQSvdKaMM0j7jYU+f8AqbnBzthq4n7ahprXEEpTw iL/L813HK+QOZ/yl4ZQAAAA== X-Change-ID: 20250404-doc-paths-unliteral-b9d2bd13a4bd To: Andrew Morton , Jonathan Corbet , Vinod Koul , Eric Biggers , "Theodore Y. Ts'o" , Jaegeuk Kim , Jonathan Cameron , Lars-Peter Clausen , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Maxime Chevallier , James Bottomley , Jarkko Sakkinen , Mimi Zohar , Jaroslav Kysela , Takashi Iwai , Mauro Carvalho Chehab , Richard Weinberger , Anton Ivanov , Johannes Berg Cc: kernel@collabora.com, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, dmaengine@vger.kernel.org, linux-fscrypt@vger.kernel.org, linux-iio@vger.kernel.org, netdev@vger.kernel.org, workflows@vger.kernel.org, linux-integrity@vger.kernel.org, keyrings@vger.kernel.org, linux-sound@vger.kernel.org, linux-media@vger.kernel.org, linux-um@lists.infradead.org, =?utf-8?q?N=C3=ADcolas_F=2E_R=2E_A=2E_Prado?= X-Mailer: b4 0.14.2 Given that the automarkup Sphinx plugin cross-references "Documentation/*.rst" strings in the text to the corresponding documents, surrounding those strings with the literal markup (``) not only adds unnecessary markup in the source files, but actually prevents the automatic cross-referencing to happen (as it doesn't happen in literal blocks). Remove all the occurrences of the literal markup in "Documentation/*.rst" paths, except when the actual source file is being referred. Also change the surrounding text when needed so it reads well both in the source and the web page (eg. 'see file Doc...' -> 'see Doc...'). Signed-off-by: N=C3=ADcolas F. R. A. Prado Acked-by: Jonathan Cameron Acked-by: SeongJae Park --- Documentation/admin-guide/mm/numa_memory_policy.rst | 2 +- Documentation/admin-guide/serial-console.rst | 2 +- Documentation/driver-api/dmaengine/client.rst | 2 +- Documentation/driver-api/nvdimm/security.rst | 2 +- Documentation/filesystems/fscrypt.rst | 4 ++-- Documentation/iio/adis16475.rst | 4 ++-- Documentation/iio/adis16480.rst | 4 ++-- Documentation/iio/adis16550.rst | 4 ++-- Documentation/iio/adxl380.rst | 4 ++-- Documentation/kernel-hacking/hacking.rst | 6 +++--- Documentation/kernel-hacking/locking.rst | 2 +- Documentation/networking/dsa/b53.rst | 2 +- Documentation/networking/dsa/bcm_sf2.rst | 2 +- Documentation/networking/dsa/dsa.rst | 2 +- Documentation/networking/dsa/lan9303.rst | 2 +- Documentation/networking/phy-link-topology.rst | 2 +- Documentation/process/adding-syscalls.rst | 2 +- Documentation/process/submit-checklist.rst | 7 ++++--- Documentation/security/keys/trusted-encrypted.rst | 4 ++-- Documentation/sound/kernel-api/writing-an-alsa-driver.rst | 2 +- Documentation/userspace-api/media/v4l/dev-sliced-vbi.rst | 2 +- Documentation/userspace-api/media/v4l/diff-v4l.rst | 2 +- Documentation/userspace-api/media/v4l/ext-ctrls-codec.rst | 4 ++-- Documentation/virt/uml/user_mode_linux_howto_v2.rst | 2 +- 24 files changed, 36 insertions(+), 35 deletions(-) diff --git a/Documentation/admin-guide/mm/numa_memory_policy.rst b/Document= ation/admin-guide/mm/numa_memory_policy.rst index a70f20ce1ffb4ffd0cdcb8e575dce5547c76e73a..e431a93c82a6ac0be1ea2504c72= 7565293f3be77 100644 --- a/Documentation/admin-guide/mm/numa_memory_policy.rst +++ b/Documentation/admin-guide/mm/numa_memory_policy.rst @@ -13,7 +13,7 @@ document attempts to describe the concepts and APIs of th= e 2.6 memory policy support. =20 Memory policies should not be confused with cpusets -(``Documentation/admin-guide/cgroup-v1/cpusets.rst``) +(Documentation/admin-guide/cgroup-v1/cpusets.rst) which is an administrative mechanism for restricting the nodes from which memory may be allocated by a set of processes. Memory policies are a programming interface that a NUMA-aware application can take advantage of.= When diff --git a/Documentation/admin-guide/serial-console.rst b/Documentation/a= dmin-guide/serial-console.rst index 1609e7479249f0721fd0b4fbbd70eda13ffc09e4..70c067aad724e08fc11457b9a79= 2da965809f116 100644 --- a/Documentation/admin-guide/serial-console.rst +++ b/Documentation/admin-guide/serial-console.rst @@ -86,7 +86,7 @@ You will need to create a new device to use ``/dev/consol= e``. The official ``/dev/console`` is now character device 5,1. =20 (You can also use a network device as a console. See -``Documentation/networking/netconsole.rst`` for information on that.) +Documentation/networking/netconsole.rst for information on that.) =20 Here's an example that will use ``/dev/ttyS1`` (COM2) as the console. Replace the sample values as needed. diff --git a/Documentation/driver-api/dmaengine/client.rst b/Documentation/= driver-api/dmaengine/client.rst index d491e385d61a98b8a804cd823caf254a2dc62cf4..884b96bdf90081ad17a315b1513= 2a7e5ada07e37 100644 --- a/Documentation/driver-api/dmaengine/client.rst +++ b/Documentation/driver-api/dmaengine/client.rst @@ -5,7 +5,7 @@ DMA Engine API Guide Vinod Koul =20 .. note:: For DMA Engine usage in async_tx please see: - ``Documentation/crypto/async-tx-api.rst`` + Documentation/crypto/async-tx-api.rst =20 =20 Below is a guide to device driver writers on how to use the Slave-DMA API = of the diff --git a/Documentation/driver-api/nvdimm/security.rst b/Documentation/d= river-api/nvdimm/security.rst index eb3d35e6a95c9faf683fd9591d0ea10a1264ec49..6bb732d08fc698b1c3d37263e78= ad194081d46f2 100644 --- a/Documentation/driver-api/nvdimm/security.rst +++ b/Documentation/driver-api/nvdimm/security.rst @@ -51,7 +51,7 @@ all the keys are in the kernel user keyring for unlock. A nvdimm encrypted-key of format enc32 has the description format of: nvdimm: =20 -See file ``Documentation/security/keys/trusted-encrypted.rst`` for creating +See Documentation/security/keys/trusted-encrypted.rst for creating encrypted-keys of enc32 format. TPM usage with a master trusted key is preferred for sealing the encrypted-keys. =20 diff --git a/Documentation/filesystems/fscrypt.rst b/Documentation/filesyst= ems/fscrypt.rst index e803299085492217f946fafd79f2bbaf85a7f974..7aae828ae9040586bbd0bde0093= 86855c11e1645 100644 --- a/Documentation/filesystems/fscrypt.rst +++ b/Documentation/filesystems/fscrypt.rst @@ -873,7 +873,7 @@ as follows: hash of the key. To add this type of key, the calling process does not need any privileges. However, the number of keys that can be added is limited by the user's quota for the keyrings service (see - ``Documentation/security/keys/core.rst``). + Documentation/security/keys/core.rst). =20 - ``raw_size`` must be the size of the ``raw`` key provided, in bytes. Alternatively, if ``key_id`` is nonzero, this field must be 0, since @@ -955,7 +955,7 @@ access encrypted files. =20 Nevertheless, to add a key to one of the process-subscribed keyrings, the add_key() system call can be used (see: -``Documentation/security/keys/core.rst``). The key type must be +Documentation/security/keys/core.rst). The key type must be "logon"; keys of this type are kept in kernel memory and cannot be read back by userspace. The key description must be "fscrypt:" followed by the 16-character lower case hex representation of the diff --git a/Documentation/iio/adis16475.rst b/Documentation/iio/adis16475.= rst index 4bf0998be36efced97ecb93372df84790351e36b..89a388490ab735f6f4bc1c4dda1= 0a87881ae82aa 100644 --- a/Documentation/iio/adis16475.rst +++ b/Documentation/iio/adis16475.rst @@ -374,11 +374,11 @@ Obtain buffered data: 00001740 01 1a 00 00 ff ff fe 31 00 00 46 aa 00 03 37 f7 |.....= ..1..F...7.| ... =20 -See ``Documentation/iio/iio_devbuf.rst`` for more information about how bu= ffered +See Documentation/iio/iio_devbuf.rst for more information about how buffer= ed data is structured. =20 4. IIO Interfacing Tools =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -See ``Documentation/iio/iio_tools.rst`` for the description of the availab= le IIO +See Documentation/iio/iio_tools.rst for the description of the available I= IO interfacing tools. diff --git a/Documentation/iio/adis16480.rst b/Documentation/iio/adis16480.= rst index 4a2d40e0daa7989dd9dc7c1991de24ac6184fb0c..cce5f3e0174158cf20f12e96bff= 5c79bced84aab 100644 --- a/Documentation/iio/adis16480.rst +++ b/Documentation/iio/adis16480.rst @@ -436,11 +436,11 @@ Obtain buffered data:: 00006b60 09 63 00 00 00 00 1b 13 00 00 22 2f 00 03 23 91 |.c........"= /..#.| ... =20 -See ``Documentation/iio/iio_devbuf.rst`` for more information about how bu= ffered +See Documentation/iio/iio_devbuf.rst for more information about how buffer= ed data is structured. =20 4. IIO Interfacing Tools =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -See ``Documentation/iio/iio_tools.rst`` for the description of the availab= le IIO +See Documentation/iio/iio_tools.rst for the description of the available I= IO interfacing tools. diff --git a/Documentation/iio/adis16550.rst b/Documentation/iio/adis16550.= rst index 25db7b8060c42153f9acbc1b5dd689c79f8da70b..c9bbc0a857b03bc1894e3fbba79= 2bba705966636 100644 --- a/Documentation/iio/adis16550.rst +++ b/Documentation/iio/adis16550.rst @@ -366,11 +366,11 @@ Obtain buffered data: 0000ceb0 00 00 0d 2f 00 00 05 25 00 00 07 8d 00 00 a2 ce |.../.= ..%........| ... =20 -See ``Documentation/iio/iio_devbuf.rst`` for more information about how bu= ffered +See Documentation/iio/iio_devbuf.rst for more information about how buffer= ed data is structured. =20 4. IIO Interfacing Tools =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -See ``Documentation/iio/iio_tools.rst`` for the description of the availab= le IIO +See Documentation/iio/iio_tools.rst for the description of the available I= IO interfacing tools. diff --git a/Documentation/iio/adxl380.rst b/Documentation/iio/adxl380.rst index 66c8a4d4f767e5a6faa20b1c0fad57b954624a95..61cafa2f98bf36e4c1b035fc4ff= d73fab6b2058d 100644 --- a/Documentation/iio/adxl380.rst +++ b/Documentation/iio/adxl380.rst @@ -223,11 +223,11 @@ Obtain buffered data: 002bc3c0 f7 fd 00 cb fb 94 24 80 f7 e3 00 f2 fb b8 24 80 |.....= .$.......$.| ... =20 -See ``Documentation/iio/iio_devbuf.rst`` for more information about how bu= ffered +See Documentation/iio/iio_devbuf.rst for more information about how buffer= ed data is structured. =20 4. IIO Interfacing Tools =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -See ``Documentation/iio/iio_tools.rst`` for the description of the availab= le IIO +See Documentation/iio/iio_tools.rst for the description of the available I= IO interfacing tools. diff --git a/Documentation/kernel-hacking/hacking.rst b/Documentation/kerne= l-hacking/hacking.rst index 0042776a9e17cfc5d09b5de043cd4131b54192a9..53cf502ccf3706b15b7c1da177c= c28d6decee2b3 100644 --- a/Documentation/kernel-hacking/hacking.rst +++ b/Documentation/kernel-hacking/hacking.rst @@ -736,7 +736,7 @@ make a neat patch, there's administrative work to be do= ne: - Usually you want a configuration option for your kernel hack. Edit ``Kconfig`` in the appropriate directory. The Config language is simple to use by cut and paste, and there's complete documentation in - ``Documentation/kbuild/kconfig-language.rst``. + Documentation/kbuild/kconfig-language.rst. =20 In your description of the option, make sure you address both the expert user and the user who knows nothing about your feature. @@ -746,7 +746,7 @@ make a neat patch, there's administrative work to be do= ne: =20 - Edit the ``Makefile``: the CONFIG variables are exported here so you can usually just add a "obj-$(CONFIG_xxx) +=3D xxx.o" line. The syntax - is documented in ``Documentation/kbuild/makefiles.rst``. + is documented in Documentation/kbuild/makefiles.rst. =20 - Put yourself in ``CREDITS`` if you consider what you've done noteworthy, usually beyond a single file (your name should be at the @@ -755,7 +755,7 @@ make a neat patch, there's administrative work to be do= ne: it implies a more-than-passing commitment to some part of the code. =20 - Finally, don't forget to read - ``Documentation/process/submitting-patches.rst`` + Documentation/process/submitting-patches.rst =20 Kernel Cantrips =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/kernel-hacking/locking.rst b/Documentation/kerne= l-hacking/locking.rst index dff0646a717bff27f6b82d3a8090876e99d23cec..d479c2459895cd8cd5df5b2c918= 0aafb19f8b7fb 100644 --- a/Documentation/kernel-hacking/locking.rst +++ b/Documentation/kernel-hacking/locking.rst @@ -1370,7 +1370,7 @@ Futex API reference Further reading =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -- ``Documentation/locking/spinlocks.rst``: Linus Torvalds' spinlocking +- Documentation/locking/spinlocks.rst: Linus Torvalds' spinlocking tutorial in the kernel sources. =20 - Unix Systems for Modern Architectures: Symmetric Multiprocessing and diff --git a/Documentation/networking/dsa/b53.rst b/Documentation/networkin= g/dsa/b53.rst index 1cb3ff648f8890ea1063789672f19a1fea9f01e5..51fd39ca52019c84ab558332138= e94f34aa3c293 100644 --- a/Documentation/networking/dsa/b53.rst +++ b/Documentation/networking/dsa/b53.rst @@ -14,7 +14,7 @@ Implementation details =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 The driver is located in ``drivers/net/dsa/b53/`` and is implemented as a -DSA driver; see ``Documentation/networking/dsa/dsa.rst`` for details on the +DSA driver; see Documentation/networking/dsa/dsa.rst for details on the subsystem and what it provides. =20 The switch is, if possible, configured to enable a Broadcom specific 4-byt= es diff --git a/Documentation/networking/dsa/bcm_sf2.rst b/Documentation/netwo= rking/dsa/bcm_sf2.rst index d2571435696f6b777fa682660b9e5310bad765c1..ba7371aad142408a9d95644c478= 13cba968affc2 100644 --- a/Documentation/networking/dsa/bcm_sf2.rst +++ b/Documentation/networking/dsa/bcm_sf2.rst @@ -39,7 +39,7 @@ Implementation details =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 The driver is located in ``drivers/net/dsa/bcm_sf2.c`` and is implemented = as a DSA -driver; see ``Documentation/networking/dsa/dsa.rst`` for details on the su= bsystem +driver; see Documentation/networking/dsa/dsa.rst for details on the subsys= tem and what it provides. =20 The SF2 switch is configured to enable a Broadcom specific 4-bytes switch = tag diff --git a/Documentation/networking/dsa/dsa.rst b/Documentation/networkin= g/dsa/dsa.rst index 7b2e69cd7ef0b92f1da4666581c03d07928e6e1b..6e185a08396b91ea8bbfeec3130= 2527555df0cfd 100644 --- a/Documentation/networking/dsa/dsa.rst +++ b/Documentation/networking/dsa/dsa.rst @@ -1110,7 +1110,7 @@ interface with a physical switch port does not produc= e the expected result). =20 A driver which is able of offloading certain functions of a DANP or DANH s= hould declare the corresponding netdev features as indicated by the documentatio= n at -``Documentation/networking/netdev-features.rst``. Additionally, the follow= ing +Documentation/networking/netdev-features.rst. Additionally, the following methods must be implemented: =20 - ``port_hsr_join``: function invoked when a given switch port is added to= a diff --git a/Documentation/networking/dsa/lan9303.rst b/Documentation/netwo= rking/dsa/lan9303.rst index ab81b4e0139e340e7025c7b1e1fb0ddd65b232ff..97456316a8d9ec42ef7eb347736= d6a9e0de08869 100644 --- a/Documentation/networking/dsa/lan9303.rst +++ b/Documentation/networking/dsa/lan9303.rst @@ -10,7 +10,7 @@ host conduit network interface (e.g. fixed link). Driver details =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -The driver is implemented as a DSA driver, see ``Documentation/networking/= dsa/dsa.rst``. +The driver is implemented as a DSA driver, see Documentation/networking/ds= a/dsa.rst. =20 See ``Documentation/devicetree/bindings/net/dsa/lan9303.txt`` for device t= ree binding. diff --git a/Documentation/networking/phy-link-topology.rst b/Documentation= /networking/phy-link-topology.rst index 4dec5d7d6513d9946ccdabd6733228aa61ff1ea1..ff01d70ef61b42909ec4b3ab673= 0a08c4b271505 100644 --- a/Documentation/networking/phy-link-topology.rst +++ b/Documentation/networking/phy-link-topology.rst @@ -98,7 +98,7 @@ UAPI =3D=3D=3D=3D =20 There exist a set of netlink commands to query the link topology from user= space, -see ``Documentation/networking/ethtool-netlink.rst``. +see Documentation/networking/ethtool-netlink.rst. =20 The whole point of having a topology representation is to assign the phyin= dex field in :c:type:`struct phy_device `. This index is reported = to diff --git a/Documentation/process/adding-syscalls.rst b/Documentation/proc= ess/adding-syscalls.rst index 906c47f1a9e5086a1c5f451b1d8bebe19b0c6ff0..5e6d26ef31eb937f43e74e9193d= becb8bfa5ae14 100644 --- a/Documentation/process/adding-syscalls.rst +++ b/Documentation/process/adding-syscalls.rst @@ -33,7 +33,7 @@ interface. to a somewhat opaque API. =20 - If you're just exposing runtime system information, a new node in sysfs - (see ``Documentation/filesystems/sysfs.rst``) or the ``/proc`` filesyst= em may + (see Documentation/filesystems/sysfs.rst) or the ``/proc`` filesystem m= ay be more appropriate. However, access to these mechanisms requires that= the relevant filesystem is mounted, which might not always be the case (e.g. in a namespaced/sandboxed/chrooted environment). Avoid adding any API = to diff --git a/Documentation/process/submit-checklist.rst b/Documentation/pro= cess/submit-checklist.rst index beb7f94279fdb6a1d9b4aa86b2bea031f140732b..3ae31c5af2cb5c374658c1fb712= 5e70bf36e911c 100644 --- a/Documentation/process/submit-checklist.rst +++ b/Documentation/process/submit-checklist.rst @@ -30,7 +30,8 @@ Review Kconfig changes =20 1) Any new or modified ``CONFIG`` options do not muck up the config menu a= nd default to off unless they meet the exception criteria documented in - ``Documentation/kbuild/kconfig-language.rst`` Menu attributes: default = value. + Documentation/kbuild/kconfig-language.rst, under "Menu attributes", "de= fault + value". =20 2) All new ``Kconfig`` options have help text. =20 @@ -47,7 +48,7 @@ Provide documentation 2) All new ``/proc`` entries are documented under ``Documentation/`` =20 3) All new kernel boot parameters are documented in - ``Documentation/admin-guide/kernel-parameters.rst``. + Documentation/admin-guide/kernel-parameters.rst. =20 4) All new module parameters are documented with ``MODULE_PARM_DESC()`` =20 @@ -58,7 +59,7 @@ Provide documentation linux-api@vger.kernel.org. =20 6) If any ioctl's are added by the patch, then also update - ``Documentation/userspace-api/ioctl/ioctl-number.rst``. + Documentation/userspace-api/ioctl/ioctl-number.rst. =20 Check your code with tools =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D diff --git a/Documentation/security/keys/trusted-encrypted.rst b/Documentat= ion/security/keys/trusted-encrypted.rst index f4d7e162d5e475bf01baafcd4dbbd9dfda9f5e6f..7eef16778ae4f43f6ee538ae431= 7f0c3d48c3c7f 100644 --- a/Documentation/security/keys/trusted-encrypted.rst +++ b/Documentation/security/keys/trusted-encrypted.rst @@ -107,7 +107,7 @@ safe. (2) TEE =20 TEEs have well-documented, standardized client interface and APIs= . For - more details refer to ``Documentation/driver-api/tee.rst``. + more details refer to Documentation/driver-api/tee.rst. =20 (3) CAAM =20 @@ -407,7 +407,7 @@ Other uses for trusted and encrypted keys, such as for = disk and file encryption are anticipated. In particular the new format 'ecryptfs' has been defined in order to use encrypted keys to mount an eCryptfs filesystem. More deta= ils about the usage can be found in the file -``Documentation/security/keys/ecryptfs.rst``. +Documentation/security/keys/ecryptfs.rst. =20 Another new format 'enc32' has been defined in order to support encrypted = keys with payload size of 32 bytes. This will initially be used for nvdimm secu= rity diff --git a/Documentation/sound/kernel-api/writing-an-alsa-driver.rst b/Do= cumentation/sound/kernel-api/writing-an-alsa-driver.rst index 895752cbcedd6b1202ff481cbae6f5001dd3d903..975e9dfb29009f481e7bae24328= 5d2a93a82f5dc 100644 --- a/Documentation/sound/kernel-api/writing-an-alsa-driver.rst +++ b/Documentation/sound/kernel-api/writing-an-alsa-driver.rst @@ -2466,7 +2466,7 @@ Mic boost Mic-boost switch is set as =E2=80=9CMic Boost=E2=80=9D or =E2=80=9CMic Boo= st (6dB)=E2=80=9D. =20 More precise information can be found in -``Documentation/sound/designs/control-names.rst``. +Documentation/sound/designs/control-names.rst. =20 Access Flags ------------ diff --git a/Documentation/userspace-api/media/v4l/dev-sliced-vbi.rst b/Doc= umentation/userspace-api/media/v4l/dev-sliced-vbi.rst index 42cdb0a9f786066a2d4b8ebc2c72a9318dabebf5..d7524b65a2fccc5ce16abcac7aa= e3ae0f9f461c7 100644 --- a/Documentation/userspace-api/media/v4l/dev-sliced-vbi.rst +++ b/Documentation/userspace-api/media/v4l/dev-sliced-vbi.rst @@ -430,7 +430,7 @@ MPEG stream. *Historical context*: This format specification originates from a custom, embedded, sliced VBI data format used by the ``ivtv`` driver. This format has already been informally specified in the kernel sources -in the file ``Documentation/userspace-api/media/drivers/cx2341x-uapi.rst``= . The +in Documentation/userspace-api/media/drivers/cx2341x-uapi.rst. The maximum size of the payload and other aspects of this format are driven by the CX23415 MPEG decoder's capabilities and limitations with respect to extracting, decoding, and displaying sliced VBI data embedded within diff --git a/Documentation/userspace-api/media/v4l/diff-v4l.rst b/Documenta= tion/userspace-api/media/v4l/diff-v4l.rst index 33243ecb50336abe845aa44232917134b21280f7..b087835a147fc0a2285992b8d2b= c9a56e83b1cb7 100644 --- a/Documentation/userspace-api/media/v4l/diff-v4l.rst +++ b/Documentation/userspace-api/media/v4l/diff-v4l.rst @@ -634,7 +634,7 @@ devices is documented in :ref:`extended-controls`. compatible with V4L or V4L2. =20 .. [#f2] - According to ``Documentation/admin-guide/devices.rst`` a symbolic link = to + According to Documentation/admin-guide/devices.rst a symbolic link to ``/dev/radio0``. =20 .. [#f3] diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-codec.rst b/Do= cumentation/userspace-api/media/v4l/ext-ctrls-codec.rst index 4a379bd9e3fbdb78dfda8e7bc4b25de079d61208..7b463d1ffc906a6b519cc7c2f2d= 6526c3e53eae5 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-codec.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-codec.rst @@ -108,8 +108,8 @@ enum v4l2_mpeg_stream_vbi_fmt - - No VBI in the MPEG stream * - ``V4L2_MPEG_STREAM_VBI_FMT_IVTV`` - VBI in private packets, IVTV format (documented in the kernel - sources in the file - ``Documentation/userspace-api/media/drivers/cx2341x-uapi.rst``) + sources in + Documentation/userspace-api/media/drivers/cx2341x-uapi.rst) =20 =20 =20 diff --git a/Documentation/virt/uml/user_mode_linux_howto_v2.rst b/Document= ation/virt/uml/user_mode_linux_howto_v2.rst index 584000b743f381747f7bced26d60f0d92b6c1fbe..71d1258a5002acb4716221351b6= 0579892862cca 100644 --- a/Documentation/virt/uml/user_mode_linux_howto_v2.rst +++ b/Documentation/virt/uml/user_mode_linux_howto_v2.rst @@ -1118,7 +1118,7 @@ new feature, please send it to ``linux-um@lists.infra= dead.org``. =20 Please follow all standard Linux patch guidelines such as cc-ing relevant maintainers and run ``./scripts/checkpatch.pl`` on your patch. -For more details see ``Documentation/process/submitting-patches.rst`` +For more details see Documentation/process/submitting-patches.rst =20 Note - the list does not accept HTML or attachments, all emails must be formatted as plain text. --- base-commit: 405e2241def89c88f008dcb899eb5b6d4be8b43c change-id: 20250404-doc-paths-unliteral-b9d2bd13a4bd Best regards, --=20 N=C3=ADcolas F. R. A. Prado