* tex/GNUmakefile (TEX_FILES): add texinfo.cnf

[lilypond.git] / Documentation / user / lilypond-book.itely

diff --git a/Documentation/user/lilypond-book.itely b/Documentation/user/lilypond-book.itely
index 5c549ddc5137ddbce02dda30fb89ec3c045cadd3..56a3a013c15196790ea6d3b7ab8245bc15bf6f63 100644 (file)
--- a/Documentation/user/lilypond-book.itely
+++ b/Documentation/user/lilypond-book.itely
@@ -1,4 +1,5 @@
-@c -*-texinfo-*-
+@c -*- coding: latin-1; mode: texinfo; -*-
+   
 
 @ignore
 
@@ -38,7 +39,8 @@ documents.
 * Integrating LaTeX and music::  
 * Integrating HTML and music::  
 * Music fragment options::      
-* Invoking lilypond-book::      
+* Invoking lilypond-book::
+* Filename extensions::
 @end menu
 
 
@@ -158,7 +160,7 @@ Larger examples can be put in a separate file, and introduced with
 @node Integrating LaTeX and music
 @section Integrating LaTeX and music
 
-La@TeX{} is the de facto standard for publishing papers in the exact
+La@TeX{} is the de facto standard for publishing layouts in the exact
 sciences. It is built on top of the @TeX{} typesetting engine, so it
 provides the best typography available anywhere.
  
@@ -329,7 +331,7 @@ music, so you can make a HTML document with embedded music.
 Music is entered using
 
 @example
-<lilypond relative=1 verbatim>
+<lilypond relative=2 verbatim>
   \key c \minor r8 c16 b c8 g as c16 b c8 d | g,4
 </lilypond>
 @end example
@@ -337,7 +339,8 @@ Music is entered using
 @noindent
 of which lilypond-book will produce a HTML with appropriate image tags for the
 music fragments:
- 
+
+@c  why the second example?  -gp
 @example
 <lilypond relative=2 verbatim>
   \key c \minor r8 c16 b c8 g as c16 b c8 d | g,4
@@ -353,6 +356,7 @@ For inline pictures, use @code{<lilypond ... />} syntax, e.g.
 Some music in <lilypond a b c/> a line of text.
 @end example
 
+@c  FIXME: check if this feature is coming soon; if not, @ignore this stuff.
 A special feature not (yet) available in other output formats, is the
 @code{<lilypondfile>} tag, for example,
 @example
@@ -408,7 +412,7 @@ adds some boilerplate code, so you can enter like
 @end example 
 
 @noindent
-without @code{\paper}, @code{\score} or other red tape.
+without @code{\layout}, @code{\score} or other red tape.
 
 @item indent=@var{size}\@var{unit}
 sets indentation of the first music system to @var{size},
@@ -465,9 +469,20 @@ that directory before running La@TeX{} or @file{makeinfo}:
 
 @example
 lilypond-book --output=out yourfile.lytex
-cd out && latex yourfile.tex
+cd out
 @end example
 
+This will produce a .tex or .texi file.  To produce a pdf from the
+.tex file, you should do
+
+@example
+latex yourfile.tex
+dvips -Ppdf -u+ec-mftrace.map -u+lilypond.map yourfile.dvi
+ps2pdf yourfile.ps
+@end example
+
+To produce a texinfo document (in any output format), follow the normal
+procedures for texinfo.
 
 @command{lilypond-book} accepts the following command line options:
 
@@ -528,3 +543,23 @@ The size of a music block is limited to 1.5 KB, due to technical
 problems with the Python regular expression engine.  For longer files,
 use @code{\lilypondfile}.
 
+
+@node Filename extensions
+@section Filename extensions
+
+You can use any filename extension, but if you do not use the
+recommended extension, you may need to manually specify what output
+format you want.  See @ref{Invoking lilypond-book} for details.
+
+@code{Lilypond-book} automatically selects the output format based
+on the filename.
+
+@table @code
+
+@item @emph{.html} produces html output
+
+@item @emph{.itely} produces texinfo output
+
+@item @emph{.lytex} produces latex output
+
+@end table