Merge commit 'ce4b499'

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

diff --git a/Documentation/topdocs/NEWS.tely b/Documentation/topdocs/NEWS.tely
index f37f6ac49634f100dd177cdc1b4118accd8ab003..474349b439e12ff7bace3209d9147a323e95ed78 100644 (file)
--- a/Documentation/topdocs/NEWS.tely
+++ b/Documentation/topdocs/NEWS.tely
@@ -20,7 +20,6 @@ See user manual, \NAME\
 @end macro
 @end ifnothtml
 
-
 @macro textanchor{NAME}
 @html
 <a name="\NAME\"></a>
@@ -41,7 +40,7 @@ See user manual, \NAME\
 
 @ifhtml
 This document is also available in @uref{NEWS.pdf,PDF}. It's part of
-the @uref{../,LilyPond Documentation} 
+the @uref{../,LilyPond Documentation} .
 @end ifhtml
 
 
@@ -66,6 +65,106 @@ which scares away people.
 
 @end ignore
 
+@item
+@code{\setEasyHeads} has been renamed to @code{\easyHeadsOn}, and a new
+command @code{\easyHeadsOff} reverts note heads to normal heads.
+
+@item
+@code{\fatText} and @code{\emptyText} have been renamed to
+@code{\textLengthOn} and @code{\textLengthOff}, respectively.
+
+@item
+Underlining is now possible with the @code{\underline} markup command.
+
+@item
+It is now possible to specify, using the @code{page-count} variable in
+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 texts.
+
+@item
+A table of contents is included using @code{\markuplines \table-of-contents}.
+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{\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 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
+top-level markups.
+
+@item
+The following options are now changed as a @code{-d} sub-option:
+@code{--backend}, @code{--safe}, @code{--preview} and
+@code{--no-pages} (which became @code{-dno-print-pages}).  The @code{-b}
+option does not exist any more.
+
+@item
+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} for more information.
+@item
+Nested properties, such as @code{details} in @code{Slur}, can be
+reverted as well.  The syntax for this is
+
+@example
+\revert Slur #'(details closeness-factor)
+@end example
+
+@item
+All line spanners are more flexible now in the configuration of
+their end points.  This includes glissando, voice followers, text
+crescendos and other text spanners.  The old syntax for setting
+text on line spanners is no longer valid.
+
+@c  with ragged-right we can't see the gliss.
+@lilypond[]
+\relative c'' {
+  \override Glissando #'bound-details #'right #'text = \markup { \hcenter \bold down }
+  \override Glissando #'bound-details #'right #'Y = #-4
+  \override Glissando #'bound-details #'right #'padding = #0.0
+  \override Glissando #'bound-details #'left #'arrow = ##t
+  \override Glissando #'bound-details #'left #'padding = #3.0
+  \override Glissando #'style = #'trill
+  
+  c1 \glissando c'
+}
+@end lilypond
+
+This feature was sponsored by Trevor Bača.
+
+ 
+@item
+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[ragged-right]
+\relative c' {
+  \time 4/4
+  s1
+  c2. c4
+  \time 3/4
+  c2.
+}
+@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