On 2014/06/29 15:15:51, email_philholmes.net wrote:
Sent: Sunday, June 29, 2014 3:44 PM
Subject: Re: Adds incipit section to NR (issue 108270043 by
> Incipits are common enough that we want to have them in the manual,
> sure, but as a reasonably usable and maintained command rather than
> wagonload of snippet code.
> That's embarrassing, to say the least. At any rate, the snippet
> does not belong in NR proper. Incipit functionality does, but not
> snippet. This needs to become a usable command out of the box
Well, it seems to me you're not considering why the snippets in the
there. The CG says "A subset of these examples are automatically
into the documentation, making it easy for users to contribute to the
without learning Git and Texinfo." - so the snippets are designed to
users who can't push doc changes to the repo a chance to add
to the manuals. Nothing to do with the sort of code, simply an
And we have a standard way to include snippets contributed in that
manner, using the @snippets command. That's not what you are doing
here. You are doing a copy&paste section into the NR files themselves.
That separates the ties between the snippets maintained in the LSR and
the code listed in the NR. Where we are talking about snippets
documenting a basic feature that was lacking documentation in the
manual, that is a reasonable way forward.