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