Re: include snippets in docs [was: Re: stop breaking the docs]

[Graham Percival]

On Fri, 29 Feb 2008 23:23:01 +0100
John Mandereau <address@hidden> wrote:

> Le mercredi 27 f__vrier 2008 __ 21:36 -0800, Graham Percival a
> __crit : 
> > This is still under discussion.  (also, I'm not certain that
> > the correct snippet was linked to... but the basic point remains:
> > sometimes we have long examples which don't really add anything
> > to the NR, but which we may want to direct readers to)
> 
> In this case, we could use @lilypondfile without verbatim, but it

No.  With the exception of special cases like NR 1.1.whatever
Automatic accidentals, we show all lilypond code for the NR.

I'd rather keep @lsr{} and use that instead of @lilypondfile
without verbatim.

> There's another related issue: snippet titles are not printed in
> manuals, should we use printfilename fragment option as in snippets
> pages?  It'd be even better to print real snippet titles instead of
> those filenames with dashes; adding that feature mainly requires
> Valentin and me to work on requests to Sebastiano ;-)

Good idea; that will help reinforce the "these are snippets from
LSR" thing.  However, are you note, this needs to wait for you
three.

BTW, have you made any requests since Dec (or whenever) when we
started making the list?  If not, this might be a good time to
send a bunch.

If the list doesn't include Mats' "display the \version number
even though we don't store this" request, please add it.

Cheers,
- Graham