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