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