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 v4 2/5] manual: Create empty placeholder macros for @standards.


On 05/19/2017 05:33 AM, Rical Jasan wrote:
> 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.

This is OK.  Please go ahead and check it in.

zw



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