Re: Documentation buglet

[Bruno Haible]

Bastien ROUCARIES wrote:
> > getaddrinfo documentation 
> > Portability problems not fixed by Gnulib: 
> > On Windows, this function is declared in <ws2tcpip.h> rather than in 
> > <netdb.h>.
> >
> > but it is fixed by netdb module.

Actually, since the declaration in lib/netdb.in.h is inside a
  #if @GNULIB_GETADDRINFO@
  ...
  #endif
block, and @GNULIB_GETADDRINFO@ evaluates to 1 only if the 'getaddrinfo' module
is present, it is fixed by the 'getaddrinfo' module, not by the 'netdb' module.
In other words, users who ask for 'netdb' but not for 'getaddrinfo' will not
get the fix.

Simon Josefsson wrote: 
> Thanks, I've removed the sentence.

Removed? Why not moved to the section "fixed by Gnulib"?

Any objection to this patch?


2011-03-29  Bruno Haible  <address@hidden>

        getaddrinfo: Doc fix.
        * doc/posix-functions/getaddrinfo.texi: Mention Windows problem in the
        section "fixed in Gnulib".

--- doc/posix-functions/getaddrinfo.texi.orig   Tue Mar 29 14:19:03 2011
+++ doc/posix-functions/getaddrinfo.texi        Tue Mar 29 14:18:47 2011
@@ -11,6 +11,9 @@
 @item
 This function is missing on some platforms:
 HP-UX 11.11, IRIX 6.5, OSF/1 5.1, Solaris 7, Cygwin 1.5.x, mingw, Interix 3.5, 
BeOS.
address@hidden
+On Windows, this function is declared in @code{<ws2tcpip.h>} rather than in
address@hidden<netdb.h>}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
-- 
In memoriam Rachel Levy <http://en.wikipedia.org/wiki/Rachel_Levy>