This is the mail archive of the libc-alpha@sourceware.org mailing list for the glibc project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [PATCH] Fix up LD_* vars behaviour


On 13 Apr 2012, Petr Baudis said:
>   I believe that man-pages are the de facto reference documentation for
> GNU libc used by the developers, even in cases where both man-pages and
> the info manual cover something, and we should face that reality, i.e.
> actively care for man-pages correctness and completeness, not treat it
> with contempt or indifference.

FWIW until I started working for a Linux distributor, I had never worked
with anyone who realised the glibc info documentation even *existed*,
let alone looked there for anything. They used the manpages and (if you
were lucky) POSIX. (This is, of course, anecdotal, but I would not be
surprised to find that it was replicated in pretty much every Unix
development shop out there.)

I actually *like* info documentation, and even so I hardly ever remember
the glibc docs exist. Their coverage is sufficiently much less than the
manpages these days that they serve little to no purpose to me, other
than searchability. If I have no idea where in the docs some tidbit
might be, *then* I use the glibc info docs. Otherwise, never.

The Linux manpages used to be less complete than the glibc info pages,
and dissociated across many projects. Thanks to Andries and (especially)
Michael's stalwart maintainership, this is very much no longer the case.
They are the best online documentation on the platform, and ignoring
them is a serious mistake.

-- 
NULL && (void)


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]