Re: [frogs] Re: patch for bug 729

[Graham Percival]

On Fri, Feb 27, 2009 at 01:17:53PM -0700, Carl D. Sorensen wrote:
> 
> On 2/27/09 9:52 AM, "Mats Bengtsson" <address@hidden> wrote:
> 
> > Not to mention the following example:
> > input/lsr/demo-midiinstruments.ly
> 
> Don't modify the snippets.  That's handled by running convert-ly on the
> those files.  That's why we try to keep as much syntax as possible in the
> snippets; they're automatically fixed.
> 
> You only need to modify text in the body of the documentation, including any
> examples that are inline in the docs.

Erm, that's exactly opposite.

- the NR tries to avoid overrides as much as possible to make
  convert-ly more likely to work.
- therefore, running convert-ly on the docs should fix everything.
- automagic updating For Teh Win (tm).

- the snippets may use overrides and whatnot.
- these will hopefully still work in convert-ly, but might not.
- therefore, they are much more likely to require manual attention.
- still, each snippet is small and well-contained, so it should be
  easy for any moderately skilled lilypond user to update
  them (i.e. they don't need to know git, texinfo, etc)

Cheers,
- Graham