NR 1.6.2 Staff symbol - review

 - move 'line-positions and 'width to NR 5.3

diff --git a/Documentation/user/changing-defaults.itely b/Documentation/user/changing-defaults.itely
index 42355f16b2b4b5739dcb0f61c5d76f6389382848..da6caa23ac8bf574343a273b615865ff73223ab5 100644 (file)
--- a/Documentation/user/changing-defaults.itely
+++ b/Documentation/user/changing-defaults.itely
@@ -1664,6 +1664,7 @@ property (modified with @code{\set}) was created.
 * Input modes::
 * Direction and placement::
 * Distances and measurements::
 * Input modes::
 * Direction and placement::
 * Distances and measurements::

+* Staff symbol properties::

 * Spanners::
 * Visibility of objects::
 * Line styles::
 * Spanners::
 * Visibility of objects::
 * Line styles::


@@ -1920,6 +1921,46 @@ Notation Reference:
 @ref{Setting the staff size}.
 
 
 @ref{Setting the staff size}.
 
 

+@node Staff symbol properties
+@subsection Staff symbol properties
+
+@cindex adjusting staff symbol
+@cindex drawing staff symbol
+@cindex staff symbol, setting of
+
+@c TODO Extend or remove this section.  See also NR 1.6.2 Staff symbol
+@c      Need to think of uses for these properties.  Eg 'line-positions
+@c      is used in a snippet to thicken centre line.
+@c      If retained, add @ref to here in 1.6.2  -td
+
+The vertical position of staff lines and the number of staff lines
+can be defined at the same time.  As the following example shows,
+note positions are not influenced by the staff line positions.
+
+@warning{The @code{'line-positions} property overrides the
+@code{'line-count} property.  The number of staff lines is
+implicitly defined by the number of elements in the list of values
+for @code{'line-positions}.}
+
+@lilypond[verbatim,quote,relative=1]
+\new Staff \with {
+  \override StaffSymbol #'line-positions = #'(7 3 0 -4 -6 -7)
+}
+{ a4 e' f b | d1 }
+@end lilypond
+
+The width of a staff can be modified.  The units are staff
+spaces.  The spacing of objects inside the staff is not affected by
+this setting.
+
+@lilypond[verbatim,quote,relative=1]
+\new Staff \with {
+  \override StaffSymbol #'width = #23
+}
+{ a4 e' f b | d1 }
+@end lilypond
+
+

 @node Spanners
 @subsection Spanners
 
 @node Spanners
 @subsection Spanners
 

diff --git a/Documentation/user/staff.itely b/Documentation/user/staff.itely
index 90ecb279de860a66a6301973dec0b5f8e88ccda1..f567b559e9d3282db251382bb6f26b8a743567ee 100644 (file)
--- a/Documentation/user/staff.itely
+++ b/Documentation/user/staff.itely
@@ -380,8 +380,6 @@ The lines of a staff belong to the @code{StaffSymbol} grob.
 appearance of a staff, but they must be modified before the staff
 is created.
 
 appearance of a staff, but they must be modified before the staff
 is created.
 

-@c FIXME most of this section should be moved to NR 5.3 or moved to LSR -td
-

 The number of staff lines may be changed.  The clef position and
 the position of middle C may need to be modified to fit the new
 staff.  For an explanation, refer to the snippet section in
 The number of staff lines may be changed.  The clef position and
 the position of middle C may need to be modified to fit the new
 staff.  For an explanation, refer to the snippet section in


@@ -394,22 +392,6 @@ staff.  For an explanation, refer to the snippet section in
 { d4 d d d }
 @end lilypond
 
 { d4 d d d }
 @end lilypond
 

-The vertical position of staff lines and the number of staff lines
-can be defined at the same time.  As the following example shows,
-note positions are not influenced by the staff line positions.
-
-@warning{The @code{'line-positions} property overrides the
-@code{'line-count} property.  The number of staff lines is
-implicitly defined by the number of elements in the list of values
-for @code{'line-positions}.}
-
-@lilypond[verbatim,quote,relative=1]
-\new Staff \with {
-  \override StaffSymbol #'line-positions = #'(7 3 0 -4 -6 -7)
-}
-{ a4 e' f b | d1 }
-@end lilypond
-

 Staff line thickness can be modified.  The thickness of ledger
 lines and stems are also affected, since they depend on staff line
 thickness.
 Staff line thickness can be modified.  The thickness of ledger
 lines and stems are also affected, since they depend on staff line
 thickness.


@@ -441,17 +423,6 @@ affects the spacing of ledger lines as well.
 { a4 b c d }
 @end lilypond
 
 { a4 b c d }
 @end lilypond
 

-The width of a staff can be modified.  The units are staff
-spaces.  The spacing of objects inside the staff is not affected by
-this setting.
-
-@lilypond[verbatim,quote,relative=1]
-\new Staff \with {
-  \override StaffSymbol #'width = #23
-}
-{ a4 e' f b | d1 }
-@end lilypond
-

 Further details about the properties of @code{StaffSymbol} can be
 found in @rinternals{staff-symbol-interface}.
 
 Further details about the properties of @code{StaffSymbol} can be
 found in @rinternals{staff-symbol-interface}.