This is the mail archive of the libc-alpha@sourceware.org mailing list for the glibc project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]