Re: the Linux man-pages as an educational tool

[Alejandro Colomar <alx@kernel.org>]

[-- Attachment #1: Type: text/plain, Size: 2366 bytes --]

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

:-)


Cheers,
Alex

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

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]