The most extensive issue is that with most commands, no unit of
measurement is given for certain arguments, leaving the user to guess
(I guess that it’s usually staff spaces, but I’m not sure…). These
commands are the following: (sometimes I add the number of arguments
concerned in brackets; for */** see below)
FONT SECTION
– \abs-fontsize (of course the unit is 1pt)
ALIGN
– \fill-with-pattern (1)
– \general-align (*)
– \halign (*)
– \hcenter-in
– \hspace
– \lower
– \pad-around
– \pad-markup
– \pad-to-box (2 pairs)
– \pad-x
(\raise is the only positive exception, although the description might
be a bit too lenghty)
– \translate
– \translate-scaled
– \vspace
GRAPHIC
– \beam (3)
– \draw-circle (2)
– \draw-dashed-line (**)
– \draw-dotted-line (**)
– \draw-line (**)
– \epsfile
– \filled-box (2)
– \path (2)
(– \postscript)
MUSIC
– \customTabClef (1)
OTHER
– \pattern (1)
– \with-dimensions (2)
* the unit of the /dir/ argument is half the extent of the markup in
/axis/ direction (isn’t it?)
** add a description like “/dest/ gives the #'(x . y) coordinates of
the end of the line, which will begin at #'(0 . 0)”
Some other annotations of mine:
– For what I know of typography, \caps should actually have a
different meaning from \smallCaps (THAT IS TO SAY, WITH EVERY LETTER
BEING A LARGE CAPITAL), and having them as synonyms tends to be
confusing.
– For several of the used properties, such as thickness, baseline-skip
and font-size, it might also be unclear which unit they are using. I
don’t know the right place to put this information, though.
– Naming convention: nearly all markup commands have \command-name.
Exceptions: \customTabClef should probably be renamed to
\custom-tab-clef, and \epsfile to \eps-file (much better to read and
easy to convert)
– \pad-around and \pad-markup are duplicates, as far as I can see.
Perhaps it would be better to have just one of them? (I’d vote for the
former)
– The list entry for \fill-line should probably begin |
\fill-line| markups (markup list)
instead of
|\fill-line| args (markup list), in order to be consistent with the
description.
– Does \arrow-head have a font-size property or another facility to
change the size?
– The description for \customTabClef seems too short.
– The \accidental and \fermata commands also use the font-size
property, I should think?
– \markletter: Perhaps it would be easier to describe it as “the same
as \markalphabet with letter I being skipped.”
– The description for \on-the-fly should contain a link to the list of
available procedures, namely
<http://lilypond.org/doc/v2.18/Documentation/notation/custom-titles-headers-and-footers#index-_005con_002dthe
_002dfly-1> or similar.