Re: Documentation buglet

[Simon Josefsson]

Bruno Haible <address@hidden> writes:

> 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?

Yes, good point.  Please push it.

Thanks,
Simon

>
> 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: