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