- Music glossary: @rglos{foo}, @rglos{bar}.
-
- User manual: @ref{baz}, @ref{foozle}.
-
- Snippets: @lsrdir{section}.
-
- Program reference: @internalsref{fazzle}, @internalsref{booar}.
-
- ("Snippets" is REQUIRED; the others are optional)
-
-* To create links, use @ref{} if the link is within the same
- manual. If you are linking to another manual (say,
- learning->glossary or user->program usage), then use:
- @rlearning{}
- @ruser{}
- @rprogram{}
- @rglos{}
- @internalsref{}
-
-* @commonprop and @refbugs are optional.
-
-* Do not include any real info in second-level sections (ie 1.1
- Pitches). A first-level section may have introductory material,
- but other than that all material goes into third-level sections
- (ie 1.1.1 Writing Pitches).
-
-
-%%%%% LILYPOND FORMATTING
-
-* Use two spaces for indentation in lilypond examples. (no tabs)
-
-* If possible, only write one bar per line. The notes on each
- line should be an independent line.
- Bad:
- \override textscript #'padding = #3 c1^"hi"
- Good:
- \override textscript #'padding = #3
- c1^"hi"
-
-* LilyPond input should be produce via
- @lilypond[verbatim,quote,ragged-right]
- with `fragment' and `relative=2' optional.
-
- Examples about page layout may alter the quote/ragged-right
- options. Omitting `verbatim' is not allowed.
-
-* Inspirational headwords are produced with
- @lilypondfile[ragged-right,line-width=16\cm,staffsize=16,quote]
- {pitches-headword.ly}
-
-* Avoid long stretches of input code. Noone is going to read them
- in print. Instead refer to an example input file with @lsr{}.
-
-* If you want to work on an example outside of the manual (for
- easier/faster processing), use this header:
-
-\paper {
- #(define dump-extents #t)
- indent = 0\mm
- line-width = 160\mm - 2.0 * 0.4\in
- ragged-right = ##t
- force-assignment = #""
- line-width = #(- line-width (* mm 3.000000))
-}