Re: [PATCH 3/3] man/man7/landlock.7: wfix

On Sat, 18 Jul 2026 14:17:57 +0200
Alejandro Colomar wrote:

> On 2026-07-13T13:48:55+0200, Štěpán Němec wrote:
>> FWIW I see little point in this kind of duplication, given
>> that the kernel docs are as readily available to anyone
>> interested as the man pages are;
>
> Not so much; the manual pages are available for anyone on a terminal
> without internet connection.  The kernel docs are only available if you
> have the kernel sources or internet.

No, I really don't see a difference here: I don't know a
Linux distro that doesn't provide the kernel docs as a
package.  (You seem to be using Debian and/or its
derivatives, so that would be the linux-doc package.)

> So, the manual pages are necessary.  What I wonder is if the kernel
> documentation is necessary.  I think they could drop it (the duplicated
> part of it), and refer to the manual page.  However, I trust they know
> what's best for them.

In principle, if the docs are maintained by kernel
developers, the other way round, i.e., preferring the kernel
docs, makes more sense to me: being in the same source tree,
their maintenance is less likely to be forgotten or
neglected (there might also be other factors, such as reST
likely being less taxing to work with than roff for most
people).

-- 
Štěpán