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