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 A few syntax changes were made:
  70 @example
  71 2.11.23: #'break-align-symbol -> #'break-align-symbols
  72 2.11.35: scripts.caesura -> scripts.caesura.curved.
  73 Use #'style not #'dash-fraction to select solid/dashed lines.
  74 2.11.38: \setEasyHeads -> \easyHeadsOn, \fatText -> \textLengthOn,
  75 \emptyText -> \textLengthOff
  76 2.11.46: \set hairpinToBarline -> \override Hairpin #'to-barline
  77 2.11.48: \compressMusic -> \scaleDurations
  78 2.11.50: metronomeMarkFormatter uses text markup as second argument,
  79 fret diagram properties moved to fret-diagram-details.
  80 2.11.51: \octave -> \octaveCheck, \arpeggioUp -> \arpeggioArrowUp,
  81 \arpeggioDown -> \arpeggioArrowDown, \arpeggioNeutral -> \arpeggioNormal,
  82 \setTextCresc -> \crescTextCresc, \setTextDecresc -> \dimTextDecresc,
  83 \setTextDecr -> \dimTextDecr, \setTextDim -> \dimTextDim,
  84 \setHairpinCresc -> \crescHairpin, \setHairpinDecresc -> \dimHairpin,
  85 \sustainUp -> \sustainOff, \sustainDown -> \sustainOn
  86 \sostenutoDown -> \sostenutoOn, \sostenutoUp -> \sostenutoOff
  87 2.11.53: infinite-spacing-height -> extra-spacing-height
  88 2.11.55: #(set-octavation oct) -> \ottava #oct,
  89 \put-adjacent markup axis dir markup -> \put-adjacent axis dir markup markup
  90 @end example
  91
  92 @item
  93 Arpeggios may now use ``parenthesis'' style brackets:
  94
  95 @lilypond[relative,ragged-right]
  96   \override Arpeggio #'stencil = #ly:arpeggio::brew-chord-slur
  97
  98   % Note: does not work for cross staff arpeggios.
  99   \override Arpeggio #'X-extent = #ly:grob::stencil-width
 100   <c g' c>2\arpeggio ~ c
 101 @end lilypond
 102
 103 @item
 104 Enclosing text within boxes with rounded corners is now possible,
 105 using the @code{rounded-box} command.
 106
 107 @item
 108 @command{lilypond-book} can run any program instead of @command{latex}
 109 to guess the line width, thanks to @code{--latex-program} command line
 110 option.
 111
 112 @item
 113 @code{\setEasyHeads} has been renamed to @code{\easyHeadsOn}, and a new
 114 command @code{\easyHeadsOff} reverts note heads to normal heads.
 115
 116 @item
 117 @code{\fatText}, @code{\emptyText} and @code{\compressMusic} have been
 118 renamed to @code{\textLengthOn}, @code{\textLengthOff} and
 119 @code{\scaleDurations}, respectively.
 120
 121 @item
 122 Underlining is now possible with the @code{\underline} markup command.
 123
 124 @item
 125 It is now possible to specify, using the @code{page-count} variable in
 126 the paper block, the number of pages that will be used.
 127
 128 @item
 129 A new page breaking function, @code{ly:minimal-breaking}, is dedicated
 130 to books with many pages or a lot of texts.
 131
 132 @item
 133 A table of contents is included using @code{\markuplines \table-of-contents}.
 134 Elements are added to it using the @code{\tocItem} command.
 135
 136 @item
 137 Text spreading over several pages is entered using the
 138 @code{\markuplines} keyword. Builtin markup list commands, such as
 139 @code{\justified-lines} or @code{\wordwrap-lines} may be used, and new
 140 ones created using the @code{define-markup-list-command} Scheme macro.
 141
 142 @item
 143 Particular points of a book may be marked with the @code{\label}
 144 command. Then, the page where these points are placed can be refered to
 145 using the @code{\page-ref} markup command.
 146
 147 @item
 148 Page breaking and page turning commands (@code{\pageBreak},
 149 @code{\noPageBreak}, etc) can be used at top-level, between scores and
 150 top-level markups.
 151
 152 @item
 153 The following options are now changed as a @code{-d} sub-option:
 154 @code{--backend}, @code{--safe}, @code{--preview} and
 155 @code{--no-pages} (which became @code{-dno-print-pages}).  The @code{-b}
 156 option does not exist any more.
 157
 158 @item
 159 Improved testing procedure now catch changes in CPU and memory
 160 performance, page layout, MIDI results and warnings.  This helps to
 161 reduce the number of regression errors during development, resulting
 162 in more stable releases.
 163
 164 See @uref{INSTALL.html#testing} for more information.
 165 @item
 166 Nested properties, such as @code{details} in @code{Slur}, can be
 167 reverted as well.  The syntax for this is
 168
 169 @example
 170 \revert Slur #'(details closeness-factor)
 171 @end example
 172
 173 @item
 174 All line spanners are more flexible now in the configuration of
 175 their end points.  This includes glissando, voice followers, text
 176 crescendos and other text spanners.  The old syntax for setting
 177 text on line spanners is no longer valid.
 178
 179 @lilypond[]
 180 \relative c'' {
 181   \override Glissando #'bound-details #'right #'text = \markup { \hcenter \bold down }
 182   \override Glissando #'bound-details #'right #'Y = #-4
 183   \override Glissando #'bound-details #'right #'padding = #0.0
 184   \override Glissando #'bound-details #'left #'arrow = ##t
 185   \override Glissando #'bound-details #'left #'padding = #3.0
 186   \override Glissando #'style = #'trill
 187   \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
 188   \override Glissando #'minimum-length = #12
 189
 190   c1 \glissando c'
 191 }
 192 @end lilypond
 193
 194 This feature was sponsored by Trevor Bača.
 195
 196
 197 @item
 198 The environment variable LILYPONDPREFIX has been renamed to
 199 LILYPOND_DATADIR.
 200
 201 @item
 202 Notes or rests, such as a typical end note, that fill an entire
 203 measure are preceded by some more space.
 204
 205 @lilypond[ragged-right]
 206 \relative c' {
 207   \time 4/4
 208   s1
 209   c2. c4
 210   \time 3/4
 211   c2.
 212 }
 213 @end lilypond
 214
 215 @item All @code{\score}s in a lilypond-book fragment are now inserted
 216 into the document. Also, toplevel markups don't result in an entire
 217 page.
 218
 219 @item Alterations (such as a sharp and flat) may now be arbitrary
 220 fractions. This allows some forms of microtonal music.  For example,
 221 Turkish makam music uses 1/9th tone alterations.
 222
 223 @lilypondfile{makam.ly}
 224
 225
 226
 227 @item Tie directions may be set with @code{^~} and @code{_~}
 228
 229 @item Tablature now supports harmonics and slides,
 230
 231 @lilypond[fragment,ragged-right,relative=1]
 232 \new TabVoice
 233 {
 234     <c g'\harmonic> d\2\glissando e\2
 235 }
 236 @end lilypond
 237
 238 This feature was sponsored by Mike Amundsen
 239
 240 @item Horizontal spacing now follows object outlines more
 241 accurately. This allows tighter horizontal spacing.
 242
 243 @lilypond[fragment,ragged-right]
 244 {
 245   \stemUp c''4...*1/2
 246   ceses'!
 247 }
 248 @end lilypond
 249
 250
 251 @item Objects that belong outside of the staff are
 252 now positioned automatically to avoid collisions.
 253
 254 @lilypond[fragment,ragged-right,relative=1]
 255   c''
 256   \once \override TextScript #'self-alignment-X = #CENTER
 257   a,^"this doesn't collide with the c"
 258   b^"this goes above the previous markup"
 259   a8_"this goes below the dynamic"
 260   a\f
 261 @end lilypond
 262
 263 @item Staves are spaced vertically using a skyline algorithm. This helps to avoid
 264 uneven vertical spacing.
 265
 266 @lilypond[ragged-right]
 267
 268 %% todo: fix 'landscape PDF.
 269 #(set-default-paper-size "a6" )
 270 \header {
 271   tagline = ##f
 272 }
 273
 274 \book {
 275   \score {
 276     {
 277       a,,1 | a'4 b' c'' d'' \break
 278       \repeat unfold 2 {a' b' c'' d''} | b''''1
 279     }
 280   }
 281 }
 282 @end lilypond
 283
 284 @item Metronome marks can now also contain a textual description.  The
 285 duration and count (if given) are shown in parentheses after the text.
 286
 287 @lilypond
 288 {
 289   \tempo "Fast"
 290   c'4 c' c' c'
 291   c'4 c' c' c'
 292   \tempo "Andante" 4 = 120
 293   c'4 c' c' c'
 294   c'4 c' c' c'
 295   \tempo 4 = 100
 296   c'4 c' c' c'
 297   c'4 c' c' c'
 298   \tempo "" 4 = 30
 299   c'4 c' c' c'
 300   c'4 c' c' c'
 301 }
 302 @end lilypond
 303
 304 @item In figured bass you can now also use a backslash through a number to
 305 indicate a raised 6th step.
 306
 307 @lilypond[ragged-right]
 308 \new FiguredBass \figuremode { < 6\\ 5\\ > < 6/ > }
 309 @end lilypond
 310
 311 @end itemize
 312
 313
 314
 315 @ifhtml
 316 For older news, go to
 317 @uref{http://lilypond.org/doc/v2.10/Documentation/topdocs/NEWS.html},
 318 or @uref{../,go back} to the Documentation index.
 319
 320
 321 @end ifhtml
 322
 323 @bye