Merge branch 'master' into lilypond/translation

[lilypond.git] / Documentation / topdocs / NEWS.tely

diff --git a/Documentation/topdocs/NEWS.tely b/Documentation/topdocs/NEWS.tely
index c60fc9b5f6d667e8744647e9468997af3fc64c34..9e7cc5aebebfac7971dc372996ea511d1e292831 100644 (file)
--- a/Documentation/topdocs/NEWS.tely
+++ b/Documentation/topdocs/NEWS.tely
@@ -62,6 +62,63 @@ which scares away people.
 
 @end ignore
 
+@item
+@code{\bookpart} blocks may be used to split a book into several parts,
+separated by a page break, in order to ease the page breaking, or to use
+different @code{\paper} settings in different parts.
+
+@example
+\bookpart @{
+  \header @{
+    title = "Book title"
+    subtitle = "First part"
+  @}
+  \score @{ @dots{} @}
+  @dots{}
+@}
+\bookpart @{
+  \header @{
+    subtitle = "Second part"
+  @}
+  \score @{ @dots{} @}
+  @dots{}
+@}
+@end example
+
+@item
+Nested contexts of the same type are now allowed.
+This deprecates @code{InnerStaffGroup} and @code{InnerChoirStaff}.
+@lilypond[relative=1]
+\new StaffGroup <<
+  \new Staff { c1 }
+  \new StaffGroup <<
+    \new Staff { c1 }
+    \new Staff { c1 }
+  >>
+>>
+@end lilypond
+
+@item
+Percent repeat counters can be shown at regular intervals using the
+context property @code{repeatCountVisibility}.
+@lilypond[relative=1]
+{
+  \set countPercentRepeats = ##t
+  \set repeatCountVisibility = #(every-nth-repeat-count-visible 2)
+  \repeat percent 8 { c4 d e f }
+}
+@end lilypond
+
+@item
+In addition to the already existing @code{showLastLength} property,
+@code{showFirstLength} can now be set as well, rendering only the first
+measures of a piece.  Both properties may be set at the same time:
+@lilypond[]
+showFirstLength = R1*2
+showLastLength = R1*3
+\relative c' { c1 d e f g a b c }
+@end lilypond
+
 @item
 The file extension for MIDI can be set using the command-line
 program default @code{midi-extension}.  For Windows, the default
@@ -135,7 +192,9 @@ testnotes = {
          (yext (if is-up (cons (* log -0.8) 0) (cons 0 (* log 0.8))))
          (flag-stencil (make-filled-box-stencil '(-0.4 . 0.4) yext))
          (stroke-style (ly:grob-property stem-grob 'stroke-style))
-         (stroke-stencil (if (equal? stroke-style "grace") (make-line-stencil 0.2 -0.9 -0.4 0.9 -0.4) empty-stencil)))
+         (stroke-stencil (if (equal? stroke-style "grace")
+             (make-line-stencil 0.2 -0.9 -0.4 0.9 -0.4)
+             empty-stencil)))
     (ly:stencil-add flag-stencil stroke-stencil)))
 
 {
@@ -214,6 +273,7 @@ scripts.caesura -> scripts.caesura.curved
 \hcenter -> \center-align
 printallheaders -> print-all-headers
 \bigger -> \larger (already existing command)
+systemSeparatorMarkup -> system-separator-markup
 @end example
 
 @noindent
@@ -337,11 +397,11 @@ text on line spanners is no longer valid.
 
 @lilypond[]
 \relative c'' {
-  \override Glissando #'bound-details #'right #'text = \markup { \center-align \bold down }
-  \override Glissando #'bound-details #'right #'Y = #-4
-  \override Glissando #'bound-details #'right #'padding = #0.0
-  \override Glissando #'bound-details #'left #'arrow = ##t
-  \override Glissando #'bound-details #'left #'padding = #3.0
+  \override Glissando #'(bound-details right text) = \markup { \center-align \bold down }
+  \override Glissando #'(bound-details right Y) = #-4
+  \override Glissando #'(bound-details right padding) = #0.0
+  \override Glissando #'(bound-details left arrow) = ##t
+  \override Glissando #'(bound-details left padding) = #3.0
   \override Glissando #'style = #'trill
   \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
   \override Glissando #'minimum-length = #12
@@ -360,14 +420,12 @@ The environment variable @code{LILYPONDPREFIX} has been renamed
 Notes or rests, such as a typical end note, that fill an entire
 measure are preceded by some more space.
 
-@lilypond[]
-\relative c' {
-  \time 4/4
-  s1
-  c2. c4
-  \time 3/4
-  c2.
-}
+@lilypond[relative=1]
+\time 4/4
+s1
+c2. c4
+\time 3/4
+c2.
 @end lilypond
 
 @item