release commit

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

diff --git a/Documentation/topdocs/NEWS.texi b/Documentation/topdocs/NEWS.texi
index 348a896a3b44f38132566ab8a4bb58c4deeff34b..155fce522c827457ee8b9c6940b1885254b74b1e 100644 (file)
--- a/Documentation/topdocs/NEWS.texi
+++ b/Documentation/topdocs/NEWS.texi
@@ -18,17 +18,74 @@ Version 2.1.13
 
 @itemize @bullet
 
-@item The lilypond-book script has been rewritten.  It now supports
+@item  Translators and contexts have been split. The result of this
+internal cleanup is that @code{Score} no longer is the top context;
+@code{Score} is contained in the @code{Global} context. Consequently,
+it is possible to tweak @code{Score} as follows:
+
+@example
+  \context Score \with @{
+    @dots{}
+  @}
+@end example
+
+@item The number of staff lines  in Tablature notation is now
+automatically deduced from the @code{stringTunings} property.
+
+@item The program reference has been cleaned up and revised.
+
+@item The syntax for setting properties has been simplified:
+the following table lists the differences:
+
+@example
+      (old)                           (new)
+
+\property A.B = #C                \set A.B = #C
+\property A.B \unset              \unset A.B
+\property A.B \set #C = #D        \override A.B #C = #D 
+\property A.B \override #C = #D   (removed)
+\property A.B \revert #C          \revert A.B #C
+@end example
+
+Furthermore, if @code{A} is left out, the bottommost context is used
+by default.  In other words, it is no longer necessary to explicitly
+mention @code{Voice}, @code{Lyrics} or @code{ChordNames}. 
+
+Old:
+
+@example
+   \property Voice.autoBeaming = ##f
+   \property Staff.TimeSignature \set #'style = #'C
+@end example
+
+New:
+
+@example
+   \set autoBeaming = ##f
+   \override Staff.TimeSignature #'style = #'C
+@end example
+
+
+@item Tweaks  made with @code{\override} and @code{\revert} no longer
+hide tweaks at higher context levels.
+
+@item Melismata in lyrics are also properly handled  in the MIDI output.
+
+@item The lilypond-book script has been rewritten.
+It is shorter, cleaner and faster.  The special construct
+@code{mbinclude} has been removed, plain @code{@@include} or
+@code{\input} can be used now.
+
+@ignore
+It now supports
 running convert-ly on the lilypond snippets like so:
 @example
     lilypond-book --filter='convert-ly --from=2.0.0' my-book.tely
 @end example
-It is also twice as short and thrice as fast.  The special construct
-@code{mbinclude} has been removed, plain @code{@@include} or
-@code{\\input} can be used now.
+@end ignore
 
-@item The @code{Lyrics} context has been removed. Lyrics should only
-be constructed in @code{LyricsVoice}.
+@item The @code{LyricsVoice} context has been removed. Lyrics should only
+be constructed in @code{Lyrics}.
 
 @item The @code{Thread} context has been removed. Note heads and rests
 are now constructed at @code{Voice} level.
@@ -40,8 +97,8 @@ are now constructed at @code{Voice} level.
 @end example
 
 @item Drum notation is now supported  as a regular feature:
-percussion may be entered in @code{\drums} mode, and printed in a
-@code{DrumStaff} context:
+percussion may be entered in @code{\drums} mode, and printed or
+performed in a @code{DrumStaff} context:
 
 @example
   \score @{
@@ -49,7 +106,6 @@ percussion may be entered in @code{\drums} mode, and printed in a
   @}
 @end example
 
-
 @item The automatic staff changer was internally rewritten. As a
 result, the syntax has been simplified as well:
 
@@ -132,8 +188,8 @@ setting staff sizes. Both are demonstrated in this fragment:
 
 
 @noindent
-Both have  the same effect on the global layout  of a
-piece. Similarly, the paper size may be changed as follows
+Both have the same effect on the global layout of a piece. Similarly,
+the paper size may be changed as follows
 
 @example
   #(set-paper-size "a4")