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