From: Paul Morris <paulwmorris@gmail.com>
Date: Mon, 14 Nov 2016 18:20:56 +0000 (-0500)
Subject: Issue 4752/2: Regtest, Doc NR 4.3, Changes entry
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=4934b315013ccdda3ab42271fa8bed6e45587844;p=lilypond.git

Issue 4752/2: Regtest, Doc NR 4.3, Changes entry
---

diff --git a/Documentation/changes.tely b/Documentation/changes.tely
index 64707801d2..2407b3d018 100644
--- a/Documentation/changes.tely
+++ b/Documentation/changes.tely
@@ -209,11 +209,12 @@ dimensions from a markup object, given as first argument.
 @end lilypond
 
 @item
-A new page breaking function @code{ly:one-line-auto-height-breaking}
-places a whole score on a single line and changes the page width
-to match, just like @code{ly:one-line-breaking}.  The difference is that
-it also automatically modifies the height of the page to fit the height
-of the music.
+There are two new page breaking functions.  @code{ly:one-page-breaking}
+automatically adjusts the height of the page to fit the music, so that
+everything fits on one page.  @code{ly:one-line-auto-height-breaking}
+is like @code{ly:one-line-breaking}, placing the music on a single
+line and adjusting the page width accordingly, however it also
+automatically adjusts the page height to fit the music.
 
 @item
 Markup-command @code{\draw-squiggle-line} is now available.
diff --git a/Documentation/notation/spacing.itely b/Documentation/notation/spacing.itely
index 23ed5c0f30..9a4e91d49b 100644
--- a/Documentation/notation/spacing.itely
+++ b/Documentation/notation/spacing.itely
@@ -892,8 +892,9 @@ Default values not listed here are defined in
 
 The page-breaking algorithm to use.  Choices are
 @code{ly:minimal-breaking}, @code{ly:page-turn-breaking},
-@code{ly:one-line-breaking}, @code{ly:one-line-auto-height-breaking},
-and @code{ly:optimal-breaking} (the default).
+@code{ly:one-page-breaking}, @code{ly:one-line-breaking},
+@code{ly:one-line-auto-height-breaking}, and @code{ly:optimal-breaking}
+(the default).
 
 @item page-breaking-system-system-spacing
 @funindex page-breaking-system-system-spacing
@@ -968,7 +969,9 @@ Notation Reference:
 @ref{Optimal page breaking},
 @ref{Optimal page turning},
 @ref{Minimal page breaking},
-@ref{One-line page breaking}.
+@ref{One-page page breaking},
+@ref{One-line page breaking},
+@ref{One-line-auto-height page breaking}.
 
 Installed Files:
 @file{ly/paper-defaults-init.ly}.
@@ -1560,6 +1563,7 @@ how to modify them.
 * Manual page breaking::
 * Optimal page breaking::
 * Minimal page breaking::
+* One-page page breaking::
 * One-line page breaking::
 * One-line-auto-height page breaking::
 * Optimal page turning::
@@ -1706,6 +1710,26 @@ Snippets:
 @rlsr{Spacing}.
 
 
+@node One-page page breaking
+@unnumberedsubsubsec One-page page breaking
+
+@funindex ly:one-page-breaking
+
+The @code{ly:one-page-breaking} function is a special-purpose
+page breaking algorithm that automatically adjusts the page height to
+fit the music, so that everything fits on a single page.  The
+@code{paper-height} variable in the paper block is ignored, but other
+settings work as usual.  In particular, the spacing between the last
+system (or top level markup) and the footer can be customized with
+@code{last-bottom-spacing} in the paper block.  The width of the page
+is left unmodified by default but can be set with @code{paper-width}
+in the paper block.
+
+@knownissues
+@code{ly:one-page-breaking} is not currently compatible with
+@code{\bookpart}.
+
+
 @node One-line page breaking
 @unnumberedsubsubsec One-line page breaking
 
diff --git a/input/regression/one-page-breaking.ly b/input/regression/one-page-breaking.ly
new file mode 100644
index 0000000000..5f663a6ad6
--- /dev/null
+++ b/input/regression/one-page-breaking.ly
@@ -0,0 +1,14 @@
+\version "2.19.36"
+
+\header {
+  texidoc = "The @var{ly:one-page-breaking} algorithm puts everything
+on one page by adjusting the page-height to fit the content.
+"
+}
+
+\paper {
+  paper-width = 120
+  page-breaking = #ly:one-page-breaking
+}
+
+\include "typography-demo.ly"