]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/topdocs/NEWS.texi
*** empty log message ***
[lilypond.git] / Documentation / topdocs / NEWS.texi
index 254494e6ef2848253b6687e146bd085e1078312d..9c45fff780fd3254b2317b118e5b64ea157e7811 100644 (file)
 @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 Drum notation is now supported  natively:
-percussion may be entered in @code{\drums} mode, and printed in a
-@code{DrumStaff} context:
+@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;
+@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.
+
+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
+
+@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.
+
+@item  Harmonic notes can now be entered as
+
+@example
+   <c' g''\harmonic>
+@end example
+
+@item Drum notation is now supported  as a regular feature:
+percussion may be entered in @code{\drums} mode, and printed or
+performed in a @code{DrumStaff} context:
 
 @example
   \score @{
@@ -28,12 +161,11 @@ 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:
 
 @example
-  \autochange @var{the music}
+  \autochange @var{the-music}
 @end example
 
 @item The ergonomic syntax of @code{\markup} now has an equivalent in
@@ -111,11 +243,14 @@ 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")
+  #(set-default-paper-size "a4")
+  \paper @{
+    #(set-paper-size "a4")
+  @}
 @end example 
 
 
@@ -141,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.
 
@@ -173,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
@@ -449,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
 
@@ -626,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