Documentation/changes.tely

   1 \input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
   2 @setfilename lilypond-changes.info
   3 @settitle LilyPond Changes
   4
   5 @include macros.itexi
   6
   7 @ifhtml
   8 @macro inputfileref{DIR,NAME}
   9 @uref{../../\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c
  10 @end macro
  11 @macro usermanref{NAME}
  12 @inforef{\NAME\,,../user/lilypond/lilypond}@c
  13 @end macro
  14 @end ifhtml
  15
  16 @ifnothtml
  17 @macro inputfileref{DIR,NAME}
  18 @file{\DIR\/\NAME\}@c
  19 @end macro
  20 @macro usermanref{NAME}
  21 See user manual, \NAME\
  22 @end macro
  23 @end ifnothtml
  24
  25 @macro textanchor{NAME}
  26 @html
  27 <a name="\NAME\"></a>
  28 @end html
  29 @end macro
  30
  31
  32 @documentencoding utf-8
  33 @documentlanguage en
  34 @afourpaper
  35
  36 @finalout
  37
  38 @node Top
  39 @top New features in 2.18 since 2.16
  40
  41 @allowcodebreaks false
  42
  43 @itemize
  44
  45 @ignore
  46
  47 HINTS
  48
  49 * add new items at the top
  50
  51 * only show verbatim input for syntax/input changes
  52
  53 * try to be as brief possible in those cases
  54
  55 * don't try to provide real-world examples, they often get too big,
  56 which scares away people.
  57
  58 * Write complete sentences.
  59
  60 * only show user-visible changes.
  61
  62 @end ignore
  63
  64 @item
  65 Tuplets are now created with the @code{\tuplet} command, which
  66 takes a fraction @code{@var{t}/@var{n}} to specify that @var{t}
  67 notes are played in the time usually allowed for @var{n}. One
  68 @code{\tuplet} command can create several tuplet groups if their
  69 duration is typed after the fraction.
  70 @lilypond[quote,verbatim,relative=2]
  71 \tuplet 3/2 { c8 d e } \tuplet 3/2 { f e d } c2
  72 \tuplet 3/2 4 { c8 d e f e d } c2
  73 @end lilypond
  74 The @code{\times} command with its inverted fraction order
  75 @code{@var{n}/@var{t}} is still available.
  76
  77 @item
  78 Introducing two new markup-commands; @code{\draw-dashed-line} and
  79 @code{\draw-dotted-line}.
  80
  81 @noindent
  82 The dashed-line extends to the whole length given by @var{dest}, if
  83 @code{full-length} is set to @code{#t} (this is the default) without any
  84 space at the beginning or end.  @code{off} will then be altered to fit.
  85 To insist on the given (or default) values of @code{on}, @code{off} use
  86 @code{\override #'(full-length . #f)}.  Manual settings for @code{on},
  87 @code{off} and @code{phase} are possible.
  88
  89 @noindent
  90 The dotted-line always extends to the whole length given by @var{dest},
  91 without any space at the beginning or end.  Manual settings for
  92 @code{off} are possible to get larger or smaller space between the dots.
  93 The given (or default) value of @code{off} will be altered to fit the
  94 line-length.
  95
  96 @lilypond[verbatim,quote]
  97 \markup {
  98   \draw-dashed-line #'(5.1 . 2.3)
  99   \override #'(on . 0.3)
 100   \override #'(off . 0.5)
 101   \draw-dashed-line #'(5.1 . 2.3)
 102   \draw-dotted-line #'(5.1 . 2.3)
 103   \override #'(thickness . 2)
 104   \override #'(off . 0.2)
 105   \draw-dotted-line #'(5.1 . 2.3)
 106 }
 107 @end lilypond
 108
 109 @item
 110 Starting with version@tie{}2.17.10, error messages or the
 111 @code{textedit} @acronym{URI} used for point-and-click
 112 functionality specify column numbers starting with@tie{}1 rather
 113 than@tie{}0.  The byte offset (also part of @code{textedit}
 114 @acronym{URI}s) still starts at@tie{}0.
 115
 116 @item
 117 The @code{\clef} command supports optional octavation:
 118 @lilypond[verbatim,quote,relative=1]
 119 \clef "treble_(8)"
 120 c2 c
 121 \clef "bass^[15]"
 122 c2 c
 123 @end lilypond
 124
 125 @item
 126 The LilyPond syntax of dot-separated words @code{Voice.Accidental}
 127 has been made interchangeable with @code{#'(Voice Accidental)}, a
 128 Scheme list of symbols.  As one result, code like
 129 @example
 130 \override Voice.TextSpanner #'(bound-details left text) = "rit."
 131 @end example
 132 is now equivalent to
 133 @example
 134 \override Voice.TextSpanner bound-details.left.text = "rit."
 135 @end example
 136 or even
 137 @example
 138 \override #'(Voice TextSpanner) bound-details.left.text = "rit."
 139 @end example
 140
 141 @item
 142 Grob and grob property path no longer need to be specified as two
 143 separate arguments to commands like @samp{\override} and
 144 @code{\revert}, allowing for the syntax
 145 @example
 146 \override Voice.TextSpanner.bound-details.left.text = "rit."
 147 @end example
 148 Since complementary music functions like @samp{\overrideProperty}
 149 cannot support forms with and without separating space at the same
 150 time, using a single dotted path is now the preferred form.
 151 Specifying grob path and grob property path separately, currently
 152 still supported with @samp{\override} and @samp{\revert} for
 153 compatibility reasons, is deprecated.
 154
 155 @item
 156 Due to words now being accepted as symbol function arguments, the
 157 interfaces of @samp{\accidentalStyle}, @samp{\alterBroken},
 158 @samp{\footnote} and @samp{\tweak} had to be redesigned where
 159 optional symbol arguments were involved.  Please check the
 160 respective music function documentation for details.
 161
 162 @item
 163 Several commands now accept symbol lists (conveniently entered as
 164 dot-separated words) for various kinds of arguments.  These
 165 include @samp{\accidentalStyle}, @samp{\alterBroken},
 166 @samp{\footnote}, @samp{\hide}, @samp{\omit},
 167 @samp{\overrideProperty}, @samp{\shape}, and @samp{\tweak}.
 168
 169 @item
 170 The bar line user interface has changed. Bar glyphs now resemble the
 171 appearance of the bar line, so a left repeat sign has to be coded
 172 as @code{.|:}. The command @code{\defineBarLine} provides an easy way
 173 to define additional bar line styles.
 174
 175 @item
 176 Accidentals in the key signature may be printed in octaves other
 177 than their traditional positions, or in multiple octaves.
 178 @lilypond[quote,relative=0]
 179 \override Staff.KeySignature #'flat-positions = #'((-5 . 5))
 180 \override Staff.KeyCancellation #'flat-positions = #'((-5 . 5))
 181 \clef bass \key es\major es g bes d
 182 \clef treble \bar "||" \key es\major es g bes d
 183 \override Staff.KeySignature #'sharp-positions = #'(2)
 184 \bar "||" \key d\major b fis b2
 185 @end lilypond
 186
 187 @end itemize
 188
 189 @ifhtml
 190 For older news, go to
 191 @uref{http://lilypond.org/doc/v2.16/Documentation/changes/},
 192 @uref{http://lilypond.org/doc/v2.14/Documentation/changes/},
 193 or @uref{../,go back} to the Documentation index.
 194
 195
 196 @end ifhtml
 197
 198 @bye