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\/out-www/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c
   8 @end macro
   9 @macro usermanref{NAME}
  10 @inforef{\NAME\,,../../user/out-www/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
  24 @macro textanchor{NAME}
  25 @html
  26 <a name="\NAME\"></a>
  27 @end html
  28 @end macro
  29
  30
  31 @documentencoding utf-8
  32 @documentlanguage en
  33
  34 @ifnottex
  35 @node Top
  36 @top
  37 @end ifnottex
  38 @unnumbered New features in 2.7 since 2.6
  39
  40 @ifhtml
  41 This document is also available in @uref{NEWS.pdf,PDF}.
  42 @end ifhtml
  43
  44
  45
  46
  47 @itemize @bullet
  48 @item
  49 Vertical alignments of staves can now be tuned easily for individual
  50 systems.
  51
  52 @lilypond[raggedright]
  53 #(set-global-staff-size 13)
  54 \relative c'' <<
  55   \new PianoStaff <<
  56     \new Voice  {
  57       \set PianoStaff.instrument = #"piano"
  58       \set PianoStaff.instr = #"pn"
  59       c1_"normal"
  60
  61       \overrideProperty
  62       #"Score.NonMusicalPaperColumn"
  63       #'line-break-system-details
  64       #'((fixed-alignment-extra-space . 15))
  65       c
  66
  67     }
  68     {
  69         c1\break
  70         c\break
  71     }
  72   >>
  73 >>
  74 @end lilypond
  75
  76 This feature was sponsored by Nicolas Sceaux.
  77
  78 @item
  79 Vertical spacing for page layout can now be tuned for each system
  80 individually.  The dimensions that can be tuned can be visualized.
  81
  82 @lilypond[verbatim]
  83 #(set-default-paper-size "a7" 'landscape)
  84 \book {
  85  \score { { c4 } }
  86  \paper { annotatespacing = ##t }
  87 }
  88 @end lilypond
  89
  90 These features were sponsored by Trevor Bača and Nicolas Sceaux.
  91
  92 @item
  93 The slope of a stem-tremolo may be set manually
  94
  95 @lilypond[fragment,relative=1,raggedright]
  96 c8:16[
  97 \once \override StemTremolo #'slope = #0.45
  98 c:16 c:16 c:16 ]
  99 @end lilypond
 100
 101 This feature was sponsored by Sven Axelsson.
 102
 103 @item
 104 Laissez vibrer ties can be created with @code{\laissezVibrer},
 105
 106 @lilypond[fragment,raggedright,relative=1]
 107   <c e g>\laissezVibrer r  <d f>\laissezVibrer
 108 @end lilypond
 109
 110 This feature was sponsored by Henrik Frisk.
 111
 112 @item
 113 The order of words in @code{\markup} commands may now be reversed by
 114 setting the @code{text-direction} property. This is useful for
 115 Right-to-Left languages like Hebrew.
 116
 117 This feature was sponsored by Aaron Mehl.
 118
 119 @item
 120 Texts over multi measure rests can stretch the corresponding measure,
 121 if the appropriate @code{spacing-procedure} property is set.
 122
 123 @lilypond[relative=2,fragment,raggedright]
 124 \override MultiMeasureRestText #'spacing-procedure
 125   = #Multi_measure_rest::set_text_rods
 126 c1 R1 R1^"Very long long long text"
 127 @end lilypond
 128
 129 This feature was sponsored by Kris Shaffer.
 130
 131
 132 @item @textanchor{tie-chords}
 133 Formatting of ties in chords has been improved. Ties no longer collide
 134 with note heads and stems. In addition, it is possible to manually
 135 specify tie formatting
 136
 137 @lilypond[relative=2, fragment,raggedright]
 138   <a c d f> ~ <a c d f>
 139
 140   \override TieColumn #'tie-configuration =
 141   #'((0 . -1)  (2 . -1) (5.5 . 1) (7 . 1))
 142   <b d f g> ~ <b d f g>
 143 @end lilypond
 144
 145 This improvement has been sponsored by Bertalan Fodor, Jay Hamilton,
 146 Kieren MacMillan, Steve Doonan, Trevor Bača, and Vicente Solsona
 147 Dell¡.
 148
 149 @item
 150 Formatting of isolated, single ties has been improved. Now, ties avoid
 151 staff lines, flags and dots, without compromising their shape.
 152
 153 @lilypond[fragment,raggedright]
 154 \relative c'' {
 155   \stemUp
 156   c16 c2...~ c16 ~ c2... |
 157   c4~c8 c8~c16 c16~c32 c16.~[ c64]~ c64[ c8..] |
 158 }
 159 @end lilypond
 160
 161 This improvement has been sponsored by Bertalan Fodor, Jay Hamilton,
 162 Kieren MacMillan, Steve Doonan, Trevor Bača, and Vicente Solsona
 163 Dell¡.
 164
 165
 166 @item  @textanchor{repeat-counter}
 167 With the @code{countPercentRepeats} property,
 168 percent repeats get incremental numbers to indicate the accumulated repeat count.
 169
 170 @lilypond[relative=2,fragment,raggedright]
 171 \set countPercentRepeats = ##t
 172 \repeat percent 4 { c1 }
 173 \time 2/4
 174 \repeat percent 4 { c2 c2 }
 175 @end lilypond
 176
 177 This feature was sponsored by Yoshinobu Ishizaki
 178
 179 @item
 180 Text scripts such as fingering instructions and dynamics avoid
 181 collisions with slurs
 182
 183 @lilypond[fragment,relative=1]
 184 {
 185   b_1( f'_1_2_3 c_3_4_5 a)
 186   b( f'\p b,)
 187   c-2_\markup { \italic {"cresc."}} ( f_\markup {x} c)
 188 }
 189 @end lilypond
 190
 191 @item
 192 Tuplets can be made to reach the next non-tuplet note by setting the
 193 @code{tupletFullLength}  property,
 194
 195 @lilypond[fragment,relative=2]
 196 \new Voice \with {
 197   \remove Forbid_line_break_engraver
 198   allowBeamBreak = ##t
 199 }
 200 {
 201   \set Score.proportionalNotationDuration = #(ly:make-moment 1 32)
 202   \set tupletFullLength = ##t
 203   \times 2/3 { c8[ c c] }
 204   c4
 205 }
 206 @end lilypond
 207
 208 This feature was sponsored by Trevor Bača.
 209
 210 @item
 211 When @code{strict-note-spacing} is set, notes are spaced without regard
 212 for clefs, bar lines, and grace notes. For example,
 213
 214 @lilypond[fragment,relative=2]
 215 \override Score.SpacingSpanner #'strict-note-spacing = ##t
 216 \new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c]  c32[ c32] }
 217 @end lilypond
 218
 219 This feature was sponsored by Trevor Bača.
 220
 221 @item
 222 Beams support the @code{break-overshoot} property, for example
 223
 224 @lilypond[relative=2,fragment]
 225 \set allowBeamBreak = ##t
 226 \override Beam #'break-overshoot = #'(1.0 . 2.0)
 227 c2.. c8[ \break c]
 228 @end lilypond
 229
 230 This feature was sponsored by Trevor Bača.
 231
 232 @item
 233 Proportional notation is supported.  Notes can be spaced proportional
 234 to their time-difference by assigning a duration to
 235 @code{proportionalNotationDuration}. For example,
 236
 237 @lilypond[relative=2,fragment,raggedright]
 238 <<
 239   \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
 240   \new Staff { c8[ c c c c c]  c4 c2 r2 }
 241   \new Staff { c2  \times 2/3 { c8 c c } c4 c1 }
 242 >>
 243 @end lilypond
 244
 245 This feature was sponsored by Trevor Bača.
 246
 247 @item
 248 Symbol sizes (e.g. accidentals) are disregarded for spacing if
 249 @code{uniform-stretching} of the @code{SpacingSpanner} grob is set,
 250
 251
 252 @lilypond[relative=2,fragment]
 253 <<
 254   \override  Score.SpacingSpanner #'uniform-stretching = ##t
 255   \new Staff { c16[ c c c c c c c c c16]  }
 256   \new Staff {
 257     \times 6/7 { c16 c c cis c c c }
 258     c8[ c32 c32 c16]
 259   }
 260 >>
 261 @end lilypond
 262
 263 This feature was sponsored by Trevor Bača.
 264
 265 @item
 266 Endings of broken tuplet brackets can be tuned.  For example, you can
 267 add arrows to the brackets,
 268
 269 @lilypond[fragment,raggedright,relative=2]
 270 \override TupletBracket
 271  #'edge-text = #(cons
 272              (markup #:arrow-head X LEFT #f)
 273              (markup #:arrow-head X RIGHT #f))
 274 \times 4/5 {
 275  c c c \bar "empty" \break c c
 276 }
 277 @end lilypond
 278
 279 This feature was sponsored by Trevor Bača.
 280
 281
 282 @item @textanchor{arrow-glyph}
 283 Arrow heads were added to the Feta font.
 284
 285 @lilypond[]
 286 \lyrics {
 287   \markup {
 288     filled, to the right:  \hspace #2.0 \fontsize #6 \arrow-head #0 #1 ##t
 289     open, down: \hspace #2.0 \fontsize #6 \arrow-head #1 #-1 ##f
 290   }
 291 }
 292 @end lilypond
 293
 294 These glyphs have been sponsored by Trevor Bača.
 295
 296
 297 @item
 298 Nested tuplets are automatically positioned,
 299
 300 @lilypond[fragment,raggedright,relative=2]
 301 \set tupletNumberFormatFunction = #fraction-tuplet-formatter
 302 \times 4/6 {
 303   a4 a
 304   \times 3/5 { a a a a a }
 305 }
 306 @end lilypond
 307
 308 This feature was sponsored by Trevor Bača.
 309
 310 @item
 311 Music expressions can be displayed, in LilyPond notation, using the
 312 new @code{\displayLilyMusic} function. For instance:
 313 @verbatim
 314 \displayLilyMusic \transpose c a, { c d e f }
 315 @end verbatim
 316 will print:
 317 @verbatim
 318 { a, b, cis d }
 319 @end verbatim
 320
 321 This feature was contributed by Nicolas Sceaux.
 322
 323 @item
 324 The current bar number may be checked with @code{\barNumberCheck}, eg.
 325
 326 @verbatim
 327 \barNumberCheck #22
 328 @end verbatim
 329
 330 @noindent
 331 will print a warning if it doesn't happen in measure 22.
 332
 333 @item
 334 If @code{showLastLength} is set, only the last few measures of a piece
 335 are rendered, which speeds up correcting scores. For example, setting
 336
 337 @verbatim
 338 showLastLength = R1*5
 339 \score { ... }
 340 @end verbatim
 341
 342 @noindent
 343 will render only the last five measures (assuming 4/4 time signature)
 344 of a piece.
 345
 346 @item @textanchor{simple-melismata}
 347 Melismata can be specified simply in the lyrics now, eg.
 348
 349 @lilypond[relative=1,verbatim,fragment]
 350 {
 351   c d( e) f e d
 352 } \addlyrics {
 353   Ky -- _ _ ri e
 354 }
 355 @end lilypond
 356
 357 This feature was sponsored by Nancho Alvarez
 358
 359 @item
 360 Suggested accidentals (for notating musica ficta) may be switched on
 361 with @code{suggestAccidentals}
 362
 363 @lilypond[verbatim,fragment,relative=2]
 364 \set suggestAccidentals = ##t
 365 ais bis
 366 @end lilypond
 367
 368 This feature was sponsored by Nancho Alvarez.
 369
 370 @item
 371 The setting @code{whichBar} and time-bookkeeping is now split into a
 372 @code{Default_bar_line_engraver} and @code{Timing_translator}
 373 respectively.
 374
 375 @item @textanchor{pitched-trill}
 376 Explicit pitches may be added to trills,
 377
 378 @lilypond[relative,verbatim,fragment]
 379   \pitchedTrill c4\startTrillSpan fis f\stopTrillSpan
 380 @end lilypond
 381
 382 This feature was sponsored by D. Josiah Boothby and Jamie Bullock
 383
 384 @item
 385 Markup now supports formatting of text paragraphs, using
 386 @code{\wordwrap} and @code{\justify}.
 387
 388 This feature was sponsored by Sven Axelsson.
 389 @end itemize
 390
 391 @ifhtml
 392 For older news, go to
 393 @uref{http://lilypond.org/doc/v2.6/Documentation/topdocs/out-www/NEWS.html}.
 394 @end ifhtml
 395
 396 @bye