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

Alejandro Colomar <[email protected]> Mon, 20 Jul 2026 00:10:19 +0200

Newsgroups	org.kernel.vger.linux-man
Message-ID	<al0_v8rno_mZzl0U@devuan>

Hi Štěpán,

On 2026-07-19T23:12:38+0200, Štěpán Němec wrote:
> 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.)

Hmmm, thanks!  I didn't know about it.  Still, I find local html docs to
be less comfortable for users than manual pages, but it's good to know
that it exists.


Have a lovely night!
Alex

> > 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

-- 
<https://www.alejandro-colomar.es>

signature.asc (application/pgp-signature, 833 B)