Re: the Linux man-pages as an educational tool

Alejandro Colomar <[email protected]> Mon, 3 Aug 2026 01:42:57 +0200
Newsgroups org.kernel.vger.linux-man
Message-ID <am_V3bvOiH9TaJQW@devuan>
--4hy4u22inef4bky5
Content-Type: text/plain; protected-headers=v1; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
From: Alejandro Colomar <[email protected]>
To: Collin Funk <[email protected]>
Cc: "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: <am_V3bvOiH9TaJQW@devuan>
References: <am6PkypxYg-Fq4Iz@devuan>
 <[email protected]>
 <am6X32HkGdm2xTd7@devuan>
 <[email protected]>
 <am-2d02e1qq78Asv@devuan>
 <[email protected]>
 <20260802231058.o7gud4bd7co2nbhv@illithid>
 <[email protected]>
 <am_TTjDLlAI68zkp@devuan>
 <am_VUE1SzxqRkTAo@devuan>
MIME-Version: 1.0
In-Reply-To: <am_VUE1SzxqRkTAo@devuan>

> Date: 2026-08-03 01:41:39+0200
> From: Alejandro Colomar <[email protected]>
>
> > Date: 2026-08-03 01:37:30+0200
> > From: Alejandro Colomar <[email protected]>
> >
> > Hi Collin,
> >=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?
>=20
> > > Or will we slowly watch them document personal
> > > preferences instead of existing standards?
>=20
> BTW, as I showed in another subthread, strncpy(3) did contain
> opinionated comments well before I was involved.  If you're really
> going to accuse me of that, better make sure you get the history right.

Oh, and while at it, please also read my review of glibc's own
opinionated and bogus documentation about string truncation.


Cheers,
Alex

>=20
>=20
> Cheers,
> Alex
>=20
> >=20
> > 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.
> >=20
> > This passive-aggressive message is not something that will have the
> > desired effects you could possibly reach with technical arguments.
> >=20
> >=20
> > Have a lovely night, please!
> > Alex
> >=20
> > > After seeing weekly threads
> > > about the prototype changes, I don't think it is an unreasonable
> > > concern.
> > >=20
> > > Collin
> > >=20
> >=20
> > --=20
> > <https://www.alejandro-colomar.es>
>=20
>=20
>=20
> --=20
> <https://www.alejandro-colomar.es>



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

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

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

iQIzBAABCgAdFiEES7Jt9u9GbmlWADAi64mZXMKQwqkFAmpv1gAACgkQ64mZXMKQ
wqnXTg/9HvqrTOC6Zb58HZz1ktb+lBOlIP78NXDlGLe0e91kVOjO6jIGioA/9Vx3
Mud2Q3rz1RI8gEqjlx8BPmNJjmCRne4xW4SMf63YO2Vw+xHjRP2TEARaSQuQbXCe
p7tyfDen9/Nd5qejw19Q2QzHPHs4lvs9kgdAxp7yub4e7YQgIPFumXR6aHWomJFE
xdtA2ZCnQrxNcyKDMH2f2QeUJe8YOv+EPHh/zCDpN1ZnBHKGGTwU1US/06uv0US2
c9O2rb43FAl2vOAibnCedlPzO8nVSxoadZLAk/15g6N+fn9gUd6g1PepViWjga3x
0cSWMyg3t3DbkBD9IHNH1Cop5fRe/cLy5pXQvY4sDv2Vt4JoTvaRLs+L9sQNSwLq
PT4pDE8Q/ceaPFzL3S1wDh+lz9GvpqBhfZ4vME7DLzCbg3Mw+I0EYjxV7qx/Na6g
dCmSndPQssiT5PyE/Ghnm5sObkfbMTzFOSE7biVhPvi16WJRFFWRBFNjk6OHFqFz
SV4nZvMasns0ePw97QpXEJ6vz3qOIY7hw1I5eMD3uVKGd+2LUN2QJfHG3xY/oJmB
uHnWG3E2w/UYwToXVwFeEgCCuNtQHadoxfAPrh0wcqTM5o7K2G8LeG8g5zFs4kMa
T+Ide+2Od2KM/Dbc9+lqHGfF+sxc1ymBFzaJSiS9afelCOqKU54=
=pLwp
-----END PGP SIGNATURE-----

--4hy4u22inef4bky5--