From da60861b490e81f84a7ed31efd22f1adcf829b96 Mon Sep 17 00:00:00 2001
From: Graham Percival <graham@percival-music.ca>
Date: Wed, 13 Oct 2004 19:39:20 +0000
Subject: [PATCH] Added more docs for lilypond-book

---
 ChangeLog                              |  6 ++++
 Documentation/user/examples.itely      | 44 ++++++++++++++++++++++++++
 Documentation/user/lilypond-book.itely | 23 +++++++++++++-
 3 files changed, 72 insertions(+), 1 deletion(-)

diff --git a/ChangeLog b/ChangeLog
index a423e6bda6..925cb60a78 100644
--- 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 cb36c0c3cf..a1d72cf0fa 100644
--- 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 83946e378b..e2d1f939b3 100644
--- 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
-- 
2.39.2