Added more docs for lilypond-book

diff --git a/ChangeLog b/ChangeLog
index a423e6bda688dfbf3e9b64793dd407c89be3a96a..925cb60a787a3d9643712431c46c480815de7db1 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2004-10-13  Graham Percival  <gperlist@shaw.ca>
+
+       * Documentation/user/examples.itely: added lilypond-book template.
+
+       * Documentation/user/lilypond-book.itely: added filename extension page.
+
 2004-10-13  Jan Nieuwenhuizen  <janneke@gnu.org>
 
        * debian/rules (binary-indep): Link images for info.

diff --git a/Documentation/user/examples.itely b/Documentation/user/examples.itely
index cb36c0c3cf17a258937ba3139ae9d27d4c7b09cd..a1d72cf0fa1de96a7293ee5b3528b749e633682b 100644 (file)
--- a/Documentation/user/examples.itely
+++ b/Documentation/user/examples.itely
@@ -16,6 +16,7 @@ beautiful printed scores!
 * Ancient notation templates::
 * Jazz combo::
 * Other templates::
+* Lilypond-book templates::
 @end menu
 
 @c TODO explain \score{} ?  Maybe add a note to the tutorial?
@@ -1189,3 +1190,46 @@ gcdg = { \grace { g'32[ c' d']  } }
 @end lilypond
 
 
+@node Lilypond-book templates
+@section Lilypond-book templates
+
+These templates are for use with @code{lilypond-book}.  If you're not familiar
+with this program, please refer to @ref{Integrating text and music}.
+
+@subsection LaTeX
+
+You can include LilyPond fragments in a LaTeX document.
+
+@example
+\documentclass[]@{article@}
+\begin@{document@}
+
+Normal LaTeX text.
+
+\begin@{lilypond@}
+\relative c'' @{
+a4 b c d
+@}
+\end@{lilypond@}
+
+More LaTeX text.
+
+\begin@{lilypond@}
+\relative c'' @{
+d4 c b a
+@}
+\end@{lilypond@}
+\end@{document@}
+@end example
+
+@subsection Texinfo
+
+You can include LilyPond fragments in texinfo; in fact, this entire manual
+is written in texinfo.
+
+TODO: obviously to fill in the example.  :)  -gp
+
+@example
+
+@end example
+

diff --git a/Documentation/user/lilypond-book.itely b/Documentation/user/lilypond-book.itely
index 83946e378bad9d323c0b1439de5927860ede0e73..e2d1f939b34640289b0458808ab9ea37a45e95f1 100644 (file)
--- a/Documentation/user/lilypond-book.itely
+++ b/Documentation/user/lilypond-book.itely
@@ -38,7 +38,8 @@ documents.
 * Integrating LaTeX and music::  
 * Integrating HTML and music::  
 * Music fragment options::      
-* Invoking lilypond-book::      
+* Invoking lilypond-book::
+* Filename extensions::
 @end menu
 
 
@@ -528,3 +529,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