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

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

[dg]

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

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

[Alejandro Colomar]

[-- 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 --]

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

[Dr. David Alan Gilbert]

* Alejandro Colomar (alx@kernel.org) wrote:
> 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.

See v4:
  20260105174401.222443-1-dg@treblig.org

With the .in and extra newlines.
(Ahem, sorry about v2,v3 )

Dave

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


-- 
 -----Open up your eyes, open up your mind, open up your code -------   
/ Dr. David Alan Gilbert    |       Running GNU/Linux       | Happy  \ 
\        dave @ treblig.org |                               | In Hex /
 \ _________________________|_____ http://www.treblig.org   |_______/