From 4be1b1a2a4f475297088820279494aa12aa3859d Mon Sep 17 00:00:00 2001
From: Julien Rioux <jrioux@lyx.org>
Date: Sat, 12 Jan 2013 09:53:52 +0100
Subject: [PATCH] lilypond.lyx : Document music fragment options.

---
 lib/examples/lilypond.lyx | 39 ++++++++++++++++++++++++++++++++++++---
 1 file changed, 36 insertions(+), 3 deletions(-)

diff --git a/lib/examples/lilypond.lyx b/lib/examples/lilypond.lyx
index 737af00001..89da3bfdd6 100644
--- a/lib/examples/lilypond.lyx
+++ b/lib/examples/lilypond.lyx
@@ -41,6 +41,7 @@ lilypond
 \pdf_colorlinks true
 \pdf_backref false
 \pdf_pdfusetitle false
+\pdf_quoted_options "linkcolor=blue,urlcolor=blue,pdfstartview=XYZ"
 \papersize default
 \use_geometry true
 \use_amsmath 1
@@ -86,6 +87,10 @@ LilyPond-book and LyX
 The LyX Team
 \end_layout
 
+\begin_layout Date
+Version 2.0.x
+\end_layout
+
 \begin_layout Abstract
 This document explains and demonstrates the inclusion of musical snippets
  in a LyX document, using the LilyPond syntax for music notation and the
@@ -221,6 +226,11 @@ status open
 
 \begin_layout Plain Layout
 
+[staffsize=28]
+\end_layout
+
+\begin_layout Plain Layout
+
 
 \backslash
 relative c'' {
@@ -252,6 +262,10 @@ The previous LyX inset produces the following LaTeX-lookalike code:
 begin{lilypond}
 \end_layout
 
+\begin_layout LyX-Code
+[staffsize=28]
+\end_layout
+
 \begin_layout LyX-Code
 
 \backslash
@@ -273,8 +287,27 @@ end{lilypond}
 \end_layout
 
 \begin_layout Standard
-This code is not, in fact, processed by LaTeX, but is preprocessed by LilyPond-b
-ook, which creates the graphics files and includes them in the LaTeX document
+What appear first inside square brackets are options to pass to LilyPond-book.
+ Here, we set the dimension of the staff to 28
+\begin_inset space \thinspace{}
+\end_inset
+
+pt.
+ Other options can be added by separating them by a comma, for example:
+ 
+\family typewriter
+[staffsize=28,verbatim]
+\family default
+.
+ A list of music fragment options is available in the LilyPond documentation.
+ This whole block can be omitted when the default settings are desired.
+\end_layout
+
+\begin_layout Standard
+What follows after the options block is the textual representation in LilyPond
+ syntax of a musical fragment.
+ This code is not, in fact, processed by LaTeX, but is preprocessed by LilyPond-
+book, which creates the graphics files and includes them in the LaTeX document
  by replacing the above with a 
 \family typewriter
 
@@ -304,7 +337,7 @@ status open
 
 \begin_layout Plain Layout
 
-
+[staffsize=12] 
 \backslash
 markup { 
 \backslash