NR 1.8.2.6 Multi-page markups

diff --git a/Documentation/user/text.itely b/Documentation/user/text.itely
index 8b554aeeb55da1786b602058b17b6c6124e88447..07b926c080d46ca39d05679c3631d829e756eb04 100644 (file)
--- 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