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