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