Re: [frogs] Re: patch for bug 729

2009-02-27 Thread 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 mats.bengts...@ee.kth.se 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


___
bug-lilypond mailing list
bug-lilypond@gnu.org
http://lists.gnu.org/mailman/listinfo/bug-lilypond


Re: [frogs] Re: patch for bug 729

2009-02-27 Thread Mats Bengtsson

Graham Percival wrote:

On Fri, Feb 27, 2009 at 01:17:53PM -0700, Carl D. Sorensen wrote:
  

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.
  
However, in this particular case, running convert-ly on the docs would 
not have fixed everything, whereas running convert-ly on the LSR snippet 
will fix it.


  /Mats


___
bug-lilypond mailing list
bug-lilypond@gnu.org
http://lists.gnu.org/mailman/listinfo/bug-lilypond