@chapter New features in 2.1 since 2.0
+@ignore
Unreleased:
@itemize
+@end itemize
-@item The syntax for changing staffs has changed. The keyword
-@code{\change} should now be used, e.g.
+Version 2.1.9
+@end ignore
+
+@itemize @bullet
+@item Formatting of ottava brackets has been much improved.
+
+@item Objects in the output can now be documented: the following fragment
+ boxes the note head, and adds the text ``heads or tails?'' three
+spaces below the box.
@example
- \change Staff = up
+ \context Voice \applyoutput #(add-balloon-text
+ 'NoteHead "heads, or tails?"
+ '(0 . -3))
+
+
+ c8
+@end example
+
+
+@item Default staff sizes are now scalable. There are two new mechanisms for
+setting staff sizes. Both are demonstrated in this fragment:
+
+@example
+ #(set-staff-size 15)
+ \paper @{
+ #(paper-set-staff-size (* 15 pt))
+ @}
+@end example
+
+
+@noindent
+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")
@end example
-@item Features of spanner contexts, like @code{Staff}, can now be changed easily:
+@item Warnings for bar check errors are more cleverly printed. This
+makes @code{barCheckSynchronize} superfluous, so it is now switched
+off by default.
+
+Warning: this will cause problems in scores that use bar checks to
+shorten measures.
+
+@item The black note head was made a little rounder, which causes a less
+ frantic graphic impression.
+
+@item
+A more concise syntax for checking octaves was introduced. A note may
+be followed by @code{=}@var{quotes} which indicates what its absolute
+octave should be. In the following example,
+
+@example
+ \relative c'' @{ c='' b=' d,='' @}
+@end example
+
+@noindent
+the @code{d} will generate a warning, because a @code{d''} is
+expected, but a @code{d'} is found.
+
+@item There is a new mechanism for putting lyrics to melodies.
+With this mechanism, @code{LyricVoice}s can be put melodies
+individually, allowing for different melismatic sections in every
+@code{LyricVoice}. See @file{input/regression/lyric-combine-new.ly}.
+
+@item Bar lines may now be dotted.
+
+
+@item The documentation now has links to a wiki, where everyone can
+add personal comments to the manual.
+
+@item Contexts may now be changed locally for an isolated music
+expression. For example,
+
@example
- \new Staff \with @{
- StaffSymbol \set #'line-count = #4
+ \new Voice \with @{
+ \consists "Pitch_squash_engraver"
@} @{
c'4
@}
@end example
-@noindent
-puts a quarter note C on a staff with 4 lines.
+@item The syntax for changing staffs has changed. The keyword
+@code{\change} should now be used, e.g.
-@end itemize
+@example
+ \change Staff = up
+@end example
-Version 2.1.7
+@item Features of spanner contexts, like @code{Staff}, can now be changed
+ using @code{\property}, eg.
+
+@example
+ \new Staff @{
+ \property Staff.StaffSymbol \set #'line-count = #4
+ c'4
+ @}
+@end example
+
+@noindent
+puts a quarter note C on a staff with 4 lines.
-@itemize @bullet
@item Multi measure rests are now truly centered between the
clefs/barlines of the staff, their position is independent of symbols
@item
When redefining a context, the associated identifier is also
-updated. For example, after reading following the snippet,
+updated. For example, after reading the following snippet,
@example
\translator @{
\ScoreContext