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 @node Top
  36 @top New features in 2.11 since 2.10
  37
  38 @ifhtml
  39 This document is also available in @uref{NEWS.pdf,PDF}. It's part of
  40 the @uref{../,LilyPond Documentation} .
  41 @end ifhtml
  42
  43
  44
  45
  46 @itemize @bullet
  47
  48 @ignore
  49
  50 HINTS
  51
  52 * only show verbatim input for syntax/input changes
  53
  54 * try to be as brief possible in those cases
  55
  56 * don't try to provide real-world examples, they often get too big,
  57 which scares away people.
  58
  59 * Write complete sentences.
  60
  61 * only show user-visible changes.
  62
  63 @end ignore
  64
  65 @item
  66 In addition to the already existing @code{showLastLength} property,
  67 @code{showFirstLength} can now be set as well, rendering only the first
  68 measures of a piece.  Both properties may be set at the same time:
  69 @lilypond[]
  70 showFirstLength = R1*2
  71 showLastLength = R1*3
  72 \relative c' { c1 d e f g a b c }
  73 @end lilypond
  74
  75 @item
  76 The file extension for MIDI can be set using the command-line
  77 program default @code{midi-extension}.  For Windows, the default
  78 extension has been changed to @code{.mid}.
  79
  80 @item
  81 Two variations on the default double repeat bar line are now available.
  82 @lilypond[]
  83 {
  84   \set Score.doubleRepeatType = #":|.:"
  85   \repeat volta 2 {
  86     c'1
  87   }
  88   \repeat volta 2 {
  89     c'1
  90   }
  91   \bar ":|.|:"
  92   c'1
  93 }
  94 @end lilypond
  95
  96 @item
  97 Four automatic accidentals rules have been added: @code{neo-modern},
  98 @code{neo-modern-cautionary}, @code{dodecaphonic} and @code{teaching}.
  99 The following example illustrates @code{neo-modern} rule.
 100 @lilypond[]
 101 notes = {
 102   <<
 103     \relative c' {
 104       cis'8 fis, d'4 <a cis>8 f bis4 |
 105       cis2. <c, fis>4 |
 106     }
 107     \\
 108     \relative c' {
 109       ais'2 cis, |
 110       fis8 b a4 cis2 |
 111     }
 112   >>
 113 }
 114
 115 \new Staff {
 116   #(set-accidental-style 'neo-modern)
 117   \notes
 118 }
 119 @end lilypond
 120
 121 @item
 122 Flags can now be generated with Scheme-code using the @code{'flag}
 123 @code{Stem} grob property.  Existing scores will work without change.
 124 @lilypond[]
 125 testnotes = {
 126   \autoBeamOff
 127   c'8 d'16 c''8 d''16
 128 }
 129
 130 #(define (inverted-flag stem-grob)
 131   (let* ((dir (if (eqv? (ly:grob-property stem-grob 'direction) UP) "d" "u"))
 132          (flag (retrieve-glyph-flag "" dir "" stem-grob))
 133          (line-thickness (ly:staff-symbol-line-thickness stem-grob))
 134          (stem-thickness (ly:grob-property stem-grob 'thickness))
 135          (stem-width (* line-thickness stem-thickness))
 136          (stroke-style (ly:grob-property stem-grob 'stroke-style))
 137          (stencil (if (null? stroke-style) flag
 138                          (add-stroke-glyph flag stem-grob dir stroke-style "")))
 139                          (rotated-flag (ly:stencil-rotate-absolute stencil 180 0 0)))
 140     (ly:stencil-translate rotated-flag (cons (- (/ stem-width 2))  0))))
 141
 142 #(define-public (weight-flag stem-grob)
 143   (let* ((log (- (ly:grob-property stem-grob 'duration-log) 2))
 144          (is-up (eqv? (ly:grob-property stem-grob 'direction) UP))
 145          (yext (if is-up (cons (* log -0.8) 0) (cons 0 (* log 0.8))))
 146          (flag-stencil (make-filled-box-stencil '(-0.4 . 0.4) yext))
 147          (stroke-style (ly:grob-property stem-grob 'stroke-style))
 148          (stroke-stencil (if (equal? stroke-style "grace") (make-line-stencil 0.2 -0.9 -0.4 0.9 -0.4) empty-stencil)))
 149     (ly:stencil-add flag-stencil stroke-stencil)))
 150
 151 {
 152   \time 3/8
 153   \override Stem #'flag = #weight-flag
 154   \testnotes
 155
 156   \override Stem #'flag = #inverted-flag
 157   \testnotes
 158 }
 159 @end lilypond
 160
 161 @item
 162 Harp pedalling diagrams were added:
 163
 164 @lilypond[]
 165 \markup { \harp-pedal #"^v-|vv-o^" }
 166 @end lilypond
 167
 168 @item
 169 Predefined, user-configurable, transposable fret diagrams
 170 are now available in the @code{FretBoards} context:
 171 @lilypond[]
 172 \include "predefined-guitar-fretboards.ly"
 173 <<
 174   \new ChordNames {
 175     \chordmode {
 176       c1
 177       \transpose c e { c }
 178     }
 179   }
 180   \new FretBoards {
 181     \chordmode {
 182       c1
 183       \transpose c e { c }
 184     }
 185   }
 186 >>
 187 @end lilypond
 188
 189 @item
 190 The following syntax changes were made, in chronological order. In
 191 addition, fret diagram properties have been moved to
 192 @code{fret-diagram-details}, and the @code{#'style} property is
 193 used to select solid/dashed lines instead of @code{#'dash-fraction}.
 194
 195 @example
 196 'break-align-symbol -> 'break-align-symbols
 197 scripts.caesura -> scripts.caesura.curved
 198 \setEasyHeads -> \easyHeadsOn
 199 \easyHeadsOff (new command)
 200 \fatText -> \textLengthOn
 201 \emptyText -> \textLengthOff
 202 \set hairpinToBarline -> \override Hairpin #'to-barline
 203 \compressMusic -> \scaleDurations
 204 \octave -> \octaveCheck
 205 \arpeggioUp -> \arpeggioArrowUp
 206 \arpeggioDown -> \arpeggioArrowDown
 207 \arpeggioNeutral -> \arpeggioNormal
 208 \setTextCresc -> \crescTextCresc
 209 \setTextDecresc -> \dimTextDecresc
 210 \setTextDecr -> \dimTextDecr
 211 \setTextDim -> \dimTextDim
 212 \setHairpinCresc -> \crescHairpin
 213 \setHairpinDecresc -> \dimHairpin
 214 \sustainUp -> \sustainOff
 215 \sustainDown -> \sustainOn
 216 \sostenutoDown -> \sostenutoOn
 217 \sostenutoUp -> \sostenutoOff
 218 'infinite-spacing-height -> 'extra-spacing-height
 219 #(set-octavation oct) -> \ottava #oct
 220 \put-adjacent markup axis dir markup -> \put-adjacent axis dir markup markup
 221 \pointAndClickOn (new command)
 222 \pointAndClickOff (new command)
 223 \center-align -> \center-column
 224 \hcenter -> \center-align
 225 printallheaders -> print-all-headers
 226 \bigger -> \larger (already existing command)
 227 @end example
 228
 229 @noindent
 230 Moreover, some files in the @code{ly/} directory have been renamed;
 231 the *-init.ly filenames are now only used for files that are automatically
 232 included, while such files as @code{makam-init.ly} or @code{gregorian-init.ly}
 233 have been renamed to @code{makam.ly} or @code{gregorian.ly}.
 234
 235 @item
 236 Metronome marks can now also contain a textual description.  The
 237 duration and count (if given) are shown in parentheses after the text.
 238
 239 @lilypond[]
 240 {
 241   \tempo "Fast"
 242   c'4 c' c' c'
 243   c'4 c' c' c'
 244   \tempo "Andante" 4 = 120
 245   c'4 c' c' c'
 246   c'4 c' c' c'
 247   \tempo 4 = 100
 248   c'4 c' c' c'
 249   c'4 c' c' c'
 250   \tempo "" 4 = 30
 251   c'4 c' c' c'
 252   c'4 c' c' c'
 253 }
 254 @end lilypond
 255
 256 @item
 257 In figured bass you can now also use a backslash through a number to
 258 indicate a raised 6th step.
 259
 260 @lilypond[]
 261 \new FiguredBass \figuremode { < 6\\ 5\\ > < 6/ > }
 262 @end lilypond
 263
 264 @item
 265 Arpeggios may now use ``parenthesis'' style brackets:
 266
 267 @lilypond[relative=1]
 268 \override Arpeggio #'stencil = #ly:arpeggio::brew-chord-slur
 269
 270 % Note: does not work for cross-staff arpeggios.
 271 \override Arpeggio #'X-extent = #ly:grob::stencil-width
 272 <c g' c>2\arpeggio ~ c
 273 @end lilypond
 274
 275 @item
 276 Single-system scores are now naturally spaced instead of being
 277 stretched to fill the line width.  This can be changed by setting
 278 @code{ragged-right = ##f}.
 279
 280 @item
 281 Enclosing text within boxes with rounded corners is now possible,
 282 using the @code{\rounded-box} markup command.
 283
 284 @item
 285 @command{lilypond-book} can run any program instead of @command{latex}
 286 to guess the line width, thanks to @code{--latex-program} command line
 287 option.
 288
 289 @item
 290 Underlining is now possible with the @code{\underline} markup command.
 291
 292 @item
 293 It is now possible to specify, using the @code{page-count} variable in
 294 the paper block, the number of pages that will be used.
 295
 296 @item
 297 A new page breaking function, @code{ly:minimal-breaking}, is dedicated
 298 to books with many pages or a lot of text.
 299
 300 @item
 301 A table of contents is included using @code{\markuplines \table-of-contents}.
 302 Elements are added to it using the @code{\tocItem} command.
 303
 304 @item
 305 Text spreading over several pages is entered using the
 306 @code{\markuplines} keyword.  Builtin markup list commands, such as
 307 @code{\justified-lines} or @code{\wordwrap-lines} may be used, and new
 308 ones created using the @code{define-markup-list-command} Scheme macro.
 309
 310 @item
 311 Particular points of a book may be marked with the @code{\label}
 312 command.  Then, the page where these points are placed can be
 313 referred to using the @code{\page-ref} markup command.
 314
 315 @item
 316 Page breaking and page turning commands (@code{\pageBreak},
 317 @code{\noPageBreak}, etc.) can be used at top-level, between scores and
 318 top-level markups.
 319
 320 @item
 321 The following options are now changed as a @code{-d} sub-option:
 322 @code{--backend}, @code{--safe}, @code{--preview} and
 323 @code{--no-pages} (which became @code{-dno-print-pages}).  The @code{-b}
 324 option does not exist any more.
 325
 326 @item
 327 Improved testing procedures now catch changes in CPU and memory
 328 performance, page layout, MIDI results and warnings.  This helps to
 329 reduce the number of regression errors during development, resulting
 330 in more stable releases.
 331
 332 See @uref{INSTALL.html#Testing-LilyPond} for more information.
 333
 334 @item
 335 Nested properties, such as @code{'details} in @code{Slur}, can be
 336 reverted as well.  The syntax for this is
 337
 338 @example
 339 \revert Slur #'(details closeness-factor)
 340 @end example
 341
 342 @item
 343 All line spanners are more flexible now in the configuration of
 344 their end points.  This includes glissando, voice followers, text
 345 crescendos and other text spanners.  The old syntax for setting
 346 text on line spanners is no longer valid.
 347
 348 @lilypond[]
 349 \relative c'' {
 350   \override Glissando #'bound-details #'right #'text = \markup { \center-align \bold down }
 351   \override Glissando #'bound-details #'right #'Y = #-4
 352   \override Glissando #'bound-details #'right #'padding = #0.0
 353   \override Glissando #'bound-details #'left #'arrow = ##t
 354   \override Glissando #'bound-details #'left #'padding = #3.0
 355   \override Glissando #'style = #'trill
 356   \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
 357   \override Glissando #'minimum-length = #12
 358
 359   c1 \glissando c'
 360 }
 361 @end lilypond
 362
 363 This feature was sponsored by Trevor Bača.
 364
 365 @item
 366 The environment variable @code{LILYPONDPREFIX} has been renamed
 367 @code{LILYPOND_DATADIR}.
 368
 369 @item
 370 Notes or rests, such as a typical end note, that fill an entire
 371 measure are preceded by some more space.
 372
 373 @lilypond[]
 374 \relative c' {
 375   \time 4/4
 376   s1
 377   c2. c4
 378   \time 3/4
 379   c2.
 380 }
 381 @end lilypond
 382
 383 @item
 384 All @code{\score}s in a lilypond-book fragment are now inserted
 385 into the document.  Also, toplevel markups don't result in an entire
 386 page.
 387
 388 @item
 389 Alterations (such as a sharp or flat) may now be arbitrary
 390 fractions.  This allows some forms of microtonal music.  For example,
 391 Turkish makam music uses 1/9th tone alterations.
 392
 393 @lilypondfile{makam-example.ly}
 394
 395 @item
 396 Tie directions may be set with @code{^~} and @code{_~}.
 397
 398 @item
 399 Tablature now supports harmonics and slides:
 400
 401 @lilypond[relative=1]
 402 \new TabVoice {
 403   <c g'\harmonic>4 d\2\glissando e2\2
 404 }
 405 @end lilypond
 406
 407 This feature was sponsored by Mike Amundsen
 408
 409 @item
 410 Horizontal spacing now follows object outlines more accurately.
 411 This allows tighter horizontal spacing.
 412
 413 @lilypond[]
 414 {
 415   \stemUp
 416   c''4... ceses'! s16
 417 }
 418 @end lilypond
 419
 420 @item
 421 Objects that belong outside of the staff are now positioned
 422 automatically to avoid collisions.
 423
 424 @lilypond[relative=1]
 425 c''4
 426 \once \override TextScript #'self-alignment-X = #CENTER
 427 a,4^"this doesn't collide with the c"
 428 b4^"this goes above the previous markup"
 429 a8_"this goes below the dynamic"
 430 a8\f
 431 @end lilypond
 432
 433 @item
 434 Staves are spaced vertically using a skyline algorithm.  This helps
 435 prevent uneven vertical spacing.
 436
 437 @lilypond[ragged-right]
 438
 439 %% todo: fix 'landscape PDF.
 440 #(set-default-paper-size "a6")
 441 \header {
 442   tagline = ##f
 443 }
 444
 445 \book {
 446   \score {
 447     {
 448       a,,1
 449       a'4 b' c'' d'' \break
 450       \repeat unfold 2 { a'4 b' c'' d''}
 451       b''''1
 452     }
 453   }
 454 }
 455 @end lilypond
 456
 457 @end itemize
 458
 459
 460
 461 @ifhtml
 462 For older news, go to
 463 @uref{http://lilypond.org/doc/v2.10/Documentation/topdocs/NEWS.html},
 464 or @uref{../,go back} to the Documentation index.
 465
 466
 467 @end ifhtml
 468
 469 @bye