]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/topdocs/NEWS.tely
Merge branch 'master' into nested-bookparts
[lilypond.git] / Documentation / topdocs / NEWS.tely
index c69e4571f0413a60c94150dcfd00fb94dac76ea5..3b4ab8ea8e40a6a99d0bf5d05cd5fc2f33ae5c68 100644 (file)
@@ -32,8 +32,11 @@ See user manual, \NAME\
 
 @finalout
 
+@ifnottex
 @node Top
-@top New features in 2.11 since 2.10
+@top
+@end ifnottex
+@unnumbered New features in 2.11 since 2.10
 
 @ifhtml
 This document is also available in @uref{NEWS.pdf,PDF}. It's part of
@@ -62,29 +65,7 @@ which scares away people.
 
 @end ignore
 
-@item
-The file extension for MIDI can be set using the command-line
-program default @code{midi-extension}.  For Windows, the default
-extension has been changed to @code{.mid}.
-
-@item
-Two variations on the default double repeat bar line are now available.
-@lilypond[]
-{
-  \set Score.doubleRepeatType = #":|.:"
-  \repeat volta 2 {
-    c'1
-  }
-  \repeat volta 2 {
-    c'1
-  } 
-  \bar ":|.|:"
-  c'1
-}
-@end lilypond
-
-@item
-Three automatic accidentals rules have been added: @code{neo-modern},
+@item Three automatic accidentals rules have been added: @code{neo-modern},
 @code{neo-modern-cautionary} and @code{dodecaphonic}.  The following
 example illustrates @code{neo-modern} rule.
 @lilypond[]
@@ -108,26 +89,18 @@ notes = {
 }
 @end lilypond
 
-@item
-Flags can now be generated with Scheme-code using the @code{'flag}
-@code{Stem} grob property.  Existing scores will work without change.
-@lilypond[]
-testnotes = {
-  \autoBeamOff
-  c'8 d'16 c''8 d''16
-}
+@item Flags can now be generated with Scheme-code using the @code{'flag} Stem
+grob property. Existing scores will work without change.
+@lilypond
+testnotes = { \autoBeamOff c'8 d'16 c''8 d''16 }
 
 #(define (inverted-flag stem-grob)
   (let* ((dir (if (eqv? (ly:grob-property stem-grob 'direction) UP) "d" "u"))
          (flag (retrieve-glyph-flag "" dir "" stem-grob))
-         (line-thickness (ly:staff-symbol-line-thickness stem-grob))
-         (stem-thickness (ly:grob-property stem-grob 'thickness))
-         (stem-width (* line-thickness stem-thickness))
          (stroke-style (ly:grob-property stem-grob 'stroke-style))
          (stencil (if (null? stroke-style) flag
-                         (add-stroke-glyph flag stem-grob dir stroke-style "")))
-                         (rotated-flag (ly:stencil-rotate-absolute stencil 180 0 0)))
-    (ly:stencil-translate rotated-flag (cons (- (/ stem-width 2))  0))))
+                         (add-stroke-glyph flag stem-grob dir stroke-style ""))))
+    (ly:stencil-rotate stencil 180 -1 -1)))
 
 #(define-public (weight-flag stem-grob)
   (let* ((log (- (ly:grob-property stem-grob 'duration-log) 2))
@@ -145,14 +118,15 @@ testnotes = {
 
   \override Stem #'flag = #inverted-flag
   \testnotes
+
 }
+
 @end lilypond
 
-@item
-Harp pedalling diagrams were added:
+@item Harp pedalling diagrams were added:
 
-@lilypond[]
-\markup { \harp-pedal #"^v-|vv-o^" }
+@lilypond
+\markup \harp-pedal #"^v-|vv-o^"
 @end lilypond
 
 @item
@@ -162,15 +136,13 @@ are now available in the @code{FretBoards} context:
 \include "predefined-guitar-fretboards.ly"
 <<
   \new ChordNames {
-    \chordmode {
-      c1
-      \transpose c e { c }
+   \chordmode {
+      c1 \transpose c e { c }
     }
   }
   \new FretBoards {
     \chordmode {
-      c1
-      \transpose c e { c }
+      c1 \transpose c e { c }
     }
   }
 >>
@@ -179,11 +151,11 @@ are now available in the @code{FretBoards} context:
 @item
 The following syntax changes were made, in chronological order. In
 addition, fret diagram properties have been moved to
-@code{fret-diagram-details}, and the @code{#'style} property is
-used to select solid/dashed lines instead of @code{#'dash-fraction}.
+@code{fret-diagram-details}, and @code{#'style} property is used to
+select solid/dashed lines instead of @code{#'dash-fraction}.
 
 @example
-'break-align-symbol -> 'break-align-symbols
+#'break-align-symbol -> #'break-align-symbols
 scripts.caesura -> scripts.caesura.curved
 \setEasyHeads -> \easyHeadsOn
 \easyHeadsOff (new command)
@@ -205,21 +177,17 @@ scripts.caesura -> scripts.caesura.curved
 \sustainDown -> \sustainOn
 \sostenutoDown -> \sostenutoOn
 \sostenutoUp -> \sostenutoOff
-'infinite-spacing-height -> 'extra-spacing-height
+infinite-spacing-height -> extra-spacing-height
 #(set-octavation oct) -> \ottava #oct
 \put-adjacent markup axis dir markup -> \put-adjacent axis dir markup markup
-\pointAndClickOn (new command)
-\pointAndClickOff (new command)
 \center-align -> \center-column
 \hcenter -> \center-align
-printallheaders -> print-all-headers
 @end example
 
-@item
-Metronome marks can now also contain a textual description.  The
+@item Metronome marks can now also contain a textual description.  The
 duration and count (if given) are shown in parentheses after the text.
 
-@lilypond[]
+@lilypond
 {
   \tempo "Fast"
   c'4 c' c' c'
@@ -236,33 +204,27 @@ duration and count (if given) are shown in parentheses after the text.
 }
 @end lilypond
 
-@item
-In figured bass you can now also use a backslash through a number to
+@item In figured bass you can now also use a backslash through a number to
 indicate a raised 6th step.
 
-@lilypond[]
+@lilypond[ragged-right]
 \new FiguredBass \figuremode { < 6\\ 5\\ > < 6/ > }
 @end lilypond
 
 @item
 Arpeggios may now use ``parenthesis'' style brackets:
 
-@lilypond[relative=1]
-\override Arpeggio #'stencil = #ly:arpeggio::brew-chord-slur
+@lilypond[relative,ragged-right]
+  \override Arpeggio #'stencil = #ly:arpeggio::brew-chord-slur
 
-% Note: does not work for cross-staff arpeggios.
-\override Arpeggio #'X-extent = #ly:grob::stencil-width
-<c g' c>2\arpeggio ~ c
+  % Note: does not work for cross staff arpeggios.
+  \override Arpeggio #'X-extent = #ly:grob::stencil-width
+  <c g' c>2\arpeggio ~ c
 @end lilypond
 
-@item
-Single-system scores are now naturally spaced instead of being
-stretched to fill the line width.  This can be changed by setting
-@code{ragged-right = ##f}.
-
 @item
 Enclosing text within boxes with rounded corners is now possible,
-using the @code{\rounded-box} markup command.
+using the @code{rounded-box} command.
 
 @item
 @command{lilypond-book} can run any program instead of @command{latex}
@@ -278,7 +240,7 @@ the paper block, the number of pages that will be used.
 
 @item
 A new page breaking function, @code{ly:minimal-breaking}, is dedicated
-to books with many pages or a lot of text.
+to books with many pages or a lot of texts.
 
 @item
 A table of contents is included using @code{\markuplines \table-of-contents}.
@@ -286,18 +248,18 @@ Elements are added to it using the @code{\tocItem} command.
 
 @item
 Text spreading over several pages is entered using the
-@code{\markuplines} keyword.  Builtin markup list commands, such as
+@code{\markuplines} keyword. Builtin markup list commands, such as
 @code{\justified-lines} or @code{\wordwrap-lines} may be used, and new
 ones created using the @code{define-markup-list-command} Scheme macro.
 
 @item
 Particular points of a book may be marked with the @code{\label}
-command.  Then, the page where these points are placed can be
-referred to using the @code{\page-ref} markup command.
+command. Then, the page where these points are placed can be refered to
+using the @code{\page-ref} markup command.
 
 @item
 Page breaking and page turning commands (@code{\pageBreak},
-@code{\noPageBreak}, etc.) can be used at top-level, between scores and
+@code{\noPageBreak}, etc) can be used at top-level, between scores and
 top-level markups.
 
 @item
@@ -307,15 +269,14 @@ The following options are now changed as a @code{-d} sub-option:
 option does not exist any more.
 
 @item
-Improved testing procedures now catch changes in CPU and memory
+Improved testing procedure now catch changes in CPU and memory
 performance, page layout, MIDI results and warnings.  This helps to
 reduce the number of regression errors during development, resulting
 in more stable releases.
 
 See @uref{INSTALL.html#Testing-LilyPond} for more information.
-
 @item
-Nested properties, such as @code{'details} in @code{Slur}, can be
+Nested properties, such as @code{details} in @code{Slur}, can be
 reverted as well.  The syntax for this is
 
 @example
@@ -345,15 +306,16 @@ text on line spanners is no longer valid.
 
 This feature was sponsored by Trevor Bača.
 
 @item
-The environment variable @code{LILYPONDPREFIX} has been renamed
-@code{LILYPOND_DATADIR}.
+The environment variable LILYPONDPREFIX has been renamed to
+LILYPOND_DATADIR.
 
 @item
 Notes or rests, such as a typical end note, that fill an entire
 measure are preceded by some more space.
 
-@lilypond[]
+@lilypond[ragged-right]
 \relative c' {
   \time 4/4
   s1
@@ -363,64 +325,61 @@ measure are preceded by some more space.
 }
 @end lilypond
 
-@item
-All @code{\score}s in a lilypond-book fragment are now inserted
-into the document.  Also, toplevel markups don't result in an entire
+@item All @code{\score}s in a lilypond-book fragment are now inserted
+into the document. Also, toplevel markups don't result in an entire
 page.
 
-@item
-Alterations (such as a sharp or flat) may now be arbitrary
-fractions.  This allows some forms of microtonal music.  For example,
+@item Alterations (such as a sharp and flat) may now be arbitrary
+fractions. This allows some forms of microtonal music.  For example,
 Turkish makam music uses 1/9th tone alterations.
 
 @lilypondfile{makam.ly}
 
-@item
-Tie directions may be set with @code{^~} and @code{_~}.
 
-@item
-Tablature now supports harmonics and slides:
 
-@lilypond[relative=1]
-\new TabVoice {
-  <c g'\harmonic>4 d\2\glissando e2\2
+@item Tie directions may be set with @code{^~} and @code{_~}
+
+@item Tablature now supports harmonics and slides,
+
+@lilypond[fragment,ragged-right,relative=1]
+\new TabVoice
+{
+    <c g'\harmonic> d\2\glissando e\2
 }
 @end lilypond
 
 This feature was sponsored by Mike Amundsen
 
-@item
-Horizontal spacing now follows object outlines more accurately.
-This allows tighter horizontal spacing.
+@item Horizontal spacing now follows object outlines more
+accurately. This allows tighter horizontal spacing.
 
-@lilypond[]
+@lilypond[fragment,ragged-right]
 {
-  \stemUp
-  c''4... ceses'! s16
+  \stemUp c''4...*1/2
+  ceses'!
 }
 @end lilypond
 
-@item
-Objects that belong outside of the staff are now positioned
-automatically to avoid collisions.
-
-@lilypond[relative=1]
-c''4
-\once \override TextScript #'self-alignment-X = #CENTER
-a,4^"this doesn't collide with the c"
-b4^"this goes above the previous markup"
-a8_"this goes below the dynamic"
-a8\f
+
+@item Objects that belong outside of the staff are
+now positioned automatically to avoid collisions.
+
+@lilypond[fragment,ragged-right,relative=1]
+  c''
+  \once \override TextScript #'self-alignment-X = #CENTER
+  a,^"this doesn't collide with the c"
+  b^"this goes above the previous markup"
+  a8_"this goes below the dynamic"
+  a\f
 @end lilypond
 
-@item
-Staves are spaced vertically using a skyline algorithm.  This helps
-prevent uneven vertical spacing.
+@item Staves are spaced vertically using a skyline algorithm. This helps to avoid
+uneven vertical spacing.
 
 @lilypond[ragged-right]
 
 %% todo: fix 'landscape PDF.
-#(set-default-paper-size "a6")
+#(set-default-paper-size "a6" )
 \header {
   tagline = ##f
 }
@@ -428,10 +387,8 @@ prevent uneven vertical spacing.
 \book {
   \score {
     {
-      a,,1
-      a'4 b' c'' d'' \break
-      \repeat unfold 2 { a'4 b' c'' d''}
-      b''''1
+      a,,1 | a'4 b' c'' d'' \break
+      \repeat unfold 2 {a' b' c'' d''} | b''''1
     }
   }
 }