Re: the Linux man-pages as an educational tool

Alejandro Colomar <[email protected]> Mon, 3 Aug 2026 16:28:24 +0200
Newsgroups org.kernel.vger.linux-man
Message-ID <anCkj3joPP5feROr@devuan>
--fkr6augduvdo2yb5
Content-Type: text/plain; protected-headers=v1; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
From: Alejandro Colomar <[email protected]>
To: Sam James <[email protected]>
Cc: Collin Funk <[email protected]>, 
	"G. Branden Robinson" <[email protected]>, Arsen =?utf-8?Q?Arsenovi=C4=87?= <[email protected]>, 
	"Maciej W. Rozycki" <[email protected]>, Paul Eggert <[email protected]>, [email protected], 
	[email protected], [email protected]
Subject: Re: the Linux man-pages as an educational tool
Message-ID: <anCkj3joPP5feROr@devuan>
References: <am6PkypxYg-Fq4Iz@devuan>
 <[email protected]>
 <am6X32HkGdm2xTd7@devuan>
 <[email protected]>
 <am-2d02e1qq78Asv@devuan>
 <[email protected]>
 <20260802231058.o7gud4bd7co2nbhv@illithid>
 <[email protected]>
 <am_TTjDLlAI68zkp@devuan>
 <[email protected]>
MIME-Version: 1.0
In-Reply-To: <[email protected]>

Hi Sam,

> Date: 2026-08-03 15:03:30+0100
> From: Sam James <[email protected]>
>
> Alejandro Colomar <[email protected]> writes:
>=20
> >> Date: 2026-08-02 16:27:21-0700
> >> From: Collin Funk <[email protected]>
> >>
> > [...]
> >>=20
> >> I can't help but wonder of what happens in WG 14 rejects this
> >> controversial, as obvious by this thread, change. Will the man-pages
> >> changes be reverted? Or will we slowly watch them document personal
> >> preferences instead of existing standards?
> >
> > This patch set is quite independent of the standard.  It documents a
> > header file that has been provided since forever in glibc and most other
> > POSIX-ish systems, so changes to the standard are unlikely to have any
> > effects.  I've clarified this extensively.  If you want to discourage me
> > from applying the change, you should rather bring up technical reasons.
> >
> > This passive-aggressive message is not something that will have the
> > desired effects you could possibly reach with technical arguments.
>=20
> I didn't read it as passive-aggressive,

I did, and still do.

> but I will say that I think
> you've gone a bit hard in the responses to Collin in this subthread, and
> I think the fact you sent several followup emails to yourself indicates
> perhaps things got heated in the moment.

Yes, they have.  And it was good that a night has happened after that.
It had calmed down.

> I think Collin was making the same conflict of interest point as
> was raised earlier, just in a different way. You may or may not agree
> with how he phrased it, and you're free to challenge that, but my
> reading of your replies is that it went a bit far.

Collin went too far.


Have a lovely day!
Alex

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

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

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

iQIzBAABCgAdFiEES7Jt9u9GbmlWADAi64mZXMKQwqkFAmpwpYcACgkQ64mZXMKQ
wqnh6w/+KeKGkdgBcJqwPgcZUue/4/cNbWkftohINwOSn07/1s+POFRPRYpWn7l4
BAeBplbu7KuwwVf0iFanCmxQJeLtOSFZTnqxHJ/TF7zJ7MWlcU+/WqNGaG0kmF09
dkHmjr8zj4OBvAW1yH5FbpHE5Y89zgIctfYCtaoXNb8P0mDTfNRMjeRcQQIgrYsT
gEHBQsgh8vmCAW0kHXwytb96TsGAS4Gn3JGCaDOqp2pyVQqUAodweS2fBxe0e/7P
Dz5l3VrYdP7aB9ahGM5+xI6P30K7nzb4zDQfrMsXp+PhMZcKO1j1l+07JendApUD
DE1i8rR1PBmVSDD6CunbmwQWh31Bu4kJeA2ipbNUrhvqMvNxE9pWHmla9L74PrXn
Pr9zTq+YSaVN5Z3U0+LOTlrwc+HMw+33XGa61B0jaLalWvLGaPpw7hxtIYfun8/K
MX47f/EZ7B+P56Dk/Az5QO5wFPwu2c8/O5/lnRFabOvpT5fomxQoAMESSUSCbmLW
0ezGFqGGoBNQCj4CjLgy2Uj/dXnEu9CIkoTiBlshXG7VUxISv7F3S6URfPmLQ7/x
bpNYqNfMnMm4QMyYll3wuOj3ytLeTjuySOyDYiBC3ocDV9RkPSkwfl/fCV00OKkb
81+BE6f2aDV27WLamVvurlFLJQtH6CcALpYRyMhVmrHZsd/M2qE=
=PSuC
-----END PGP SIGNATURE-----

--fkr6augduvdo2yb5--