[PATCH v4 2/5] manual: Create empty placeholder macros for @standards.

Rical Jasan ricaljasan@pacific.net
Fri May 19 09:33:00 GMT 2017


Header and standards annotations are slated for standardization,
including being rendered in the description of functions, variables,
etc. (elements), and eventually required.  This commit adds @standards
dummy macros so we can convert all existing annotations to the new
framework while maintaining the rendered status quo.

There needs to be a way to provide separate annotations for lists of
@*x elements, where a common description is shared.  The @standardsx
macro fills this role by accepting an additional parameter: the name
of the annotated element.

	* manual/macros.texi (@standards): New macro.  Provide
	placeholder for header and standards annotations.
	(@standardsx): New macro.  Likewise, for lists of @*x
	elements.
---
 manual/macros.texi | 7 +++++++
 1 file changed, 7 insertions(+)

-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0002-manual-Create-empty-placeholder-macros-for-standards.patch
Type: text/x-patch
Size: 421 bytes
Desc: not available
URL: <http://sourceware.org/pipermail/libc-alpha/attachments/20170519/60b286b4/attachment.bin>


More information about the Libc-alpha mailing list