]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/lilypond.tely
* tex/GNUmakefile (TEX_FILES): add texinfo.cnf
[lilypond.git] / Documentation / user / lilypond.tely
index 37bcbf4c975deb7177d6f638463bd3a2a3328e9d..d9e2bb68033ea0a1a9267292a8c9845d96042465 100644 (file)
@@ -1,4 +1,4 @@
-\input texinfo @c -*-texinfo-*-
+\input texinfo @c -*- coding: latin-1; mode: texinfo; -*-
 @setfilename lilypond.info
 @settitle GNU LilyPond
 @iftex
@@ -6,8 +6,7 @@
 @end iftex
 
 @ignore
-@c FIXME: use `make install-info'
-Distributions will want to install lilypond.info doing:
+Distributions will want to install lilypond.info in postinstall, doing:
 
     install-info --info-dir=/usr/share/info out/lilypond.info
     
@@ -15,17 +14,18 @@ Distributions will want to install lilypond.info doing:
 
 @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)Running LilyPond.      Invoking the
+@c  LilyPond  program.
+* 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
 
 
@@ -43,24 +43,38 @@ Distributions will want to install lilypond.info doing:
 
 HINTS FOR STYLE
 
-* don't refer to LilyPond in the text. The reader knows what the
-manual is about
+* Do not forget to create @cindex entries for new sections of text.
 
-* if you do, capitalization is LilyPond.
+* Try not to use punctuation between introductocing sentence and
+display material (verbatim, music, example code).
 
+* Do not refer to LilyPond in the text.  The reader knows what the
+manual is about.
 
-* don't explicitly refer to the reader/user.  There is no one else
+* If you do, capitalization is LilyPond.
+
+* 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
 
@@ -70,13 +84,20 @@ PostScript} and @uref{../lilypond.pdf,PDF}.
 @end ifhtml
 
 
+@documentlanguage en
+@documentencoding ISO-8859-1
+
+@syncodeindex fn cp
+@syncodeindex ky cp
+@syncodeindex pg cp
+@syncodeindex tp cp
+@syncodeindex vr cp
+
+
 @titlepage
 @title GNU LilyPond
 @subtitle The music typesetter
-@author Han-Wen Nienhuys
-@author Jan Nieuwenhuizen
-@author J@"{u}rgen Reuter
-@author Rune Zedeler
+@author The LilyPond development team
 
 
 
@@ -91,22 +112,23 @@ Copyright @copyright{} 1999--2004 by the authors
 
 @vskip 20pt
 
-  
+@c Not yet debugged or reported.  This crashes gs-8.01:
+@c compiling gs-8.01 right now... -- jcn
 @lilypond[raggedright]
 \score {
-    \context Lyrics \notes {
+    \context Lyrics {
         \override Score.RehearsalMark   #'self-alignment-X = #LEFT
+        \override Score.RehearsalMark   #'font-size = #-2 
         \mark #(ly:export (string-append
              "(For LilyPond version " (lilypond-version) ")"))
         s2
      }
-     \paper {
+     \layout {
          indent = 0.0\pt
          raggedright = ##t
      }
 }
 @end lilypond
-  
 
 @end titlepage
 
@@ -131,7 +153,7 @@ Copyright 1999--2004 by the authors
 @top GNU LilyPond --- The music typesetter
 @c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
 
-This is the user manual for GNU LilyPond 2.1.x series.
+This is the user manual for GNU LilyPond 2.3.x series.
 @ifhtml
 (See the bottom of this page for the exact version number).
 @end ifhtml
@@ -148,17 +170,22 @@ this and other documentation.
 * Preface::                        Preface.
 * Introduction::                   What, Why, How.
 * Tutorial::                       A tutorial introduction.
+* Example templates::              Larger examples
 * Notation manual::                All notation supported, and how to
                                    produce it.
-* Literature list::                Books about notation and engraving.
-* Technical manual::               How it all works.
-* Invoking LilyPond::              Operation.
+* Sound::                          Producing MIDI output
+* Changing defaults::              Tuning output.
+* Interfaces for programmers::
+* Running 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::
-* Cheat sheet::     
+* Integrating text and music::     Integrating text and music with lilypond-book.
+* Literature list::
+* Scheme tutorial::
+* Notation manual details::
+* Point and click::             
+* Unified index::
 * GNU Free Documentation License:: FDL.
+* Cheat sheet::     
 @end menu
 @end ifnottex
 
@@ -169,22 +196,31 @@ this and other documentation.
 @include preface.itely
 @include introduction.itely 
 @include tutorial.itely
-@include refman.itely
-@include literature.itely
-@include internals.itely
-@include invoking.itexi
+@include examples.itely
+@include invoking.itely
+@include notation.itely
+@include sound-output.itexi
+@include changing-defaults.itely
+@include programming-interface.itely
 @include lilypond-book.itely
 @include converters.itely
 
 
 @c FIXME: Index has two alphabetically sorted lists @code vs plain?
+
+
+@include literature.itely
+@include scheme-tutorial.itely
+@include notation-appendices.itely
+@include point-and-click.itely
+
 @node Unified index
-@unnumbered Unified index
+@appendix Unified index
 
 @printindex cp
 
-@include appendices.itely
-@include cheatsheet.itely
 @include fdl.itexi
 
+@include cheatsheet.itely
+
 @bye