* Documentation/user/global.itely (Vertical spacing): document

alignment-extra-space and fixed-alignment-extra-space.

* Documentation/topdocs/NEWS.tely (Top): add entry.

diff --git a/ChangeLog b/ChangeLog
index 2b47d146bf06a09e0775c16f9158b64e3c08902f..65c841882fe0507f75be4eb7ebc0a1ca1c9a3371 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
 2005-10-03  Han-Wen Nienhuys  <hanwen@xs4all.nl>
 
+       * Documentation/user/global.itely (Vertical spacing): document
+       alignment-extra-space and fixed-alignment-extra-space.
+
+       * Documentation/topdocs/NEWS.tely (Top): add entry.
+
        * input/regression/alignment-vertical-spacing.ly: new file.
 
        * python/convertrules.py (conv): add rule.

diff --git a/Documentation/topdocs/NEWS.tely b/Documentation/topdocs/NEWS.tely
index 4d50e397da3519123a42e1e55d05815bfa6ad649..c902799d1c97d26ab36e05cbd5678a5fc8bdfae0 100644 (file)
--- a/Documentation/topdocs/NEWS.tely
+++ b/Documentation/topdocs/NEWS.tely
@@ -46,9 +46,34 @@ This document is also available in @uref{NEWS.pdf,PDF}.
 
 @itemize @bullet
 @item  
-Vertical alignments of staves may be tuned for individual systems
-easily.
+Vertical alignments of staves can now be tuned easily for individual
+systems.
+
+@lilypond[raggedright]
+#(set-global-staff-size 13)
+\relative c'' <<
+  \new PianoStaff <<
+    \new Voice  {
+      \set PianoStaff.instrument = #"piano"
+      \set PianoStaff.instr = #"pn"
+      c1_"normal"
+      
+      \overrideProperty
+      #"Score.NonMusicalPaperColumn"
+      #'line-break-system-details
+      #'((fixed-alignment-extra-space . 15))
+      c
+
+    }
+    { 
+        c1\break 
+        c\break 
+    }
+  >>
+>>
+@end lilypond
 
+This feature was sponsored by Nicolas Sceaux.
 
 @item 
 Vertical spacing for page layout can now be tuned for each system
@@ -62,7 +87,7 @@ individually.  The dimensions that can be tuned can be visualized.
 }
 @end lilypond
 
-This feature was sponsored by Trevor Bača and Nicolas Sceaux.
+These features were sponsored by Trevor Bača and Nicolas Sceaux.
 
 @item
 The slope of a stem-tremolo may be set manually

diff --git a/Documentation/user/global.itely b/Documentation/user/global.itely
index 67d301ba035cee86f5b75e277bb5a846b333bbf8..fecb28f8dd0835e0e9fbda92b31e79ce3ce32d53 100644 (file)
--- a/Documentation/user/global.itely
+++ b/Documentation/user/global.itely
@@ -483,6 +483,8 @@ systems from bumping into each other, some minimum distances are set.
 By changing these, you can put staves closer together, and thus put
 more systems onto one page.
 
+@c TODO: junk explanation of minimumVerticalExtent
+
 Normally staves are stacked vertically.  To make staves maintain a
 distance, their vertical size is padded.  This is done with the
 property @code{minimumVerticalExtent}.  It takes a pair of numbers, so
@@ -500,6 +502,40 @@ either side of the center staff line.  The argument of
 center line is the 0, so the first number is generally negative.  The
 staff can be made larger at the bottom by setting it to @code{(-6 . 4)}. 
 
+The spacing of staves in a system may also be tuned per system.  This is
+done with the command
+
+@example
+\overrideProperty
+#"Score.NonMusicalPaperColumn"
+#'line-break-system-details
+#'((alignment-extra-space . 15))
+@end example
+
+@noindent
+at the line break before the system to be changed. The distance
+@code{15} is distributed over all staves that have a fixed distance
+alignment.  For example,
+
+@lilypond[raggedright, fragment, relative=2, staffsize=13]
+\new StaffGroup <<
+  \new Staff { 
+    c1\break 
+        
+    \overrideProperty
+    #"Score.NonMusicalPaperColumn"
+    #'line-break-system-details
+    #'((fixed-alignment-extra-space . 15))
+
+    c\break 
+  }
+  \new Staff { c c }
+>>
+@end lilypond
+
+The distance for @code{alignment-extra-space} may also be negative.
+
+
 To change the amount of space between systems, use
 @code{betweensystemspace}.  A score with only one staff is still
 considered to have systems, so setting @code{betweensystemspace}
@@ -535,7 +571,7 @@ will graphically indicate the dimensions of properties that may be set
 for page spacing,
 
 @lilypond[verbatim]
-#(set-default-paper-size "a6")
+#(set-default-paper-size "a7" 'landscape)
 \paper { annotatespacing = ##t }
 { c4 }
 @end lilypond
@@ -588,7 +624,7 @@ measured from the center line of each staff.
 
 The difference is demonstrated in the following example,
 @lilypond[quote,verbatim]
-\relative <<
+\relative c'' <<
   \new PianoStaff \with {
     \override VerticalAlignment #'forced-distance = #7
   } <<
@@ -603,10 +639,40 @@ The difference is demonstrated in the following example,
 @end lilypond
 
 
+It is also possible to change the distance between for each system
+individually.  This is done by including the command 
 
-@refbugs
+@example
+\overrideProperty
+#"Score.NonMusicalPaperColumn"
+#'line-break-system-details
+#'((fixed-alignment-extra-space . 15))
+@end example
+
+@noindent
+at the line break before the system to be changed. The distance
+@code{15} is distributed over all staves that have a fixed distance
+alignment.  For example,
+
+@lilypond[raggedright, fragment, relative=2, staffsize=13]
+\new PianoStaff <<
+  \new Staff { 
+    c1\break 
+        
+    \overrideProperty
+    #"Score.NonMusicalPaperColumn"
+    #'line-break-system-details
+    #'((fixed-alignment-extra-space . 15))
+
+    c\break 
+  }
+  \new Staff { c c }
+>>
+@end lilypond
+
+The distance for @code{fixed-alignment-extra-space} may also be
+negative.
 
-@code{forced-distance} cannot be changed per system.
 
 @node Horizontal spacing
 @subsection Horizontal Spacing