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 Fri, Apr 13, 2012 at 4:09 PM, Carlos O'Donell
<carlos@systemhalted.org> wrote:
> On Fri, Apr 13, 2012 at 10:57 AM, Nix <nix@esperi.org.uk> wrote:
>> 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.
>
> My `mad science' plan is to convince someone to use Eclipse help to
> put together *all* of the GNU projects and the man pages into one
> giant searchable blob.
>
> One of the things I like about CodeBench's search is that when I type
> "cfi_startproc" I get *all* references across *all* GNU tools manuals
> including the tid-bits hidden in some other place that show an example
> or two for how something should be done.

For reference:

http://help.eclipse.org/indigo/index.jsp

http://infocenter.arm.com/help/index.jsp

http://publib.boulder.ibm.com/infocenter/zos/v1r11/index.jsp?topic=/com.ibm.zos.r11.e0za100/gccsupb.htm

It's just another way to make it easy to search and use documentation.

Neither man pages nor HTML/PDF are really sufficient for some classes of users.

Cheers,
Carlos.


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