Re: the Linux man-pages as an educational tool

--jo5imb5cchkwfa6a
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: <anDC3OsuGKFqwNME@devuan>
References: <20260802231058.o7gud4bd7co2nbhv@illithid>
 <[email protected]>
 <am_TTjDLlAI68zkp@devuan>
 <am_VUE1SzxqRkTAo@devuan>
 <am_V3bvOiH9TaJQW@devuan>
 <20260803020908.efqt5ilkcjq4z3yz@illithid>
 <anCAeQ5YNwXwSTWA@devuan>
 <[email protected]>
 <anCmfRDpkhSErjkS@devuan>
 <[email protected]>
MIME-Version: 1.0
In-Reply-To: <[email protected]>

Hi Sam,

First of all, thanks for toning down.

> >> 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.
>=20
> Well, give him a chance.

Of course.  I don't have any resentment at all of anyone in this
thread.  I might have written more or less heated responses at some
points, mistakes are just mistakes, and don't bind anyone.  Love is
always welcome!  :-)

Moreover, I don't think he needs to rectify.  We can just forget about
this entirely.  Really, there's no problem here.  We got too opinionated
and that caused a flame war.  We're all working towards the same goal;
let's not fight each other.

I've already committed these changes (yesterday night), with some
changes from what we've discussed.  I'll apply some more changes after
the historic details that Joseph has clarified a moment ago.  I'll also
apply some other changes from another set of details someone sent (IIRC,
=66rom Branden) today.

The manual pages are not written in stone, and I'll continue to revise
this documentation.  Everyone is welcome to send patches to improve the
exact wording.

Please trust me on this specific change and let a year or two pass
before asking me to revert it.  But I'm open to fully reverting if it
becomes evident that I've been wrong.

[...]
> > 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.
>=20
> Yes, seeing the quotes you posted in another reply, I didn't realise
> he'd written those!

:-)


Cheers,
Alex

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

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

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

iQIzBAABCgAdFiEES7Jt9u9GbmlWADAi64mZXMKQwqkFAmpwxRYACgkQ64mZXMKQ
wqkpjw//QvW0gc1234ck6UDNec2FlbF0veNCLN8PBPIb2aofDkMJCLZRVqRR6bnK
5jUu9pdJbsjoT3mbyV15BxH+1ZXzOYSdYrZ9d7Q55HfYgUwu8SdvabVv9meVmzY1
Ylyh7pcgxIIrK6D9M6bkWh5MpOi5jb/528b/bOGGLIDRWyhPTEGa1M1Dr1RT8nZY
taFLj1vhKnDNofbjU14aCuakkxSceJQLCDc8juXTa+fU31CZNfp+/rii4Z9NaO/o
s5cvpGApOOj3vipojN7agGwnc8iRZ9KvL+e9ViOrg39afzbRRLVSSH0q/g4MvXB4
EVYRX6TamPwYNxCYCRwoRLHWxjZmAIf6Eylx6z09rLmcGkS3ofV9P1kzN+2HeDiy
/bvBiBZ32GXe1/3ExNzhQh5vhzDlyY38oAplNQoDeOQrFh1cx3F8sQDwixtvccWG
pQfQjTQnNJOwcRWtX7tSTC2wGRqMRnXBVN9bgdk2lG9DvBW6QOuXe17Gy5RSEyJT
kw+C9wGKP/IJEfDhY2QF5s5JB/gF/7mW9n62Wj+diDAACvdEwx3aGm1p40BcTTEE
2FkcjoxpPiuh+FlwsXkFnWz6CGUa52+Kd7PrAszKXs7HNyL5lNoyurKKQ7ZUkEH5
nk4UtsQJYMRfHYqDH5JomPLGAJ1sNJ5oGGOkJnQAtZRoq1N37Go=
=7ZXn
-----END PGP SIGNATURE-----

--jo5imb5cchkwfa6a--