*** empty log message ***

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

diff --git a/Documentation/topdocs/NEWS.texi b/Documentation/topdocs/NEWS.texi
index 7e9799b7459f846df5f496a09b7588b9a732aec7..9c45fff780fd3254b2317b118e5b64ea157e7811 100644 (file)
--- a/Documentation/topdocs/NEWS.texi
+++ b/Documentation/topdocs/NEWS.texi
@@ -5,18 +5,76 @@
 @node Top, , , 
 @top
 
-@chapter New features in 2.1 since 2.0
+@unnumbered New features in 2.1 since 2.0
 
-@ignore
-Unreleased:
+@itemize @bullet
 
-@itemize
-@end itemize
+@item The @code{Timing_engraver} now sets the @code{Timing} alias on
+its containing context automatically.
 
-Version 2.1.13
-@end ignore
+@item The code for font selection has been rewritten. In addition to
+existing font selection properties, the property @code{font-encoding}
+has been added, which makes the switch between normal @code{text} and
+other encodings like @code{braces}, @code{music} and @code{math}.
 
-@itemize @bullet
+@item The pmx2ly script has been removed from the distribution.
+
+@item Pedal brackets will now run to the last bar of a piece if they are not
+explicitly ended.
+
+@item Context definitions now use the word @code{\context} instead of @code{\translator}.
+
+@item Property functions may be used as an argument to @code{set!},
+for example
+
+@example
+  (set! (ly:grob-property grob 'beam) ... )
+@end example
+
+@item In anticipation of Emacs 21.4 or 22.1, the info documentation contains
+images.
+
+@item Cue notes can be quoted directly from the parts that
+contain them. This will take into account transposition of source and target
+instrument. For example,
+
+@verbatim
+\addquote clarinet \notes\relative c' {
+  \transposition bes
+  fis4 fis fis fis
+}
+
+\score {
+    \notes \relative c'' {
+       c8 d8 \quote 2 oboe es8 gis  
+    }
+}
+@end verbatim
+
+@item The transposition of an instrument can be specified using the
+@code{\transposition} command.  An
+E-flat alto saxophone is specified as 
+
+@example
+  \transposition es'
+@end example 
+
+@item The naming of exported Scheme functions now follows Scheme conventions.
+Changes be applied to Scheme files with 
+
+@example
+        convert-ly -e -n --from=2.1.24 --to=2.1.26 *.scm 
+@end example
+
+
+@item Notes can  be excluded from auto-beaming, by  marking them with
+@code{\noBeam}
+@example
+  c8 c \noBeam c c 
+@end example
+
+@noindent
+will print two separate eighth notes, and two beamed notes.
 
 @item  Translators and contexts have been split. The result of this
 internal cleanup is that @code{Score} no longer is the top context;
@@ -29,6 +87,8 @@ it is possible to tweak @code{Score} as follows:
   @}
 @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.
 
@@ -74,13 +134,10 @@ 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:
+It now supports running convert-ly on the lilypond snippets,
 @example
     lilypond-book --filter='convert-ly --from=2.0.0' my-book.tely
 @end example
-@end ignore
 
 @item The @code{LyricsVoice} context has been removed. Lyrics should only
 be constructed in @code{Lyrics}.
@@ -108,7 +165,7 @@ performed in a @code{DrumStaff} context:
 result, the syntax has been simplified as well:
 
 @example
-  \autochange @var{the music}
+  \autochange @var{the-music}
 @end example
 
 @item The ergonomic syntax of @code{\markup} now has an equivalent in
@@ -190,7 +247,10 @@ 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")
+  #(set-default-paper-size "a4")
+  \paper @{
+    #(set-paper-size "a4")
+  @}
 @end example 
 
 
@@ -216,12 +276,12 @@ octave should be.  In the following example,
 @noindent
 the d will generate a warning, because a d'' is
 expected, but a d' is found.
-@c @code adds ` ' very confusing.
+@c @code adds ` ', very confusing.
 
 @item There is a new mechanism for putting lyrics to melodies.
-With this mechanism, @code{LyricVoice}s can be put melodies
+With this mechanism, @code{Lyrics} lines can be put melodies
 individually, allowing for different melismatic sections in every
-@code{LyricVoice}. See @file{input/regression/lyric-combine-new.ly}.
+@code{Lyrics}. See @file{input/regression/lyric-combine-new.ly}.
 
 @item Bar lines may now be dotted.
 
@@ -248,11 +308,11 @@ expression. For example,
 @end example 
 
 @item Features of spanner contexts, like @code{Staff}, can now be changed
-  using @code{\property}, eg.
+  using @code{\set}, eg.
 
 @example
   \new Staff @{
-       \property Staff.StaffSymbol \set #'line-count = #4
+       \override Staff.StaffSymbol #'line-count = #4
        c'4
   @} 
 @end example
@@ -524,7 +584,7 @@ it automagically through the new @code{lily-wins} frontend.
 
 
 
-@chapter New features in 1.8 since 1.6
+@unnumbered New features in 1.8 since 1.6
 
 @itemize
 
@@ -701,7 +761,7 @@ The manual has been completely revised and extended.
 
 @end itemize
 
-@chapter New features in 1.6 since 1.4
+@unnumbered New features in 1.6 since 1.4
 
 
 @itemize @bullet