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

["Dr. David Alan Gilbert" <dave@treblig.org>]

* 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   |_______/