Re: GDP: Some queries concerning markup commands

[Nicolas Sceaux]

Le 6 juil. 08 à 18:57, Neil Puttock a écrit :

> Hi everybody,
>
> Now that I've done example snippets for the majority of the commands
> in define-markup-commands.scm, I have a few queries concerning the
> following items; I'd be grateful if anybody can suggest solutions to
> these problems:

I've skipped the questions that I cannot answer.

> 1. \fontCaps
>
> This needs a font with caps style to work properly. I've checked the
> installed fonts on my system, but can't see any which support this
> style, even though I have texlive-base installed which includes
> Computer Modern.

This is not a question :-)

> 2. \simple
>
> I've only noticed this being used for markup inside Scheme functions;
> is there any reason why one might need this for normal markup usage?

No. Even when defining a markup command you probably won't have to use
it.

> 4. \justify-field and \wordwrap-field
>
> I've searched the archives, but I can't find any examples where these
> commands have been used.
>
> I see from the source that they use chain-assoc-get on props to find a
> symbol, but where would this symbol be placed in a .ly file and
> assigned some data?

They are related to \fromproperty, applying \justify-string or
\wordwrap-string to the property. For instance:

\header {
  title = "My title"
  descr = "Some very large description blah blah blah. Some very  
large description blah blah blah. Some very large description blah  
blah blah. Some very large description blah blah blah."
}

\paper {
  bookTitleMarkup = \markup \column {
    \fill-line { \fromproperty #'header:title }
    \justify-field #'header:descr
  }
}

You cannot say: \markup \justify \fromproperty #'header:descr
because \fromproperty returns a markup (in that case, it would return
a single long line), whereas \jsutify expects a markup list (typically
a list of words).

> 6. \stencil
>
> I'd like to use the dimension-arrows function from stencil.scm to
> demonstrate this, but it produces an empty stencil in the docs; output
> from a .ly file is fine. Shouldn't it work in the same way as the
> other stencil funtions, such as make-circle-stencil?

It's useful when defining markup commands, but you probably won't have
to use it otherwise (or you probably should define a markup command
when you find yourself using \stencil).

> 7. \strut
>
> I understand this is probably broken, but can anybody suggest a
> minimal example which should work to verify this?

I don't know how it is useful. But it does not seem broken, as it does
what its documentation says.
(You can use \box to see what such commands do).