From: Valentin Villenave <valentin@villenave.net>
Date: Mon, 22 Sep 2008 17:51:45 +0000 (+0200)
Subject: NR 1.8.2.6 Multi-page markups
X-Git-Tag: release/2.11.60-1~18
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=4cc11ce36f01076b3b5e6bc93b865c612ea68036;p=lilypond.git

NR 1.8.2.6 Multi-page markups
---

diff --git a/Documentation/user/text.itely b/Documentation/user/text.itely
index 8b554aeeb5..07b926c080 100644
--- a/Documentation/user/text.itely
+++ b/Documentation/user/text.itely
@@ -1052,27 +1052,35 @@ Snippets:
 @node Multi-page markup
 @subsubsection Multi-page markup
 
-Whereas @code{\markup} is used to enter a non-breakable block of
-text, @code{\markuplines} can be used at top-level to enter lines
-of text that can spread over multiple pages:
+Although standard markup objects are not breakable, a
+specific syntax allows to enter lines of text that can
+spread over multiple pages:
 
-@verbatim
+@lilypond[quote,verbatim]
 \markuplines {
   \justified-lines {
     A very long text of justified lines.
     ...
   }
-  \justified-lines {
+  \wordwrap-lines {
     An other very long paragraph.
     ...
   }
   ...
 }
-@end verbatim
+@end lilypond
+
+This specific syntax accepts a list of markups, that can be
+@itemize
+@item
+the result of a markup list command,
+@item
+a list of markups,
+@item
+a list of markup lists.
+@end itemize
 
-@code{\markuplines} accepts a list of markup, that is either the
-result of a markup list command, or a list of markups or of markup
-lists.  The built-in mInstrument Specific Markup	  	 arkup list commands are described in
+An exhaustive list of markup list commands can be found in
 @ref{Text markup list commands}.
 
 @seealso