Breakable markups with \markuplines.

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

diff --git a/Documentation/topdocs/NEWS.tely b/Documentation/topdocs/NEWS.tely
index 2c561886c76dbf0362fa260144d23cefeed05ee7..9a8a7a3591be6158fe065a4c70efe4171e5c4a79 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>
@@ -66,6 +65,108 @@ which scares away people.
 
 @end ignore
 
+@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.
+
+@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
+page.
+
+@item Alterations (such as a sharp and flat) may now be arbitrary
+fractions. This allows some forms of microtonal music.  For example,
+Turkish makam music uses 1/9th tone alterations.
+
+@lilypondfile{makam.ly}
+
+
+
+@item Tie directions may be set with @code{^~} and @code{_~}
+
+@item Tablature now supports harmonics and slides,
+
+@lilypond[fragment,ragged-right,relative=1]
+\new TabVoice
+{
+    <c g'\harmonic> d\2\glissando e\2
+}
+@end lilypond
+
+This feature was sponsored by Mike Amundsen
+
 @item Horizontal spacing now follows object outlines more
 accurately. This allows tighter horizontal spacing.
 
@@ -81,7 +182,6 @@ accurately. This allows tighter horizontal spacing.
 now positioned automatically to avoid collisions.
 
 @lilypond[fragment,ragged-right,relative=1]
-  \override TextScript #'outside-staff-priority = #1
   c''
   \once \override TextScript #'self-alignment-X = #CENTER
   a,^"this doesn't collide with the c"
@@ -94,7 +194,9 @@ now positioned automatically to avoid collisions.
 uneven vertical spacing.
 
 @lilypond[ragged-right]
-#(set-default-paper-size "a6" 'landscape)
+
+%% todo: fix 'landscape PDF.
+#(set-default-paper-size "a6" )
 \header {
   tagline = ##f
 }