Documentation/changes.tely

   1 \input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
   2 @setfilename lilypond-changes.info
   3 @settitle LilyPond Changes
   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 @afourpaper
  33
  34 @finalout
  35
  36 @node Top
  37 @top New features in 2.13 since 2.12
  38
  39 @ifhtml
  40 This document is also available in @uref{changes.pdf,PDF}. It is part of
  41 the @uref{lilypond/manuals.html,LilyPond Documentation}.
  42 @end ifhtml
  43
  44
  45
  46
  47 @itemize @bullet
  48
  49 @ignore
  50
  51 HINTS
  52
  53 * only show verbatim input for syntax/input changes
  54
  55 * try to be as brief possible in those cases
  56
  57 * don't try to provide real-world examples, they often get too big,
  58 which scares away people.
  59
  60 * Write complete sentences.
  61
  62 * only show user-visible changes.
  63
  64 @end ignore
  65
  66 @item
  67 A half-open articulation was added:
  68 @lilypond[quote,relative=2]
  69 c4\halfopen
  70 @end lilypond
  71 This is sometimes used to indicate half-open hi-hats.
  72
  73 @item
  74 The Unicode Bidirectional Algorithm is now fully supported for
  75 single-line markup due to enhanced integration with Pango.
  76
  77 @item
  78 LilyPond is now licensed under the GNU GPL v3+.
  79
  80 @item
  81 In tablature, frets can be indicated with labels other than numbers:
  82
  83 @lilypond[verbatim,quote,relative=1]
  84 \new TabStaff
  85 \with {
  86   stringTunings = #'(17 14 9 5 2 -3)
  87   tablatureFormat = #fret-letter-tablature-format
  88 }
  89 \new TabVoice {
  90   \set fretLabels = #`(,(markup #:with-color red "a")
  91                        "b"
  92                        ,(markup #:italic #:smaller "c"))
  93   <f d>4. <bes>8 <g e>4
  94 }
  95 @end lilypond
  96
  97 @item
  98 Layout objects can be printed over a white background, which whites-out objects
  99 in lower layers which lie beneath:
 100
 101 @lilypond[verbatim,quote,relative=1]
 102 \time 3/4
 103 \override Staff.StaffSymbol #'layer = #4
 104 \once \override Tie #'layer = #2
 105 b'2.~
 106 \once \override Staff.TimeSignature #'whiteout = ##t
 107 \once \override Staff.TimeSignature #'layer = #3
 108 \time 5/4
 109 b4
 110 @end lilypond
 111
 112 @item
 113 Chords can be repeated using the @code{q} shortcut:
 114
 115 @lilypond[verbatim,quote,relative=2]
 116 <c e g>8.-^ q16 q4-^
 117 @end lilypond
 118
 119 @item
 120 Paper margin defaults, as specified in @file{ly/@/paper@/-defaults@/-init@/.ly}, apply
 121 to the default paper size (a4) and are automatically scaled according to the
 122 paper size chosen.
 123
 124 @item
 125 All combinations of @code{left-margin}, @code{right-margin} and
 126 @code{line-width} work now.  There is no more need to set @code{line-width}
 127 manually unless you explicitly want to.
 128
 129 @item
 130 Support for using an alternative music font, such as Gonville, is now
 131 added.
 132
 133 @item
 134 In addition to the existing @code{\hspace} markup command,
 135 a new @code{\vspace} command has been added to provide an easy
 136 and flexible way to add vertical space in markups.
 137
 138 @item
 139 The direction of manual beams can be set with @code{^[} and @code{_[}.
 140
 141 @item
 142 A version of the breve note head has been added with two vertical lines on each side.
 143 @lilypond[quote,relative=2]
 144 \time 4/2
 145 \override Staff.NoteHead #'style = #'altdefault
 146 c\breve | b\breve
 147 @end lilypond
 148
 149 @item
 150 Instrument names and vocal names now take into account the extent of
 151 system start delimiters in other staves for their positioning,
 152 resulting in improved default alignment for left-, center- and
 153 right-aligned names.
 154 @lilypond[quote,indent=18\mm]
 155 <<
 156   \new StaffGroup <<
 157     \new GrandStaff <<
 158       \new Staff {
 159         \set Staff.instrumentName = #"Piccolo"
 160         c''1
 161       }
 162       \new Staff {
 163         \set Staff.instrumentName = #"Flute"
 164         c''1
 165       }
 166     >>
 167     \new Staff {
 168       \set Staff.instrumentName = #"Bassoon"
 169       \clef tenor
 170       c'1
 171     }
 172   >>
 173   \new PianoStaff <<
 174     \set PianoStaff.instrumentName = #"Piano"
 175     \context Staff = "up" {
 176       c'1
 177     }
 178     \context Staff = "down" {
 179       \clef bass
 180       c1
 181     }
 182   >>
 183 >>
 184 @end lilypond
 185
 186 @item
 187 Braces in markup can now be selected by point size using the markup commands
 188 @code{\left-brace} and @code{\right-brace}.
 189 @lilypond[quote]
 190 \markup {
 191   \left-brace #35
 192   \hspace #2
 193   \right-brace #45
 194 }
 195 @end lilypond
 196
 197 @item
 198 Intermediate .ps files which are created by LilyPond
 199 during compilation are now deleted by default.  To keep them,
 200 add the following line to your input files:
 201 @example
 202 #(ly:set-option 'delete-intermediate-files #f)
 203 @end example
 204
 205 @item
 206 Dashed and dotted slurs, phrasing slurs, and ties
 207 have been made variable thickness, and
 208 partially dashed slurs are now available:
 209 @lilypond[quote,relative=2]
 210 \slurDashed
 211 c4( d e f) |
 212 \slurDotted
 213 g4( f e d) |
 214 \slurHalfDashed
 215 c4( d e f)
 216 @end lilypond
 217
 218 @item
 219 An eyeglasses markup was added, indicating strongly to look at the
 220 conductor for instructions:
 221 @lilypond[quote,relative=2]
 222 \mark \markup { \eyeglasses }
 223 c4_\markup { \eyeglasses }
 224 @end lilypond
 225
 226 @item
 227 A snap-pizzicato (also known as Bartok-pizzicato) articulation was added:
 228 @lilypond[quote,relative=2]
 229 c4\snappizzicato
 230 @end lilypond
 231
 232 @item
 233 Tuplet number formatting functions are now available to print other fractions
 234 and to add notes to the number or fraction:
 235 @lilypond[quote,relative=2]
 236 \once \override TupletNumber #'text =
 237   #(tuplet-number::non-default-tuplet-denominator-text 7)
 238 \times 2/3 { c4. c4. c4. c4. }
 239
 240 \once \override TupletNumber #'text =
 241   #(tuplet-number::non-default-tuplet-fraction-text 12 7)
 242 \times 2/3 { c4. c4. c4. c4. }
 243 \once \override TupletNumber #'text =
 244   #(tuplet-number::append-note-wrapper
 245     (tuplet-number::non-default-tuplet-fraction-text 12 7) "8")
 246 \times 2/3 { c4. c4. c4. c4. }
 247
 248 \once \override TupletNumber #'text =
 249   #(tuplet-number::append-note-wrapper tuplet-number::calc-denominator-text "4")
 250 \times 2/3 { c8 c8 c8 c8 c8 c8 }
 251 \once \override TupletNumber #'text =
 252   #(tuplet-number::append-note-wrapper tuplet-number::calc-fraction-text "4")
 253 \times 2/3 { c8 c8 c8 c8 c8 c8 }
 254
 255 \once \override TupletNumber #'text =
 256   #(tuplet-number::fraction-with-notes "4." "8")
 257 \times 2/3 { c4. c4. c4. c4. }
 258 \once \override TupletNumber #'text =
 259   #(tuplet-number::non-default-fraction-with-notes 12 "8" 4 "4")
 260 \times 2/3  { c4. c4. c4. c4. }
 261 @end lilypond
 262
 263 @item
 264 FretBoards now have a chordChanges property to keep repeated FretBoard objects
 265 from being typeset.
 266
 267 @end itemize
 268
 269
 270
 271 @ifhtml
 272 For older news, go to
 273 @uref{http://lilypond.org/doc/v2.12/Documentation/topdocs/NEWS.html},
 274 @uref{http://lilypond.org/doc/v2.10/Documentation/topdocs/NEWS.html},
 275 or @uref{../,go back} to the Documentation index.
 276
 277
 278 @end ifhtml
 279
 280 @bye