Re: [PATCH] man/man5/gai.conf: Document glibc label additions

[Alejandro Colomar <alx@kernel.org>]

[-- Attachment #1: Type: text/plain, Size: 2036 bytes --]

Hi Dave,

On Mon, Jan 05, 2026 at 05:00:01PM +0000, dg@treblig.org wrote:
> From: "Dr. David Alan Gilbert" <dave@treblig.org>
> 
> Glibc includes some extra entries in its default label table
> as listed in the gai.conf it distributes:
>    https://sourceware.org/git/?p=glibc.git;a=blob;f=posix/gai.conf
> 
> Update the EXAMPLES to include the spec default and the version glibc
> actually uses.
> 
> Signed-off-by: Dr. David Alan Gilbert <dave@treblig.org>
> ---
>  man/man5/gai.conf.5 | 14 ++++++++++++++
>  1 file changed, 14 insertions(+)
> 
> diff --git a/man/man5/gai.conf.5 b/man/man5/gai.conf.5
> index ef330995d..0d3c86842 100644
> --- a/man/man5/gai.conf.5
> +++ b/man/man5/gai.conf.5
> @@ -87,6 +87,20 @@ .SH EXAMPLES
>  precedence ::/96          20
>  precedence ::ffff:0:0/96  10
>  .EE

You forgot to close with '.in'.

> +.P
> +Glibc includes some extra rules in the label table for site-local addresses,
> +ULA, and Teredo tunnels. Its default label table is:

Please use semantic newlines.  See man-pages(7):

$ MANWIDTH=72 man man-pages | sed -n '/Use semantic newlines/,/^$/p'
   Use semantic newlines
     In the source of a manual page, new sentences should be started on
     new lines, long sentences should be split  into  lines  at  clause
     breaks  (commas,  semicolons, colons, and so on), and long clauses
     should be split at phrase boundaries.  This convention,  sometimes
     known as "semantic newlines", makes it easier to see the effect of
     patches, which often operate at the level of individual sentences,
     clauses, or phrases.


Have a lovely night!
Alex

> +.in +4n
> +.EX
> +label ::1/128        0
> +label ::/0           1
> +label 2002::/16      2
> +label ::/96          3
> +label ::ffff:0:0/96  4
> +label fec0::/10      5
> +label fc00::/7       6
> +label 2001:0::/32    7
> +.EE
>  .in
>  .\" .SH AUTHOR
>  .\" Ulrich Drepper <drepper@redhat.com>
> -- 
> 2.52.0
> 

-- 
<https://www.alejandro-colomar.es>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]