Re: the Linux man-pages as an educational tool

--i5zq7hqjxhtv4k3l
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: "G. Branden Robinson" <[email protected]>, 
	Collin Funk <[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: <anCmfRDpkhSErjkS@devuan>
References: <am-2d02e1qq78Asv@devuan>
 <[email protected]>
 <20260802231058.o7gud4bd7co2nbhv@illithid>
 <[email protected]>
 <am_TTjDLlAI68zkp@devuan>
 <am_VUE1SzxqRkTAo@devuan>
 <am_V3bvOiH9TaJQW@devuan>
 <20260803020908.efqt5ilkcjq4z3yz@illithid>
 <anCAeQ5YNwXwSTWA@devuan>
 <[email protected]>
MIME-Version: 1.0
In-Reply-To: <[email protected]>

Hi Sam,

> Date: 2026-08-03 15:05:36+0100
> From: Sam James <[email protected]>
>
> Alejandro Colomar <[email protected]> writes:
>=20
[...]
> > He doesn't need to have read every word of the glibc manual, but this
> > precise text he could have read it, because it was mentioned by Paul in
> > this thread (different subthread) prior (19:28 UTC) to his message, and
> > reviewed by me also prior (20:31 UTC) to his message (23:27 UTC).
>=20
> I often reply as I go rather than reading all other emails around that
> time. I don't think you should assume he read those emails and
> deliberately neglected their contents.

Me too.  But eventually I respond to those other emails, and rectify
when that new information conflicts with something I said with
incomplete information.  So far, Collin didn't rectify.

> >
> > 	Date: Sun, 2 Aug 2026 14:28:33 -0500
> > 	From: Paul Eggert <[email protected]>
> > 	Message-ID: <[email protected]>
> >
> > 	Date: Sun, 2 Aug 2026 22:31:59 +0200
> > 	From: Alejandro Colomar <[email protected]>
> > 	Message-ID: <am-eAGL6OWqP9Yah@devuan>
> >
> > 	Date: Sun, 02 Aug 2026 16:27:21 -0700
> > 	From: Collin Funk <[email protected]>
> > 	Message-ID: <[email protected]>
> >
> > Also relevant is the fact that he accused me of "slowly" documenting
> > "personal preferences".  His wording implies that it wasn't there
> > before.  Maybe I misunderstood, though.  I'd be happy to rectify if I
> > was wrong.
>=20
> I think he meant in general?

I don't interpret that.  I guess he can defend himself and clarify.

> > While he didn't need to know whether it was there before, it would be
> > good to make some effort to learn whether that was the case, before
> > making such a serious accusation.
>=20
> I took it to be that you (as you've said yourself) have a different
> style from Michael and this does involve a more opinionated (you may not
> call it that) approach.  He's commenting on that being unfavourable to
> him.  I didn't think that was contentious, more that you see it as your
> duty wrt education.

I only see my style slightly different than Michael's, but not
necessarily in the sense of involving a more opinionated approach.  See
the other messages where I've shown how Michael had done the exact same
thing with strlcpy(3) a long time ago.

On reconsideration, and after researching what Michael really did,
I think I was wrong saying we have a different style at all.  I believe
we've had the same style.  We just had different topics of expertise.

Michael has had his own share of opinionated comments in manual pages.


Have a lovely day!
Alex

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

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

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

iQIzBAABCgAdFiEES7Jt9u9GbmlWADAi64mZXMKQwqkFAmpwqFoACgkQ64mZXMKQ
wqnQEg/8DoI+BT67ZYfbNyPpz241JrxzZm+Xu5oobqJU9sfH3cfAYm8WwUE1oGrN
H1Lx7VtjbTtFBr+uCMDwdLyJjjMpAfYytGBTNig0zKtPQFKJfS7y/bTX7RqqDCJC
G0jSLanBd0zIH39TfxVDrg8G2tUIXgSQVE6Q4V3DfYkSN5Q2LsdvFXufOSpTpLqP
rXcVL+2NjuXy7TYO/8uqLdDlrwaYtF1BNw7y4XJeD+NPcbrKX/rV4QmVsSlnz6Dt
MTtr9NtV8yhMzHmm8qEA0G42GTUM3GJ+CeobZwPwQFR6Awy46bzMS3jXE3dO84su
67cu17sugWearI0oGqRubgQxyDrjExzq1SUx5QcWvN7m13JPAYh0r0KDSHSlAqTi
4EDpiJmoAciq+SFTJ8m7ix+TwV1JbuvU+FHFTqv6yf8DKZY0O+eQ4oGyNB0Y7WuS
FrqFs0+/4OEm/r+d2KDRmwmOMEy4QF/zlfuEVTYeMH3Ewz05T6fweuDnSjOzUmYa
pqG4MhhYRdZRfxWApbQX9Ek3V49e4toZ74CYQmSaQLoB/4UJ4gqbMB9XTZg1YwJp
zG/s+HFyi2g9VEWCgiedRz+TSmqgXCJNJ0tOrsmQWBuLYsBGvuCtAvCxYgvlQ2vd
npndbt+yhKP0Sp0m1rSriFkinuTVX1vg/PWKTi5K3P2ijHhUktY=
=ClqX
-----END PGP SIGNATURE-----

--i5zq7hqjxhtv4k3l--