Lilypond-book: Document htmly as allowed extension for HTML

[lilypond.git] / Documentation / usage / lilypond-book.itely
diff --git a/Documentation/usage/lilypond-book.itely b/Documentation/usage/lilypond-book.itely

index 4e2aa4c5cdda3065cf632c015df77ea221fbdf28..daf9b4dcfde9e22a73f2188f4039e6dd9d50d768 100644 (file)
--- a/Documentation/usage/lilypond-book.itely
+++ b/Documentation/usage/lilypond-book.itely
@@ -4,7 +4,8 @@
      Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
  
      When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
+    version that you are working on.  For details, see the Contributors'
+    Guide, node Updating translation committishes..
  @end ignore
  
  @c \version "2.12.0"
@@ -83,13 +84,13 @@ For example,
  
  \begin{lilypond}
  \relative c' {
-  c2 g'2 \times 2/3 { f8 e d } c'2 g4
+  c2 e2 \times 2/3 { f8 a b } a2 e4
  }
  \end{lilypond}
  
  Options are put in brackets.
  
-\begin[fragment,quote,staffsize=26,verbatim]{lilypond}
+\begin{lilypond}[fragment,quote,staffsize=26,verbatim]
    c'4 f16
  \end{lilypond}
  
@@ -142,7 +143,7 @@ For example,
  
  @lilypond
  \relative c' {
-  c2 g'2 \times 2/3 { f8 e d } c'2 g4
+  c2 e2 \times 2/3 { f8 a b } a2 e4
  }
  @end lilypond
  
@@ -187,7 +188,7 @@ to use @LaTeX{}.
  Music is entered using
  
  @example
-\begin[options,go,here]@{lilypond@}
+\begin@{lilypond@}[options,go,here]
    YOUR LILYPOND CODE
  \end@{lilypond@}
  @end example
@@ -214,7 +215,7 @@ processed with @LaTeX{}.
  We show some examples here.  The @code{lilypond} environment
  
  @example
-\begin[quote,fragment,staffsize=26]@{lilypond@}
+\begin@{lilypond@}[quote,fragment,staffsize=26]
    c' d' e' f' g'2 g'2
  \end@{lilypond@}
  @end example
@@ -314,7 +315,7 @@ is trivial.
  @example
  \def\betweenLilyPondSystem#1@{\endinput@}
  
-\begin[fragment]@{lilypond@}
+\begin@{lilypond@}[fragment]
    c'1\( e'( c'~ \break c' d) e f\)
  \end@{lilypond@}
  @end example
@@ -970,6 +971,7 @@ selects the output format based on the input filename's extension.
  @item @strong{extension} @tab @strong{output format}
  @item
  @item @file{.html} @tab HTML
+@item @file{.htmly} @tab HTML
  @item @file{.itely} @tab Texinfo
  @item @file{.latex} @tab @LaTeX{}
  @item @file{.lytex} @tab @LaTeX{}
@@ -1010,16 +1012,14 @@ Normal LaTeX text.
  
  \begin@{lilypond@}
  \relative c'' @{
-a4 b c d
+  a4 b c d
  @}
  \end@{lilypond@}
  
-More LaTeX text.
+More LaTeX text, and options in square brackets.
  
-\begin@{lilypond@}
-\relative c'' @{
+\begin@{lilypond@}[fragment,relative=2,quote,staffsize=26,verbatim]
  d4 c b a
-@}
  \end@{lilypond@}
  \end@{document@}
  @end example
@@ -1030,16 +1030,19 @@ You can include LilyPond fragments in Texinfo; in fact, this entire manual
  is written in Texinfo.
  
  @example
-\input texinfo
+\input texinfo @c -*-texinfo-*-
  @@node Top
+@@top
  
  Texinfo text
  
-@@lilypond[verbatim,fragment,ragged-right]
-a4 b c d
+@@lilypond
+\relative c' @{
+  a4 b c d
+@}
  @@end lilypond
  
-More Texinfo text
+More Texinfo text, and options in brackets.
  
  @@lilypond[verbatim,fragment,ragged-right]
  d4 c b a
@@ -1049,6 +1052,38 @@ d4 c b a
  @end example
  
  
+@subsection html
+
+@example
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<!-- header_tag -->
+<HTML>
+<body>
+
+<p>
+Documents for lilypond-book may freely mix music and text.  For
+example,
+<lilypond>
+\relative c'' @{
+  a4 b c d
+@}
+</lilypond>
+</p>
+
+<p>
+Another bit of lilypond, this time with options:
+
+<lilypond fragment quote staffsize=26 verbatim>
+a4 b c d
+</lilypond>
+</p>
+
+</body>
+</html>
+
+
+@end example
+
  @subsection xelatex
  
  @verbatim