to this scheme construct. ie
\set Staff.instrumentName = #"cello"
+* All engravers should have double-quotes around them:
+ \consists "Spans_arpeggio_engraver"
+ Again, LilyPond does not strictly require this, but it is a
+ useful standard to follow.
+
* Examples should end with a complete bar if possible.
* If possible, only write one bar per line. The notes on each
in print. Please create a smaller example. (the smaller
example does not need to be minimal, however)
+* Specify durations for at least the first note of every bar.
+
+* If possible, end with a complete bar.
+
+* Comments should go on their own line, and be placed before the
+ line(s) to which they refer.
+
+* If you only have one bar per line, omit bar checks. If you
+ put more than one bar per line (not recommended), then include
+ bar checks.
+
* If you want to work on an example outside of the manual (for
easier/faster processing), use this header:
* Use two spaces after a period.
+* In examples of syntax, use @var{musicexpr} for a music
+ expression.
+
* Variables or numbers which consist of a single character
(probably followed by a punctuation mark) should be tied
properly, either to the previous or the next word. Example:
Do not compress vertically like this.
@code{} - typeset in a tt-font. Use for actual lilypond code or
- property/context names.
+ property/context names. If the name contains a space, wrap
+ the entire thing inside @w{@code{ }}.
@notation{} - refers to pieces of notation, e.g.
"@notation{cres.}". Also use to specific lyrics ("the
@notation{A - men} is centered")
@q{} - Single quotes. Used for `vague' terms.
@qq{} - Double quotes. Used for actual quotes ("he said").
-@warning{}: produces a "Note: " box. Use for important
- messages.
-
@tie{} - Variables or numbers which consist of a single character
(probably followed by a punctuation mark) should be tied
properly, either to the previous or the next word. Example:
"The letter@tie{}@q{I} is skipped"
@var - Use for variables.
-@warning{} - produces a "Note: " box.
- Any `\' used inside this must be written as `\\'.
+@warning{} - produces a "Note: " box. Use for important messages.
+
+@bs - Generates a backslash inside @warning.
+ Any `\' used inside @warning (and @q or @qq) must be written as `@bs{}'
+ (texinfo would also allow \\, but this breaks with PDF output).