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 4/19/2012 7:30 PM, David Miller wrote:
> From: "Joseph S. Myers" <joseph@codesourcery.com>
> Date: Thu, 19 Apr 2012 23:18:53 +0000 (UTC)
> 
>> In accordance with the GNU Coding Standards, man pages are secondary
>> to the Texinfo documentation for GNU software.  They should be read
>> as independent observations about the library rather than a contract
>> with applications.
> 
> Unfortunately this line of thinking ignores reality.  I really am
> getting frustrated with these repeated divisive statements about
> the manual pages vs glibc.
> 
> If the glibc documentation were complete and widely used, you could
> say that the man-pages are secondary.
> 
> But the glibc documentation is far from complete and is not widely
> used, and therefore the man-pages are not secondary.
> 
> The man pages are the de-facto documentation for the application
> programming interfaces provided by glibc.  They are the primary and
> only complete source.  No coding standards document, GNU or otherwise,
> can change this fact.
> 
> I would like to see a deeper acceptance and acknowledgment of this
> reality, rather than the continued usage of scarecrows such as the GNU
> Conding Standards to pretend that the actual situation is different or
> should not be acknowledged.

I fully agree.

We need to learn to work well with the man-pages.

Cheers,
Carlos.
-- 
Carlos O'Donell
Mentor Graphics / CodeSourcery
carlos_odonell@mentor.com
carlos@codesourcery.com
+1 (613) 963 1026


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