From 2dea932e8dccfa639760952fa9451df4c01076b6 Mon Sep 17 00:00:00 2001
From: Han-Wen Nienhuys <hanwen@xs4all.nl>
Date: Fri, 20 Oct 2006 18:39:12 +0000
Subject: [PATCH] * Documentation/user/page.itely (Displaying spacing): use
 \book explicitly, so arrows show . (Line breaking): add note about
 Forbid_line_break_engraver

* Documentation/user/tweaks.itely (Common tweaks): also set length
to prevent tie squeezing.
(Default files): use @var{}

* Documentation/user/converters.itely (Invoking abc2ly): remove mup2ly.
(Generating LilyPond files): add FOMUS.
---
 ChangeLog                           |  9 +++++++++
 Documentation/user/converters.itely |  3 +++
 Documentation/user/page.itely       | 31 +++++++++++++++++++++++++----
 Documentation/user/tweaks.itely     | 27 +++++++++++++++++++------
 4 files changed, 60 insertions(+), 10 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 0deb4c0220..6ca0e40326 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,6 +1,15 @@
 2006-10-20  Han-Wen Nienhuys  <hanwen@lilypond.org>
 
+	* Documentation/user/page.itely (Displaying spacing): use \book
+	explicitly, so arrows show .
+	(Line breaking): add note about Forbid_line_break_engraver
+
+	* Documentation/user/tweaks.itely (Common tweaks): also set length
+	to prevent tie squeezing. 
+	(Default files): use @var{}
+
 	* Documentation/user/converters.itely (Invoking abc2ly): remove mup2ly.
+	(Generating LilyPond files): add FOMUS.
 
 2006-10-20  Joe Neeman  <joeneeman@gmail.com>
 
diff --git a/Documentation/user/converters.itely b/Documentation/user/converters.itely
index 02fd2efc64..7ba2816ab2 100644
--- a/Documentation/user/converters.itely
+++ b/Documentation/user/converters.itely
@@ -274,5 +274,8 @@ which imports @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}
 @item
 @uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden},
 which imports MIDI
+@item
+@uref{http://@/common-lisp@/.net/project/fomus/,FOMUS},
+a LISP library to generate music notation 
 @end itemize
 
diff --git a/Documentation/user/page.itely b/Documentation/user/page.itely
index c555384ef3..74a09ecec6 100644
--- a/Documentation/user/page.itely
+++ b/Documentation/user/page.itely
@@ -1012,6 +1012,21 @@ c4 c2 c4 ~ \break % as does this break
 c4 c2 c4
 @end lilypond
 
+To allow line breaks on such bar lines, the
+@code{Forbid_line_break_engraver} can be removed from @code{Voice}
+context, like so
+
+
+@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+\new Voice \with {
+  \remove "Forbid_line_break_engraver"
+} {
+  c4 c2 c2 \break   % now the break is allowed
+  c2 c4
+}
+@end lilypond
+
+
 
 @node Page breaking
 @subsection Page breaking
@@ -1144,14 +1159,22 @@ than one, they will interfere with each other.
 @funindex annotate-spacing
 @cindex Spacing, display of properties
 
-To graphically display the dimensions of vertical properties
-that may be altered for page formatting, use
+To graphically display the dimensions of vertical properties that may
+be altered for page formatting, set @code{annotate-spacing} in the
+@code{\paper} block, like this
+
 
 @lilypond[verbatim]
-\paper { annotate-spacing = ##t }
-{ c4 }
+#(set-default-paper-size "a6" 'landscape)
+
+\book {
+  \score { { c4 } }
+  \paper { annotate-spacing = ##t }
+}
 @end lilypond
 
+@c need to have \book{} otherwise we get  the separate systems. -hwn
+
 @noindent
 @c  FIXME: really bad vagueness due to bug in annotate-spacing.  -gp
 Some unit dimensions are measured in staff spaces, while others
diff --git a/Documentation/user/tweaks.itely b/Documentation/user/tweaks.itely
index ea839d1113..bbef69b00b 100644
--- a/Documentation/user/tweaks.itely
+++ b/Documentation/user/tweaks.itely
@@ -269,9 +269,24 @@ voice.  By introducing a tie in a different voice,
 and blanking the first up-stem in that voice, the tie appears to cross
 voices:
 
+
+@lilypond[quote,fragment,relative=2,verbatim]
+<< {
+  \once \override Stem #'transparent = ##t
+  b8~ b8\noBeam
+} \\ {
+  b[ g8]
+} >>
+@end lilypond
+
+To make sure that the just blanked stem doesn't sqeeuze the too much
+tie, we also lengthen the stem, by setting the @code{length} to
+@code{8},
+
 @lilypond[quote,fragment,relative=2,verbatim]
 << {
   \once \override Stem #'transparent = ##t
+  \once \override Stem #'length = #8
   b8~ b8\noBeam
 } \\ {
   b[ g8]
@@ -307,15 +322,15 @@ to understand these files.
 
 @itemize @bullet
 
-@item Linux: @file{@{INSTALLDIR@}/lilypond/usr/share/lilypond/current/}
+@item Linux: @file{@var{installdir}/lilypond/usr/share/lilypond/current/}
 
 @item OSX:
-@file{@{INSTALLDIR@}/LilyPond.app/Contents/Resources/share/lilypond/current/}.
-To access this, either @code{cd} into this directory from
-the Terminal, or control-click on the LilyPond application
-and select "Show Package Contents".
+@file{@var{installdir}/LilyPond.app/Contents/Resources/share/lilypond/current/}.
+To access this, either @code{cd} into this directory from the
+Terminal, or control-click on the LilyPond application and select
+"Show Package Contents".
 
-@item Windows: @file{@{INSTALLDIR@}/LilyPond/usr/share/lilypond/current/}
+@item Windows: @file{@var{installdir}/LilyPond/usr/share/lilypond/current/}
 
 @end itemize
 
-- 
2.39.5