Added a working Forbid_line_break_engraver example. Fixes \#343.

diff --git a/Documentation/user/spacing.itely b/Documentation/user/spacing.itely
index bf6de012266ce265c97f0975e055f792b450b9b8..dddc5262f02ecbf8103be4d7158ed716341b34df 100644 (file)
--- a/Documentation/user/spacing.itely
+++ b/Documentation/user/spacing.itely
@@ -625,6 +625,22 @@ c4 c2 c4 ~ \break % as does this break
 c4 c2 c4
 @end lilypond
 
+This can be avoided by removing the @code{Forbid_line_break_engraver}
+and adding the line breaks in another voice:
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff <<
+  \new Voice \with {
+    \remove Forbid_line_break_engraver
+  } {
+    c'4 c'2 c'2 c'2 c'4
+  }
+  \new Voice {
+    s1 \break s1
+  }
+>>
+@end lilypond
+
 
 @node Page breaking
 @subsection Page breaking