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