[PATCH 1/3] manual: Refactor header and standards annotations.

[Joseph Myers]

On Thu, 24 Nov 2016, Rical Jasan wrote:

> First, I was going to ask if there was a preference for whether
> summary.awk should be modified or if a new script was acceptable, and if
> so which language.  To help make sense of things while working this out
> I used a Perl script for a scratchpad, which I could clean up for

Building the manual already requires perl (to generate libm-err.texi) so 
use of perl is not necessarily a problem.

> Second, I expect we'll move away from @comment-based annotations to
> something more explicit/obvious, so I was avoiding enforcing a syntax
> until we settle on one.  (Not that it's an argument against enforcing
> now.)  For example, I'm already using new @vitem and @titem macros to

My view is that when patches cause the manual to meet particular syntax 
rules that help conversion to another form of annotations, they should 
also make sure those rules are enforced so we don't regress before the 
conversion.

-- 
Joseph S. Myers
joseph@codesourcery.com