@dircategory GNU music project
@direntry
-@c ;; prepend GNU for dir, must be unique
-* GNU LilyPond: (./lilypond/lilypond). The GNU music typesetter.
-* lilypond: (./lilypond/lilypond)Invoking LilyPond. Titling LilyPond scores.
-* Glossary: (./lilypond/music-glossary). Glossary of music terms.
-* convert-ly: (./lilypond/lilypond)Invoking convert-ly. Older LilyPond versions.
-* midi2ly: (./lilypond/lilypond)Invoking midi2ly. Importing MIDI.
-* etf2ly: (./lilypond/lilypond)Invoking etf2ly. Importing Finale.
-* abc2ly: (./lilypond/lilypond)Invoking abc2ly. Importing ABC.
-* pmx2ly: (./lilypond/lilypond)Invoking pmx2ly. Importing PMX.
-* musedata2ly: (./lilypond/lilypond)Invoking musedata2ly. Importing MuseData.
-* mup2ly: (./lilypond/lilypond)Invoking mup2ly. Importing Mup.
+@c prepend GNU for dir, must be unique
+@c do not list the `lilypond' node at toplevel, so that `info lilypond'
+@c goes to Top.
+@c * lilypond: (lilypond/lilypond)Invoking LilyPond. Titling LilyPond scores.
+* GNU LilyPond: (lilypond/lilypond). The GNU music typesetter.
+* convert-ly: (lilypond/lilypond)Invoking convert-ly. Older LilyPond versions.
+* midi2ly: (lilypond/lilypond)Invoking midi2ly. Importing MIDI.
+* etf2ly: (lilypond/lilypond)Invoking etf2ly. Importing Finale.
+* abc2ly: (lilypond/lilypond)Invoking abc2ly. Importing ABC.
+* musedata2ly: (lilypond/lilypond)Invoking musedata2ly. Importing MuseData.
+* mup2ly: (lilypond/lilypond)Invoking mup2ly. Importing Mup.
@end direntry
HINTS FOR STYLE
-* don't refer to LilyPond in the text. The reader knows what the
-manual is about
+* Try not to use punctuation between introductocing sentence and
+display material (verbatim, music, example code).
-* if you do, capitalization is LilyPond.
+* Do not refer to LilyPond in the text. The reader knows what the
+manual is about.
+* If you do, capitalization is LilyPond.
-* don't explicitly refer to the reader/user. There is no one else
+* Do not explicitly refer to the reader/user. There is no one else
besides the reader and the writer.
-* don't use abbreviations (don't, won't, etc.)
+* Do not use abbreviations (don't, won't, etc.).
-* avoid fluff (``Notice that,'' ``as you can see,'' ``Currently,'')
+* Avoid fluff (``Notice that,'' ``as you can see,'' ``Currently,'')
-* avoid long stretches of input code. Noone is go to read them in
-print. Instead refer to an example input file (@inputfileref), these
+* Avoid long stretches of input code. Noone is going to read them in
+print. Instead refer to an example input file (@inputfileref), these
are clickable in HTML.
-* abbrevs in caps, e.g. HTML, DVI, MIDI, etc.
+* Abbrevs in caps, e.g. HTML, DVI, MIDI, etc.
+
+* Colon usage
+ 0. Do not use a colon to introduce examples, sentences just continue
+
+ in the display material.
+
+ 1. To introduce lists
+ 2. When beginning a quote: "So, he said,..."
+ This usage is rarer. Americans often just use a comma.
+ 3. When adding a defining example at the end of a sentence.
@end ignore
* Tutorial:: A tutorial introduction.
* Notation manual:: All notation supported, and how to
produce it.
-* Literature list:: Books about notation and engraving.
-* Technical manual:: How it all works.
+* Changing defaults:: Tuning output.
* Invoking LilyPond:: Operation.
* Converting from other formats:: Converting to lilypond source format.
* lilypond-book manual:: Integrating text and music with lilypond-book.
* Unified index::
-* Reference manual details::
+* Notation manual details::
+* Literature list::
+* Interfaces for programmers::
* Cheat sheet::
* GNU Free Documentation License:: FDL.
@end menu
@include preface.itely
@include introduction.itely
@include tutorial.itely
-@include refman.itely
-@include literature.itely
-@include internals.itely
+@include notation.itely
+@include changing-defaults.itely
@include invoking.itexi
@include lilypond-book.itely
@include converters.itely
@printindex cp
-@include appendices.itely
+@include notation-appendices.itely
+
+@include literature.itely
+
+@include programming-interface.itely
+
@include cheatsheet.itely
+
@include fdl.itexi
@bye