Linux Documentation
 help / color / mirror / Atom feed
* [PATCH] fix broken links in bpf, driver_api & filesystem documentation
@ 2026-05-05  1:48 Jeremy Bobbin
  2026-05-05  3:43 ` Randy Dunlap
                   ` (2 more replies)
  0 siblings, 3 replies; 5+ messages in thread
From: Jeremy Bobbin @ 2026-05-05  1:48 UTC (permalink / raw)
  To: corbet; +Cc: linux-doc, Jeremy Bobbin

bpf/linux-notes.rst: broken link to ISA standard documentation
driver-api/thermal/intel_dptf.rst: two broken links to filesystem quota

Signed-off-by: Jeremy Bobbin <jer@jer.cx>
---
 Documentation/bpf/linux-notes.rst               | 2 +-
 Documentation/driver-api/thermal/intel_dptf.rst | 2 +-
 Documentation/filesystems/ext4/super.rst        | 6 +++---
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/Documentation/bpf/linux-notes.rst b/Documentation/bpf/linux-notes.rst
index 00d2693de025..9c7b703ae4e5 100644
--- a/Documentation/bpf/linux-notes.rst
+++ b/Documentation/bpf/linux-notes.rst
@@ -46,7 +46,7 @@ Legacy BPF Packet access instructions
 =====================================
 
 As mentioned in the `ISA standard documentation
-<instruction-set.html#legacy-bpf-packet-access-instructions>`_,
+<standardization/instruction-set.html#legacy-bpf-packet-access-instructions>`_,
 Linux has special eBPF instructions for access to packet data that have been
 carried over from classic BPF to retain the performance of legacy socket
 filters running in the eBPF interpreter.
diff --git a/Documentation/driver-api/thermal/intel_dptf.rst b/Documentation/driver-api/thermal/intel_dptf.rst
index 4adfa1eb74db..1a4d7eedbb68 100644
--- a/Documentation/driver-api/thermal/intel_dptf.rst
+++ b/Documentation/driver-api/thermal/intel_dptf.rst
@@ -81,7 +81,7 @@ DPTF ACPI Drivers interface
 
 ``data_vault`` (RO)
 	Binary thermal table. Refer to
-	https:/github.com/intel/thermal_daemon for decoding
+	https://github.com/intel/thermal_daemon for decoding
 	thermal table.
 
 ``production_mode`` (RO)
diff --git a/Documentation/filesystems/ext4/super.rst b/Documentation/filesystems/ext4/super.rst
index 9a59cded9bd7..d06e4ae96d16 100644
--- a/Documentation/filesystems/ext4/super.rst
+++ b/Documentation/filesystems/ext4/super.rst
@@ -408,11 +408,11 @@ The ext4 superblock is laid out as follows in
    * - 0x240
      - __le32
      - s_usr_quota_inum
-     - Inode number of user `quota <quota>`__ file.
+     - Inode number of user `quota </filesystems/quota.html>`__ file.
    * - 0x244
      - __le32
      - s_grp_quota_inum
-     - Inode number of group `quota <quota>`__ file.
+     - Inode number of group `quota </filesystems/quota.html>`__ file.
    * - 0x248
      - __le32
      - s_overhead_blocks
@@ -712,7 +712,7 @@ the following:
    * - 0x80
      - This filesystem has a snapshot (RO_COMPAT_HAS_SNAPSHOT).
    * - 0x100
-     - `Quota <Quota>`__ (RO_COMPAT_QUOTA).
+     - `Quota </filesystems/quota.html>`__ (RO_COMPAT_QUOTA).
    * - 0x200
      - This filesystem supports “bigalloc”, which means that file extents are
        tracked in units of clusters (of blocks) instead of blocks
-- 
2.53.0


^ permalink raw reply related	[flat|nested] 5+ messages in thread

* Re: [PATCH] fix broken links in bpf, driver_api & filesystem documentation
  2026-05-05  1:48 [PATCH] fix broken links in bpf, driver_api & filesystem documentation Jeremy Bobbin
@ 2026-05-05  3:43 ` Randy Dunlap
  2026-05-05  3:48 ` Randy Dunlap
  2026-05-05  5:23 ` Bagas Sanjaya
  2 siblings, 0 replies; 5+ messages in thread
From: Randy Dunlap @ 2026-05-05  3:43 UTC (permalink / raw)
  To: Jeremy Bobbin, corbet; +Cc: linux-doc



On 5/4/26 6:48 PM, Jeremy Bobbin wrote:
> bpf/linux-notes.rst: broken link to ISA standard documentation
> driver-api/thermal/intel_dptf.rst: two broken links to filesystem quota

Somehow the line above merged changes for ext4/super.rst into the
comment for intel_dptf.rst.

> 
> Signed-off-by: Jeremy Bobbin <jer@jer.cx>
> ---
>  Documentation/bpf/linux-notes.rst               | 2 +-
>  Documentation/driver-api/thermal/intel_dptf.rst | 2 +-
>  Documentation/filesystems/ext4/super.rst        | 6 +++---
>  3 files changed, 5 insertions(+), 5 deletions(-)
> 
> diff --git a/Documentation/bpf/linux-notes.rst b/Documentation/bpf/linux-notes.rst
> index 00d2693de025..9c7b703ae4e5 100644
> --- a/Documentation/bpf/linux-notes.rst
> +++ b/Documentation/bpf/linux-notes.rst
> @@ -46,7 +46,7 @@ Legacy BPF Packet access instructions
>  =====================================
>  
>  As mentioned in the `ISA standard documentation
> -<instruction-set.html#legacy-bpf-packet-access-instructions>`_,
> +<standardization/instruction-set.html#legacy-bpf-packet-access-instructions>`_,
>  Linux has special eBPF instructions for access to packet data that have been
>  carried over from classic BPF to retain the performance of legacy socket
>  filters running in the eBPF interpreter.
> diff --git a/Documentation/driver-api/thermal/intel_dptf.rst b/Documentation/driver-api/thermal/intel_dptf.rst
> index 4adfa1eb74db..1a4d7eedbb68 100644
> --- a/Documentation/driver-api/thermal/intel_dptf.rst
> +++ b/Documentation/driver-api/thermal/intel_dptf.rst
> @@ -81,7 +81,7 @@ DPTF ACPI Drivers interface
>  
>  ``data_vault`` (RO)
>  	Binary thermal table. Refer to
> -	https:/github.com/intel/thermal_daemon for decoding
> +	https://github.com/intel/thermal_daemon for decoding
>  	thermal table.
>  
>  ``production_mode`` (RO)
> diff --git a/Documentation/filesystems/ext4/super.rst b/Documentation/filesystems/ext4/super.rst
> index 9a59cded9bd7..d06e4ae96d16 100644
> --- a/Documentation/filesystems/ext4/super.rst
> +++ b/Documentation/filesystems/ext4/super.rst
> @@ -408,11 +408,11 @@ The ext4 superblock is laid out as follows in
>     * - 0x240
>       - __le32
>       - s_usr_quota_inum
> -     - Inode number of user `quota <quota>`__ file.
> +     - Inode number of user `quota </filesystems/quota.html>`__ file.
>     * - 0x244
>       - __le32
>       - s_grp_quota_inum
> -     - Inode number of group `quota <quota>`__ file.
> +     - Inode number of group `quota </filesystems/quota.html>`__ file.
>     * - 0x248
>       - __le32
>       - s_overhead_blocks
> @@ -712,7 +712,7 @@ the following:
>     * - 0x80
>       - This filesystem has a snapshot (RO_COMPAT_HAS_SNAPSHOT).
>     * - 0x100
> -     - `Quota <Quota>`__ (RO_COMPAT_QUOTA).
> +     - `Quota </filesystems/quota.html>`__ (RO_COMPAT_QUOTA).
>     * - 0x200
>       - This filesystem supports “bigalloc”, which means that file extents are
>         tracked in units of clusters (of blocks) instead of blocks

-- 
~Randy


^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: [PATCH] fix broken links in bpf, driver_api & filesystem documentation
  2026-05-05  1:48 [PATCH] fix broken links in bpf, driver_api & filesystem documentation Jeremy Bobbin
  2026-05-05  3:43 ` Randy Dunlap
@ 2026-05-05  3:48 ` Randy Dunlap
  2026-05-05  5:23 ` Bagas Sanjaya
  2 siblings, 0 replies; 5+ messages in thread
From: Randy Dunlap @ 2026-05-05  3:48 UTC (permalink / raw)
  To: Jeremy Bobbin, corbet; +Cc: linux-doc



On 5/4/26 6:48 PM, Jeremy Bobbin wrote:
> bpf/linux-notes.rst: broken link to ISA standard documentation
> driver-api/thermal/intel_dptf.rst: two broken links to filesystem quota
> 
> Signed-off-by: Jeremy Bobbin <jer@jer.cx>
> ---
>  Documentation/bpf/linux-notes.rst               | 2 +-
>  Documentation/driver-api/thermal/intel_dptf.rst | 2 +-
>  Documentation/filesystems/ext4/super.rst        | 6 +++---
>  3 files changed, 5 insertions(+), 5 deletions(-)
> 
> diff --git a/Documentation/bpf/linux-notes.rst b/Documentation/bpf/linux-notes.rst
> index 00d2693de025..9c7b703ae4e5 100644
> --- a/Documentation/bpf/linux-notes.rst
> +++ b/Documentation/bpf/linux-notes.rst
> @@ -46,7 +46,7 @@ Legacy BPF Packet access instructions
>  =====================================
>  
>  As mentioned in the `ISA standard documentation
> -<instruction-set.html#legacy-bpf-packet-access-instructions>`_,
> +<standardization/instruction-set.html#legacy-bpf-packet-access-instructions>`_,
>  Linux has special eBPF instructions for access to packet data that have been
>  carried over from classic BPF to retain the performance of legacy socket
>  filters running in the eBPF interpreter.
> diff --git a/Documentation/driver-api/thermal/intel_dptf.rst b/Documentation/driver-api/thermal/intel_dptf.rst
> index 4adfa1eb74db..1a4d7eedbb68 100644
> --- a/Documentation/driver-api/thermal/intel_dptf.rst
> +++ b/Documentation/driver-api/thermal/intel_dptf.rst
> @@ -81,7 +81,7 @@ DPTF ACPI Drivers interface
>  
>  ``data_vault`` (RO)
>  	Binary thermal table. Refer to
> -	https:/github.com/intel/thermal_daemon for decoding
> +	https://github.com/intel/thermal_daemon for decoding
>  	thermal table.
>  
>  ``production_mode`` (RO)
> diff --git a/Documentation/filesystems/ext4/super.rst b/Documentation/filesystems/ext4/super.rst
> index 9a59cded9bd7..d06e4ae96d16 100644
> --- a/Documentation/filesystems/ext4/super.rst
> +++ b/Documentation/filesystems/ext4/super.rst
> @@ -408,11 +408,11 @@ The ext4 superblock is laid out as follows in
>     * - 0x240
>       - __le32
>       - s_usr_quota_inum
> -     - Inode number of user `quota <quota>`__ file.
> +     - Inode number of user `quota </filesystems/quota.html>`__ file.
>     * - 0x244
>       - __le32
>       - s_grp_quota_inum
> -     - Inode number of group `quota <quota>`__ file.
> +     - Inode number of group `quota </filesystems/quota.html>`__ file.
>     * - 0x248
>       - __le32
>       - s_overhead_blocks
> @@ -712,7 +712,7 @@ the following:
>     * - 0x80
>       - This filesystem has a snapshot (RO_COMPAT_HAS_SNAPSHOT).
>     * - 0x100
> -     - `Quota <Quota>`__ (RO_COMPAT_QUOTA).
> +     - `Quota </filesystems/quota.html>`__ (RO_COMPAT_QUOTA).
>     * - 0x200
>       - This filesystem supports “bigalloc”, which means that file extents are
>         tracked in units of clusters (of blocks) instead of blocks

These ext4 link changes don't work for me (file not found).

-- 
~Randy


^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: [PATCH] fix broken links in bpf, driver_api & filesystem documentation
  2026-05-05  1:48 [PATCH] fix broken links in bpf, driver_api & filesystem documentation Jeremy Bobbin
  2026-05-05  3:43 ` Randy Dunlap
  2026-05-05  3:48 ` Randy Dunlap
@ 2026-05-05  5:23 ` Bagas Sanjaya
  2026-05-05  5:56   ` Randy Dunlap
  2 siblings, 1 reply; 5+ messages in thread
From: Bagas Sanjaya @ 2026-05-05  5:23 UTC (permalink / raw)
  To: Jeremy Bobbin, corbet; +Cc: linux-doc

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

On Mon, May 04, 2026 at 06:48:38PM -0700, Jeremy Bobbin wrote:
> @@ -712,7 +712,7 @@ the following:
>     * - 0x80
>       - This filesystem has a snapshot (RO_COMPAT_HAS_SNAPSHOT).
>     * - 0x100
> -     - `Quota <Quota>`__ (RO_COMPAT_QUOTA).
> +     - `Quota </filesystems/quota.html>`__ (RO_COMPAT_QUOTA).

Maybe :doc:`Quota </filesystems/quota>`?

Thanks.

-- 
An old man doll... just what I always wanted! - Clara

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: [PATCH] fix broken links in bpf, driver_api & filesystem documentation
  2026-05-05  5:23 ` Bagas Sanjaya
@ 2026-05-05  5:56   ` Randy Dunlap
  0 siblings, 0 replies; 5+ messages in thread
From: Randy Dunlap @ 2026-05-05  5:56 UTC (permalink / raw)
  To: Bagas Sanjaya, Jeremy Bobbin, corbet; +Cc: linux-doc



On 5/4/26 10:23 PM, Bagas Sanjaya wrote:
> On Mon, May 04, 2026 at 06:48:38PM -0700, Jeremy Bobbin wrote:
>> @@ -712,7 +712,7 @@ the following:
>>     * - 0x80
>>       - This filesystem has a snapshot (RO_COMPAT_HAS_SNAPSHOT).
>>     * - 0x100
>> -     - `Quota <Quota>`__ (RO_COMPAT_QUOTA).
>> +     - `Quota </filesystems/quota.html>`__ (RO_COMPAT_QUOTA).
> 
> Maybe :doc:`Quota </filesystems/quota>`?
> 
> Thanks.

I just tried that - unsuccessfully. (Maybe because this is in
a table?)

What works for me is this: (FWIW)

--- linux-next-20260504.orig/Documentation/filesystems/ext4/super.rst
+++ linux-next-20260504/Documentation/filesystems/ext4/super.rst
@@ -408,11 +408,11 @@ The ext4 superblock is laid out as follo
    * - 0x240
      - __le32
      - s_usr_quota_inum
-     - Inode number of user `quota <quota>`__ file.
+     - Inode number of user `quota <../quota.html>`__ file.
    * - 0x244
      - __le32
      - s_grp_quota_inum
-     - Inode number of group `quota <quota>`__ file.
+     - Inode number of group `quota <../quota.html>`__ file.
    * - 0x248
      - __le32
      - s_overhead_blocks
@@ -712,7 +712,7 @@ the following:
    * - 0x80
      - This filesystem has a snapshot (RO_COMPAT_HAS_SNAPSHOT).
    * - 0x100
-     - `Quota <Quota>`__ (RO_COMPAT_QUOTA).
+     - `Quota <../quota.html>`__ (RO_COMPAT_QUOTA).
    * - 0x200
      - This filesystem supports “bigalloc”, which means that file extents are
        tracked in units of clusters (of blocks) instead of blocks



-- 
~Randy


^ permalink raw reply	[flat|nested] 5+ messages in thread

end of thread, other threads:[~2026-05-05  5:56 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-05-05  1:48 [PATCH] fix broken links in bpf, driver_api & filesystem documentation Jeremy Bobbin
2026-05-05  3:43 ` Randy Dunlap
2026-05-05  3:48 ` Randy Dunlap
2026-05-05  5:23 ` Bagas Sanjaya
2026-05-05  5:56   ` Randy Dunlap

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox