[PATCH] Fix up LD_* vars behaviour

Andreas Jaeger aj@suse.com
Fri Apr 20 13:10:00 GMT 2012


On 04/20/2012 01:30 AM, 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 agree with Dave here.  The man pages are indeed the de-facto 
documentation.

How can we actually better work together?

I propose the following things as a starting point:

* Michael is now on the default CC list of bugs for the glibc manual and 
thus will see requests for documentation - many of them are for man 
pages instead of the texinfo documentation.

* If glibc introduces or changes an interface, the author will work with 
the man pages project on updating the man pages (and also on updating 
the glibc manual). The man pages team is welcome to approach the glibc 
team with questions and reviews on man pages.

* The glibc wiki contains a reference to the man pages project.

Andreas
-- 
  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
   SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
    GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126



More information about the Libc-alpha mailing list