Confusing sentence in 8.2 Markup programmer interface (2.4.2)

[Han-Wen Nienhuys]

address@hidden writes:
> In lilypond-snapshot-doc 2.4.2
> 
> 8.2 Markup programmer interface
> 
> This sentence has broken grammar and I don't understand what is meant:
> 
> When applied with as arguments an output definition (\layout or \paper), 
> and a list of properties and other arguments, produce a Stencil object.


Graham,

can you try to make something comprehensible out of the following?  It
also needs to be checked with the following sections; I believe there
is some double material.

Markups are functions that print text and text-like symbols in the
output. For example, in 

   c^\markup { \bold Allegro }

there are two markups: @code{Allegro} is the instruction to print the
string "Allegro", and @code{\bold} is a function that modifies an
existing markup (in this case: the @code{Allegro}) to be printed in
boldface.

Internally, such markups are represented as scheme functions, taking
other markups (here: @code{Allegro}), an output definition (the
current @code{layout} block) and properties (in this case: the
settings for the @code{TextScript} grob) as arguments. The result of
this Scheme function is a Stencil object (qv.)



> 
> Paul Scott
> 
> 
> _______________________________________________
> bug-lilypond mailing list
> address@hidden
> http://lists.gnu.org/mailman/listinfo/bug-lilypond

-- 

 Han-Wen Nienhuys   |   address@hidden   |   http://www.xs4all.nl/~hanwen