Re: the Linux man-pages as an educational tool

--v7dm2drlvqq6jemx
Content-Type: text/plain; protected-headers=v1; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
Subject: Re: the Linux man-pages as an educational tool
MIME-Version: 1.0

Hi Collin,

At 2026-08-01T18:04:05-0700, Collin Funk wrote:
> Alejandro Colomar <[email protected]> writes:
> >> I'd like to underscore this point.  As I noted in my response to
> >> Doug, the flagship book on C, as we all know, is stuck in 1988.
> >> The throne is vacant, with many pretenders, some with excellent
> >> cases for service as regent.
> >
> > In fact, the throne might currently fall in the Linux man-pages
> > project.  While not being a blood heir of the Unix standards, it has
> > become a de-facto standard.
>=20
> I don't think anyone is arguing whether or not man-pages is an
> educational tool. The argument is whether it should educate based on
> current standards, or the maintainers preferences.

There are always going to be matters that a relevant standards body
hasn't resolved.  Its work would be trivial if there weren't!

I think what the Linux man-pages community is negotiating here is a pair
of related questions.

1.  Should the Linux man-pages make _any_ representations that are not
    supported by a formal standard?

2.  If so, what are the boundaries of its editorial authority?

3.  If not, hard luck for the Linux kernel, eh?

It's easy to say, "I don't like what Alex is doing with xyz(3)."  What's
harder is to articulate a reasonable-sounding, defensible principle that
should restrain him from doing so.

As Kant said:

"Act only according to that maxim whereby you can at the same time will
that it should become a universal law."

https://existentialcomics.com/comic/293

Regards,
Branden

--v7dm2drlvqq6jemx
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAmpumhwACgkQ0Z6cfXEm
bc4zDA//XSi2cmS8dPLAf8UweWX3Zdi4mrq2j8HE4v6M83ZyXnXTvUchA6ixqUj+
88vU5+XY6Trt48od6Na2utfK+Ky5zQRcSKB8gTPmoac00jzJlfd4IpFSkSjy53U5
5+w24iHFWWunXcc0yniOk4K9TQ7yyXtBMxRP6z64nmFMrmWJK6Mo7cmmQzZ5zgmo
cBOVmympY39ZZmpVFzW5wW9A2Yz3LMmD3nyWvB1yYBZaJdkpxeLJnfKUZiTNfRUI
sOU99MsVXPCb8aUfZGevSSRBeAJaBa4TjiqSWB9AqJAcIo0FA/5KKFBhKoHD2ZZf
jA8B7kXajofSccGZylOL6EspbAXmAIWVv5AqYBk4ncDqMQ56AJnuvwgM32WNB64U
q939G6XVT4AsYRjkTFSDoOGbomSdNx4lYiwtIsbwcdlcKAJBtzQ+ZFQ3dhQyPxGQ
9KIwMjIArXCvyH2b9V0wR25l/UUMY6pTCFSA+ZsixYzNWGIcIcX7DQ7SHXb2Give
KHMX6hmz+ef3EAwFIK/54t+Qle6fVs4xI8qK1SPmouGfDuqBcs2JeA6UAmuupDcs
eJHRbrewN5s7ZdeT8gZKi/LHTrrKCa1hIUMlf1bYoDif9FyWCP4t0CA1usTBIjVJ
NGAAc1HkloBx8USdeDIhnds1xzSWznBI7jLM6nVOSMDNKYqMYAc=
=6uqR
-----END PGP SIGNATURE-----

--v7dm2drlvqq6jemx--