From 4cc11ce36f01076b3b5e6bc93b865c612ea68036 Mon Sep 17 00:00:00 2001
From: Valentin Villenave <valentin@villenave.net>
Date: Mon, 22 Sep 2008 19:51:45 +0200
Subject: [PATCH] NR 1.8.2.6 Multi-page markups

---
 Documentation/user/text.itely | 26 +++++++++++++++++---------
 1 file changed, 17 insertions(+), 9 deletions(-)

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
-- 
2.39.5