Re: NR 3.6.1, Displaying LilyPond notation

[David Kastrup]

Federico Bruni <address@hidden> writes:

> Hi all
>
> I'm completing the translation of the 3rd chapter of Notation
> Reference and I'm having problems with translating this section:
> http://www.lilypond.org/doc/v2.19/Documentation/notation/displaying-lilypond-notation
>
> Isn't it unclear or it's just me?
>
> ...in particular the last paragraph of this page:
>
> %%%%%%
> Note that Lilypond does not just display the music expression, but
> also interprets it (since \displayLilyMusic returns it in addition to
> displaying it). This is convenient since you can just insert
> \displayLilyMusic into existing music in order to get information
> about it. If you don’t actually want Lilypond to interpret the
> displayed music as well as display it, use \void in order to have it
> ignored:

> PS My proposal (only to inspire english mother-tongue doc writers..):
>
> %%%%%%%
> The music function \displayLilyMusic allows to display on the console
> a music expression in LilyPond notation. It does not simply copy the
> notes of the input file; instead, it interprets the music expression
> and returns the notes that LilyPond will eventually print out. For
> example,

Well, no, that isn't what is meant by "interpreted".

How about:

The music function \displayLilyMusic displays the following music
expression while also retaining it as part of the surrounding
expression.  This is convenient when inserting \displayLilyMusic into
existing music expressions since it does not affect their interpretation
when printing a rendition of them.

Sometimes you indeed only want to print some expression without letting
LilyPond do anything else with it.  In that case, you can place \void
before \displayLilyMusic and the entire expression will be discarded
after displaying it.

-- 
David Kastrup