Re: the Linux man-pages as an educational tool

--=-=-=
Content-Type: text/plain
Content-Transfer-Encoding: quoted-printable

Alejandro Colomar <[email protected]> writes:

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

Well, give him a chance.

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

Right.

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

Yes, seeing the quotes you posted in another reply, I didn't realise
he'd written those!

>
>
> Have a lovely day!
> Alex

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

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

iQEBBAEWCgCpFiEEJaa7iN2bdkxrVUHCc4QJ9SDfkZAFAmpwvsAbFIAAAAAABAAO
bWFudTIsMi41KzEuMTIsMiwyXxSAAAAAAC4AKGlzc3Vlci1mcHJAbm90YXRpb25z
Lm9wZW5wZ3AuZmlmdGhob3JzZW1hbi5uZXQyNUE2QkI4OEREOUI3NjRDNkI1NTQx
QzI3Mzg0MDlGNTIwREY5MTkwDxxzYW1AZ2VudG9vLm9yZwAKCRBzhAn1IN+RkCUw
AP9aoxTytM3iC7qRaLXOF+1KjVF2MejYU3QHyPnZ02HepQEA5icELv/P4dDLljL6
2mLYko7UxSRqNRW6HaBxJNwhHg0=
=wCaM
-----END PGP SIGNATURE-----
--=-=-=--