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

Rical Jasan ricaljasan@pacific.net
Sat May 20 06:05:00 GMT 2017


On 05/19/2017 02:02 PM, Zack Weinberg wrote:
> 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.

Thank you for acknowledging you think this is approach is acceptable,
but I am going to defer committing for now in lieu of the higher level
discussion of @standards in general.

Rical



More information about the Libc-alpha mailing list