Documentation/topdocs/NEWS.tely

   1 \input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
   2 @setfilename NEWS.info
   3 @settitle NEWS
   4
   5 @ifhtml
   6 @macro inputfileref{DIR,NAME}
   7 @uref{../../\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c
   8 @end macro
   9 @macro usermanref{NAME}
  10 @inforef{\NAME\,,../user/lilypond/lilypond}@c
  11 @end macro
  12 @end ifhtml
  13
  14 @ifnothtml
  15 @macro inputfileref{DIR,NAME}
  16 @file{\DIR\/\NAME\}@c
  17 @end macro
  18 @macro usermanref{NAME}
  19 See user manual, \NAME\
  20 @end macro
  21 @end ifnothtml
  22
  23 @macro textanchor{NAME}
  24 @html
  25 <a name="\NAME\"></a>
  26 @end html
  27 @end macro
  28
  29
  30 @documentencoding utf-8
  31 @documentlanguage en
  32
  33 @finalout
  34
  35 @ifnottex
  36 @node Top
  37 @top
  38 @end ifnottex
  39 @unnumbered New features in 2.11 since 2.10
  40
  41 @ifhtml
  42 This document is also available in @uref{NEWS.pdf,PDF}. It's part of
  43 the @uref{../,LilyPond Documentation} .
  44 @end ifhtml
  45
  46
  47
  48
  49 @itemize @bullet
  50
  51 @ignore
  52
  53 HINTS
  54
  55 * only show verbatim input for syntax/input changes
  56
  57 * try to be as brief possible in those cases
  58
  59 * don't try to provide real-world examples, they often get too big,
  60 which scares away people.
  61
  62 * Write complete sentences.
  63
  64 * only show user-visible changes.
  65
  66 @end ignore
  67
  68 @item
  69 @code{\setEasyHeads} has been renamed to @code{\easyHeadsOn}, and a new
  70 command @code{\easyHeadsOff} reverts note heads to normal heads.
  71
  72 @item
  73 @code{\fatText} and @code{\emptyText} have been renamed to
  74 @code{\textLengthOn} and @code{\textLengthOff}, respectively.
  75
  76 @item
  77 Underlining is now possible with the @code{\underline} markup command.
  78
  79 @item
  80 It is now possible to specify, using the @code{page-count} variable in
  81 the paper block, the number of pages that will be used.
  82
  83 @item
  84 A new page breaking function, @code{ly:minimal-breaking}, is dedicated
  85 to books with many pages or a lot of texts.
  86
  87 @item
  88 A table of contents is included using @code{\markuplines \table-of-contents}.
  89 Elements are added to it using the @code{\tocItem} command.
  90
  91 @item
  92 Text spreading over several pages is entered using the
  93 @code{\markuplines} keyword. Builtin markup list commands, such as
  94 @code{\justified-lines} or @code{\wordwrap-lines} may be used, and new
  95 ones created using the @code{define-markup-list-command} Scheme macro.
  96
  97 @item
  98 Particular points of a book may be marked with the @code{\label}
  99 command. Then, the page where these points are placed can be refered to
 100 using the @code{\page-ref} markup command.
 101
 102 @item
 103 Page breaking and page turning commands (@code{\pageBreak},
 104 @code{\noPageBreak}, etc) can be used at top-level, between scores and
 105 top-level markups.
 106
 107 @item
 108 The following options are now changed as a @code{-d} sub-option:
 109 @code{--backend}, @code{--safe}, @code{--preview} and
 110 @code{--no-pages} (which became @code{-dno-print-pages}).  The @code{-b}
 111 option does not exist any more.
 112
 113 @item
 114 Improved testing procedure now catch changes in CPU and memory
 115 performance, page layout, MIDI results and warnings.  This helps to
 116 reduce the number of regression errors during development, resulting
 117 in more stable releases.
 118
 119 See @uref{INSTALL.html#testing} for more information.
 120 @item
 121 Nested properties, such as @code{details} in @code{Slur}, can be
 122 reverted as well.  The syntax for this is
 123
 124 @example
 125 \revert Slur #'(details closeness-factor)
 126 @end example
 127
 128 @item
 129 All line spanners are more flexible now in the configuration of
 130 their end points.  This includes glissando, voice followers, text
 131 crescendos and other text spanners.  The old syntax for setting
 132 text on line spanners is no longer valid.
 133
 134 @c  with ragged-right we can't see the gliss.
 135 @lilypond[]
 136 \relative c'' {
 137   \override Glissando #'bound-details #'right #'text = \markup { \hcenter \bold down }
 138   \override Glissando #'bound-details #'right #'Y = #-4
 139   \override Glissando #'bound-details #'right #'padding = #0.0
 140   \override Glissando #'bound-details #'left #'arrow = ##t
 141   \override Glissando #'bound-details #'left #'padding = #3.0
 142   \override Glissando #'style = #'trill
 143
 144   c1 \glissando c'
 145 }
 146 @end lilypond
 147
 148 This feature was sponsored by Trevor Bača.
 149
 150
 151 @item
 152 The environment variable LILYPONDPREFIX has been renamed to
 153 LILYPOND_DATADIR.
 154
 155 @item
 156 Notes or rests, such as a typical end note, that fill an entire
 157 measure are preceded by some more space.
 158
 159 @lilypond[ragged-right]
 160 \relative c' {
 161   \time 4/4
 162   s1
 163   c2. c4
 164   \time 3/4
 165   c2.
 166 }
 167 @end lilypond
 168
 169 @item All @code{\score}s in a lilypond-book fragment are now inserted
 170 into the document. Also, toplevel markups don't result in an entire
 171 page.
 172
 173 @item Alterations (such as a sharp and flat) may now be arbitrary
 174 fractions. This allows some forms of microtonal music.  For example,
 175 Turkish makam music uses 1/9th tone alterations.
 176
 177 @lilypondfile{makam.ly}
 178
 179
 180
 181 @item Tie directions may be set with @code{^~} and @code{_~}
 182
 183 @item Tablature now supports harmonics and slides,
 184
 185 @lilypond[fragment,ragged-right,relative=1]
 186 \new TabVoice
 187 {
 188     <c g'\harmonic> d\2\glissando e\2
 189 }
 190 @end lilypond
 191
 192 This feature was sponsored by Mike Amundsen
 193
 194 @item Horizontal spacing now follows object outlines more
 195 accurately. This allows tighter horizontal spacing.
 196
 197 @lilypond[fragment,ragged-right]
 198 {
 199   \stemUp c''4...*1/2
 200   ceses'!
 201 }
 202 @end lilypond
 203
 204
 205 @item Objects that belong outside of the staff are
 206 now positioned automatically to avoid collisions.
 207
 208 @lilypond[fragment,ragged-right,relative=1]
 209   c''
 210   \once \override TextScript #'self-alignment-X = #CENTER
 211   a,^"this doesn't collide with the c"
 212   b^"this goes above the previous markup"
 213   a8_"this goes below the dynamic"
 214   a\f
 215 @end lilypond
 216
 217 @item Staves are spaced vertically using a skyline algorithm. This helps to avoid
 218 uneven vertical spacing.
 219
 220 @lilypond[ragged-right]
 221
 222 %% todo: fix 'landscape PDF.
 223 #(set-default-paper-size "a6" )
 224 \header {
 225   tagline = ##f
 226 }
 227
 228 \book {
 229   \score {
 230     {
 231       a,,1 | a'4 b' c'' d'' \break
 232       \repeat unfold 2 {a' b' c'' d''} | b''''1
 233     }
 234   }
 235 }
 236 @end lilypond
 237
 238 @end itemize
 239
 240
 241
 242 @ifhtml
 243 For older news, go to
 244 @uref{http://lilypond.org/doc/v2.10/Documentation/topdocs/NEWS.html},
 245 or @uref{../,go back} to the Documentation index.
 246
 247
 248 @end ifhtml
 249
 250 @bye