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