glibc manual on www.gnu.org is out of date
Collin Funk
collin.funk1@gmail.com
Tue Aug 19 18:29:57 GMT 2025
Bruno Haible <bruno@clisp.org> writes:
> Collin Funk wrote:
>> > The glibc manual at
>> > https://www.gnu.org/software/libc/manual/html_node/index.html
>> > is out-of-date (still version 2.38). Whereas the one at
>> > https://sourceware.org/glibc/manual/latest/html_node/index.html
>> > https://sourceware.org/glibc/manual/2.42/html_node/index.html
>> > is up-to-date.
>> >
>> > Could the one on gnu.org be updated, please?
>>
>> I assume the gnu.org link was indexed by Google or some other search
>> engine?
>>
>> The links on https://www.gnu.org/software/libc/ under documentation link
>> to https://sourceware.org/glibc/manual/ where the updated manuals are.
>>
>> That seems better than having to maintain both, in my opinion.
>
> I am asking for three reasons:
>
> * GNU Gnulib's documentation has hundreds of references to the GNU libc
> manual. I don't really want to change n*100 hyperlinks to refer to
> a host owned by Red Hat when the same documentation ought to be
> available on www.gnu.org.
>
> * When a Texinfo source file contains a reference
> @ref{Something,,Something,libc}
> the conversion to HTML by 'makeinfo' will create a hyperlink to
> https://www.gnu.org/software/libc/manual/html_node/Something.html
>
> * The instructions that every GNU package receives when it becomes a
> GNU package include these two paragraphs:
>
> Please write or update the web pages about the program, to put in
> https://www.gnu.org/software/<PACKAGE>. These pages should be the
> main web site for the program, and they should really have the
> information for users, not just a link to another site; please use
> https://www.gnu.org/software/<PACKAGE> whenever you give out the URL
> for the home page of the program. Please don't set up a "site for the
> program" anywhere else--if you want to do work on additional web pages
> about the program, please put them on www.gnu.org.
>
> (It is ok to put pages that address developers-only topics on another
> site, and likewise for pages that access databases.)
Good points. I did not consider the use of @ref{...,libc}. That is alone
is reason enough to upload them, in my opinion.
Adding Carlos to CC. Could you please upload them? I cannot since I am
not a member of the Savannah group.
Collin
More information about the Libc-alpha
mailing list