This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: [PATCH 1/3] manual: Refactor header and standards annotations.
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