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