NR: General tidy up - @seealso @knownissue spacing

[lilypond.git] / Documentation / notation / spacing.itely

diff --git a/Documentation/notation/spacing.itely b/Documentation/notation/spacing.itely
index 6b7f49e6bbca1395162a27ea0bf9c032e33f40f2..849b24b6c771f87e2210a59306bf146f1e832771 100644 (file)
--- a/Documentation/notation/spacing.itely
+++ b/Documentation/notation/spacing.itely
@@ -365,7 +365,6 @@ Snippets:
 @rlsr{Spacing}.
 
 @knownissues
 @rlsr{Spacing}.
 
 @knownissues

-

 The titles (from the @code{\header} block) are treated as a
 system, so @code{ragged-bottom} and @code{ragged-last-bottom} will
 add space between the titles and the first system of the score.
 The titles (from the @code{\header} block) are treated as a
 system, so @code{ragged-bottom} and @code{ragged-last-bottom} will
 add space between the titles and the first system of the score.


@@ -680,7 +679,6 @@ Installed Files:
 @file{ly/paper-defaults-init.ly}.
 
 @knownissues
 @file{ly/paper-defaults-init.ly}.
 
 @knownissues

-

 Explicitly defined paper-sizes will override any user-defined left or
 right margin settings.
 
 Explicitly defined paper-sizes will override any user-defined left or
 right margin settings.
 


@@ -991,7 +989,6 @@ sensible default, for example:
 
 @end table
 
 
 @end table
 

-

 @seealso
 Installed Files:
 @file{ly/titling-init.ly}.
 @seealso
 Installed Files:
 @file{ly/titling-init.ly}.


@@ -999,9 +996,7 @@ Installed Files:
 Snippets:
 @rlsr{Spacing}.
 
 Snippets:
 @rlsr{Spacing}.
 

-

 @knownissues
 @knownissues

-

 The default page header puts the page number and the @code{instrument}
 field from the @code{\header} block on a line.
 
 The default page header puts the page number and the @code{instrument}
 field from the @code{\header} block on a line.
 


@@ -1078,7 +1073,6 @@ Here is an example @code{\layout} block:
 @}
 @end example
 
 @}
 @end example
 

-

 @seealso
 Notation Reference:
 @ref{Changing context default settings}.
 @seealso
 Notation Reference:
 @ref{Changing context default settings}.


@@ -1180,7 +1174,6 @@ These fonts are available in any sizes.  The context property
 @rinternals{StaffSymbol}) can be used to tune the size for individual
 staves.  The sizes of individual staves are relative to the global size.
 
 @rinternals{StaffSymbol}) can be used to tune the size for individual
 staves.  The sizes of individual staves are relative to the global size.
 

-

 @seealso
 Notation Reference:
 @ref{Selecting notation font size}.
 @seealso
 Notation Reference:
 @ref{Selecting notation font size}.


@@ -1188,9 +1181,7 @@ Notation Reference:
 Snippets:
 @rlsr{Spacing}.
 
 Snippets:
 @rlsr{Spacing}.
 

-

 @knownissues
 @knownissues

-

 @code{layout-set-staff-size} does not change the distance between the
 staff lines.
 
 @code{layout-set-staff-size} does not change the distance between the
 staff lines.
 


@@ -1329,7 +1320,6 @@ complicated.  More details are available in
 @code{\noBreak}.
 @endpredefined
 
 @code{\noBreak}.
 @endpredefined
 

-

 @seealso
 Notation Reference:
 @ref{\paper variables for line breaking}.
 @seealso
 Notation Reference:
 @ref{\paper variables for line breaking}.


@@ -1414,7 +1404,6 @@ book parts.
 @code{\noPageBreak}.
 @endpredefined
 
 @code{\noPageBreak}.
 @endpredefined
 

-

 @seealso
 Notation Reference:
 @ref{\paper variables for page breaking}.
 @seealso
 Notation Reference:
 @ref{\paper variables for page breaking}.


@@ -1433,7 +1422,6 @@ determining page breaks.  It attempts to find a page breaking that minimizes
 cramping and stretching, both horizontally and vertically.  Unlike
 @code{ly:page-turn-breaking}, it has no concept of page turns.
 
 cramping and stretching, both horizontally and vertically.  Unlike
 @code{ly:page-turn-breaking}, it has no concept of page turns.
 

-

 @seealso
 Snippets:
 @rlsr{Spacing}.
 @seealso
 Snippets:
 @rlsr{Spacing}.


@@ -1504,7 +1492,6 @@ The page turning commands, @code{\pageTurn}, @code{\noPageTurn} and
 @code{\allowPageTurn}, may also be used at top-level, between scores and
 top-level markups.
 
 @code{\allowPageTurn}, may also be used at top-level, between scores and
 top-level markups.
 

-

 @predefined
 @funindex \pageTurn
 @code{\pageTurn},
 @predefined
 @funindex \pageTurn
 @code{\pageTurn},


@@ -1514,14 +1501,11 @@ top-level markups.
 @code{\allowPageTurn}.
 @endpredefined
 
 @code{\allowPageTurn}.
 @endpredefined
 

-

 @seealso
 Snippets:
 @rlsr{Spacing}.
 
 @seealso
 Snippets:
 @rlsr{Spacing}.
 

-

 @knownissues
 @knownissues

-

 There should only be one @code{Page_turn_engraver} in a score.  If there is more
 than one, they will interfere with each other.
 
 There should only be one @code{Page_turn_engraver} in a score.  If there is more
 than one, they will interfere with each other.
 


@@ -1543,7 +1527,6 @@ too slow or memory demanding, or a lot of texts.  It is enabled using:
 @}
 @end example
 
 @}
 @end example
 

-

 @seealso
 Snippets:
 @rlsr{Spacing}.
 @seealso
 Snippets:
 @rlsr{Spacing}.


@@ -1595,7 +1578,6 @@ music = \relative c'' { c8 c c c }
 }
 @end lilypond
 
 }
 @end lilypond
 

-

 @seealso
 Snippets:
 @rlsr{Spacing}.
 @seealso
 Snippets:
 @rlsr{Spacing}.


@@ -1682,7 +1664,6 @@ music = \relative c'' { c4 c c c }
 }
 @end lilypond
 
 }
 @end lilypond
 

-

 @seealso
 Notation Reference:
 @ref{Vertical spacing}.
 @seealso
 Notation Reference:
 @ref{Vertical spacing}.


@@ -2043,15 +2024,15 @@ Notation Reference:
 @ref{Flexible vertical spacing \paper variables},
 @ref{Modifying alists}.
 
 @ref{Flexible vertical spacing \paper variables},
 @ref{Modifying alists}.
 

+Installed Files:
+@file{ly/engraver-init.ly},
+@file{scm/define-grobs.scm}.
+

 Internals Reference:
 @rinternals{Contexts},
 @rinternals{VerticalAxisGroup},
 @rinternals{StaffGrouper}.
 
 Internals Reference:
 @rinternals{Contexts},
 @rinternals{VerticalAxisGroup},
 @rinternals{StaffGrouper}.
 

-Installed Files:
-@file{ly/engraver-init.ly},
-@file{scm/define-grobs.scm}.
-

 
 @node Spacing of ungrouped staves
 @unnumberedsubsubsec Spacing of ungrouped staves
 
 @node Spacing of ungrouped staves
 @unnumberedsubsubsec Spacing of ungrouped staves


@@ -2253,7 +2234,6 @@ able to stretch much more than usual:
 >>
 @end lilypond
 
 >>
 @end lilypond
 

-

 @seealso
 Installed Files:
 @file{ly/engraver-init.ly},
 @seealso
 Installed Files:
 @file{ly/engraver-init.ly},


@@ -2497,7 +2477,6 @@ to print staves or systems on top of one another.  Reasonable values
 passed to these different settings will avoid this.
 @end itemize
 
 passed to these different settings will avoid this.
 @end itemize
 

-

 @seealso
 Snippets:
 @rlsr{Spacing}.
 @seealso
 Snippets:
 @rlsr{Spacing}.


@@ -2582,7 +2561,6 @@ c4
 c''2
 @end lilypond
 
 c''2
 @end lilypond
 

-

 @seealso
 Snippets:
 @rlsr{Spacing}.
 @seealso
 Snippets:
 @rlsr{Spacing}.


@@ -2691,8 +2669,10 @@ once with exaggerated corrections:
 
 Proportional notation is supported; see @ref{Proportional notation}.
 
 
 Proportional notation is supported; see @ref{Proportional notation}.
 

-

 @seealso
 @seealso

+Essay on automated music engraving:
+@ressay{Optical spacing}.
+

 Snippets:
 @rlsr{Spacing}.
 
 Snippets:
 @rlsr{Spacing}.
 


@@ -2702,15 +2682,11 @@ Internals Reference:
 @rinternals{StaffSpacing},
 @rinternals{NonMusicalPaperColumn}.
 
 @rinternals{StaffSpacing},
 @rinternals{NonMusicalPaperColumn}.
 

-Essay on automated music engraving:
-@ressay{Optical spacing}.
-
-

 @knownissues
 @knownissues

-

 There is no convenient mechanism to manually override spacing.  The
 following work-around may be used to insert extra space into a score,
 adjusting the padding value as necessary.
 There is no convenient mechanism to manually override spacing.  The
 following work-around may be used to insert extra space into a score,
 adjusting the padding value as necessary.

+

 @example
  \override Score.NonMusicalPaperColumn #'padding = #10
 @end example
 @example
  \override Score.NonMusicalPaperColumn #'padding = #10
 @end example


@@ -2741,7 +2717,6 @@ The @code{\newSpacingSection} command creates a new
 @code{SpacingSpanner} object, and hence new @code{\override}s
 may be used in that location.
 
 @code{SpacingSpanner} object, and hence new @code{\override}s
 may be used in that location.
 

-

 @seealso
 Snippets:
 @rlsr{Spacing}.
 @seealso
 Snippets:
 @rlsr{Spacing}.


@@ -2833,7 +2808,6 @@ regard for clefs, bar lines, and grace notes,
 \new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c]  c32[ c32] }
 @end lilypond
 
 \new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c]  c32[ c32] }
 @end lilypond
 

-

 @seealso
 Snippets:
 @rlsr{Spacing}.
 @seealso
 Snippets:
 @rlsr{Spacing}.


@@ -2887,7 +2861,6 @@ paragraph, the last line simply takes its natural horizontal length.
 @}
 @end example
 
 @}
 @end example
 

-

 @seealso
 Snippets:
 @rlsr{Spacing}.
 @seealso
 Snippets:
 @rlsr{Spacing}.


@@ -3274,7 +3247,6 @@ mark both rhythmic start- and stop-points, and allow spanning elements
 to break across systems and pages.  See the respective parts of the manual
 for these related settings.
 
 to break across systems and pages.  See the respective parts of the manual
 for these related settings.
 

-

 @seealso
 Notation Reference:
 @ref{New spacing area}.
 @seealso
 Notation Reference:
 @ref{New spacing area}.


@@ -3349,7 +3321,6 @@ of @code{a6} paper in landscape orientation.  The pairs
 (@var{a},@var{b}) are intervals, where @var{a} is the lower
 edge and @var{b} the upper edge of the interval.
 
 (@var{a},@var{b}) are intervals, where @var{a} is the lower
 edge and @var{b} the upper edge of the interval.
 

-

 @seealso
 Notation Reference:
 @ref{Setting the staff size}.
 @seealso
 Notation Reference:
 @ref{Setting the staff size}.


@@ -3459,7 +3430,6 @@ block so that it applies to the whole score.
 
 @end itemize
 
 
 @end itemize
 

-

 @seealso
 Notation Reference:
 @ref{Page layout},
 @seealso
 Notation Reference:
 @ref{Page layout},