Info for Documentation
----------------------
-Current version of the manual: 2.8.0
+Current version of the manual: 2.11.10 ?
*** Please update this whenever you run convert-ly on the docs.
convert-ly --from=... --to=... --no-version *.itely
* Notation Reference is a (hopefully complete) description of
LilyPond input notation. Some material from here may be
-duplicated in the Learning Manual (for teaching). This
-section is written in formal technical writing style.
+duplicated in the Learning Manual (for teaching). The
+material is presented in an approximate order of increasing
+difficulty, but the goal is _not_ to provide a step-by-step
+learning environment. For example, all material under
+"Notes" should remain in that section, even though microtonal
+accidentals may seem more advanced than info about clefs or
+time signatures -- "Notes" should be a one-stop reference
+about, well, notes. This section is written in formal
+technical writing style.
* Technical Details contains information about using
the program lilypond with other programs (lilypond-book,
GENERAL GUIDELINES
* Do not forget to create @cindex entries for new sections of text.
+ Enter commands with @funindex, i.e.
+ @funindex \relative
+ do not bother with the @code{} (they are added automatically). These
+ items are added to both the command index and the unified index.
* The use of the word `illegal' is inappropriate in most cases. Say
`invalid' instead.
* Lines should be less than 80 characters long.
+* Use @q instead of `...' and @qq instead of ``...''. The latter macro
+ should be used with care since we use `...' as the default quoting
+ throughout the manual, except for things related to direct speech.
+
%%%%%
HINTS FOR TECHNICAL WRITING STYLE