[PATCH v2 2/5] manual: Convert @tables of variables to @vtables.

Joseph Myers joseph@codesourcery.com
Tue Dec 6 15:46:00 GMT 2016


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



More information about the Libc-alpha mailing list