Re: removing @lsr{} and only using @lsrdir{}

[John Mandereau]

Le samedi 26 avril 2008 à 03:53 -0700, Graham Percival a écrit :
> On Fri, 25 Apr 2008 15:05:40 +0200
> John Mandereau <address@hidden> wrote:
> 
> > > Sorry, why do we need a CMD?  We should use the same formatting
> > > for all of them, so an argument-less command like [doctitle]
> > > should be sufficient.
> > 
> > No, we certainly won't use the same formatting in Snippets document
> > and in the manuals, as the latter has much more sectioning levels
> > than the former.
> 
> I don't follow.
> 
> Essentially, we just want to print out
> Adding Ambits Per Voice
> 
> instead of
> adding-ambits-per-voice
> 
> right?  Why would the formatting be different in the Snippet
> document than in the manuals?  Just make it
> @emph{\NAME\}
> or something like that.

No, because it would not enough to write a cross reference to an
individual snippet -- a particular place in a Texinfo document can be
cross-referenced only with @node or @anchor.  I know you don't want to
point to individual snippets, but I think it's worthwhile.


> >  Anyway, it's a bad idea to hardcode the doctitle
> > formatting in lilypond-book, so let's make doctitle an argument-less
> > option: lilypond-book could output @lydoctitle{DOCTITLE-TEXT}, and
> > we'd define @lydoctitle macro differently in macros.itexi and
> > input/lsr/lilypond-snippets.tely.  I estimate I'll have time to get
> > this done in about a week.
> 
> IIRC you can't use macros like that in texinfo.  I mean, you
> can't do
> 
> @macro lilyheader{FILENAME}
> @lilypondfile[foo,bar]{\FILENAME\}
> @end macro

This is not a Texinfo construct, this kind of construct is handled by
lilypond-book.  It might have been already explained umpteen times that
lilypond-book doesn't parse Texinfo/LaTeX/whatever syntax -- maybe we
should say it clearly in docs?


> which is essentially what this proposal boils down to, right?

No, I proposed to make lilypond-book write

@lydoctitle FOO TITLE

when the snippet contains 'doctitle="FOO TITLE"' and doctitle fragment
option is used.  @lydoctitle would be defined in the Texinfo document.


>   I
> spent ages trying to do this for the section headers.  :(
> If you /can/ do this, possibly by modifying lilypond-book and/or
> texinfo, that would be awesome.

If I had more time, I'd be glad to be sponsored for lilypond-book features.

Cheers,
John