This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: [PATCH v2 2/5] manual: Convert @tables of variables to @vtables.
- From: Joseph Myers <joseph at codesourcery dot com>
- To: Rical Jasan <ricaljasan at pacific dot net>
- Cc: <libc-alpha at sourceware dot org>, <mtk dot manpages at gmail dot com>, <carlos at redhat dot com>
- Date: Tue, 6 Dec 2016 15:46:21 +0000
- Subject: Re: [PATCH v2 2/5] manual: Convert @tables of variables to @vtables.
- Authentication-results: sourceware.org; auth=none
- References: <20161206105525.21117-1-ricaljasan@pacific.net> <20161206105525.21117-3-ricaljasan@pacific.net>
On Tue, 6 Dec 2016, Rical Jasan wrote:
> Using a @vtable provides a context for processing @items
> whereby it can be known the @items should have header and
> standards annotations. This commit converts @tables of such
> @items to @vtables in order to establish a framework for
> automated processing.
>
> A pleasant consequence of these changes are that @items
> previously absent from the Variable and Constant Macro Index
> are present now. Any @vindex entries are removed, being
> unnecessary, as they are automatically indexed due to being in
> a @vtable. Note that @vindex entries previously detected by
> summary.awk will still be detected as @items with appropriate
> annotations.
>
> The @table of the NSS databases are converted to a @table
> because 1) those @items are not variables (and will no longer
> appear in the Variable and Constant Macro Index) and 2) they
> do not need header and standards annotations, so the incorrect
> context is fixed.
>
> * manual/arith.texi: Convert @tables of variables to @vtables.
> * manual/filesys.texi: Likewise.
> * manual/llio.texi: Likewise.
> * manual/memory.texi: Likewise.
> * manual/process.texi: Likewise.
> * manual/resource.texi: Likewise.
> * manual/search.texi: Likewise.
> * manual/signal.texi: Likewise.
> * manual/socket.texi: Likewise.
> * manual/stdio.texi: Likewise.
> * manual/sysinfo.texi: Likewise.
> * manual/syslog.texi: Likewise.
> * manual/terminal.texi: Likewise.
> * manual/time.texi: Likewise.
> * manual/users.texi: Likewise.
> * manual/nss.texi: Convert an incorrect @vtable to a @table.
OK.
--
Joseph S. Myers
joseph@codesourcery.com