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 The @code{\clef} command supports optional octavation:
  66 @lilypond[verbatim,quote,relative=1]
  67 \clef "treble_(8)"
  68 c2 c
  69 \clef "bass^[15]"
  70 c2 c
  71 @end lilypond
  72
  73 @item
  74 The LilyPond syntax of dot-separated words @code{Voice.Accidental}
  75 has been made interchangeable with @code{#'(Voice Accidental)}, a
  76 Scheme list of symbols.  As one result, code like
  77 @example
  78 \override Voice.TextSpanner #'(bound-details left text) = "rit."
  79 @end example
  80 is now equivalent to
  81 @example
  82 \override Voice.TextSpanner bound-details.left.text = "rit."
  83 @end example
  84 or even
  85 @example
  86 \override #'(Voice TextSpanner) bound-details.left.text = "rit."
  87 @end example
  88
  89 @item
  90 Grob and grob property path no longer need to be specified as two
  91 separate arguments to commands like @samp{\override} and
  92 @code{\revert}, allowing for the syntax
  93 @example
  94 \override Voice.TextSpanner.bound-details.left.text = "rit."
  95 @end example
  96 Since complementary music functions like @samp{\overrideProperty}
  97 cannot support forms with and without separating space at the same
  98 time, using a single dotted path is now the preferred form.
  99 Specifying grob path and grob property path separately, currently
 100 still supported with @samp{\override} and @samp{\revert} for
 101 compatibility reasons, is deprecated.
 102
 103 @item
 104 Due to words now being accepted as symbol function arguments, the
 105 interfaces of @samp{\accidentalStyle}, @samp{\alterBroken},
 106 @samp{\footnote} and @samp{\tweak} had to be redesigned where
 107 optional symbol arguments were involved.  Please check the
 108 respective music function documentation for details.
 109
 110 @item
 111 Several commands now accept symbol lists (conveniently entered as
 112 dot-separated words) for various kinds of arguments.  These
 113 include @samp{\accidentalStyle}, @samp{\alterBroken},
 114 @samp{\footnote}, @samp{\hide}, @samp{\omit},
 115 @samp{\overrideProperty}, @samp{\shape}, and @samp{\tweak}.
 116
 117 @item
 118 The bar line user interface has changed. Bar glyphs now resemble the
 119 appearance of the bar line, so a left repeat sign has to be coded
 120 as @code{.|:}. The command @code{\defineBarLine} provides an easy way
 121 to define additional bar line styles.
 122
 123 @item
 124 Accidentals in the key signature may be printed in octaves other
 125 than their traditional positions, or in multiple octaves.
 126 @lilypond[quote,relative=0]
 127 \override Staff.KeySignature #'flat-positions = #'((-5 . 5))
 128 \override Staff.KeyCancellation #'flat-positions = #'((-5 . 5))
 129 \clef bass \key es\major es g bes d
 130 \clef treble \bar "||" \key es\major es g bes d
 131 \override Staff.KeySignature #'sharp-positions = #'(2)
 132 \bar "||" \key d\major b fis b2
 133 @end lilypond
 134
 135 @end itemize
 136
 137 @ifhtml
 138 For older news, go to
 139 @uref{http://lilypond.org/doc/v2.16/Documentation/changes/},
 140 @uref{http://lilypond.org/doc/v2.14/Documentation/changes/},
 141 or @uref{../,go back} to the Documentation index.
 142
 143
 144 @end ifhtml
 145
 146 @bye