Re: [PATCH] swapon: (man page) add details about fstab configuration

Nuno Silva <[email protected]> Tue, 12 Aug 2025 23:52:45 +0100
Newsgroups org.kernel.vger.util-linux
Message-ID <[email protected]>
On 2025-08-12, Karel Zak wrote:

> The fstab(5) man page already describes some basic aspects of "swap,"
> but it makes sense to be more specific in the swapon man page and
> describe everything in one place, serving as a normative reference for
> what is expected on Linux in fstab for swap.
>
> Fixes: https://github.com/util-linux/util-linux/issues/3667
> Signed-off-by: Karel Zak <[email protected]>
> ---
>  sys-utils/fstab.5.adoc  |  2 ++
>  sys-utils/swapon.8.adoc | 47 +++++++++++++++++++++++++++++++++++++++++
>  2 files changed, 49 insertions(+)
>
[...]
> diff --git a/sys-utils/swapon.8.adoc b/sys-utils/swapon.8.adoc
> index a25309d18..f4516c66a 100644
> --- a/sys-utils/swapon.8.adoc
> +++ b/sys-utils/swapon.8.adoc
> @@ -30,6 +30,7 @@ Calls to *swapon* normally occur in the system boot
> scripts making all swap devi
>  
>  *-a*, *--all*::
>  All devices marked as "swap" in _/etc/fstab_ are made available,
> except for those with the "noauto" option. Devices that are already
> being used as swap are silently skipped.
> +See *FSTAB CONFIGURATION* section for more details.

Should this be "See the *FSTAB CONFIGURATION* section [...]"?

At first sight, it sounds/looks better to me with that "the".

-- 
Nuno Silva