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.
On 12/06/2016 05:55 AM, 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.
I think you should also go ahead and commit this one. Getting more
stuff into appropriate indexes is a Good Thing and worth doing
independently.
zw