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.20 since 2.18
  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 @item
  64 Isolated durations in music sequences now stand for unpitched
  65 notes.  This may be useful for specifying rhythms to music or
  66 scheme functions.  When encountered in the final score, the
  67 pitches are provided by the preceding note or chord.  Here are two
  68 examples where this makes for readable input:
  69
  70 @lilypond[verbatim,quote]
  71 \new DrumStaff \with { \override StaffSymbol.line-count = 1 }
  72 \drummode {
  73   \time 3/4
  74   tambourine 8 \tuplet 3/2 { 16 16 16 }
  75              8 \tuplet 3/2 { 16 16 16 } 8 8 |
  76 }
  77 @end lilypond
  78
  79 @lilypond[verbatim,quote]
  80 \new Staff { r16 c'16 ~ 8 ~ 4 ~ 2 | }
  81 @end lilypond
  82
  83 @item
  84 Beaming exceptions can now be constructed using the
  85 @code{\beamExceptions} scheme function.  One can now write
  86
  87 @lilypond[verbatim,quote,relative=1]
  88 \time #'(2 1) 3/16
  89 \set Timing.beamExceptions =
  90   \beamExceptions { 32[ 32] 32[ 32] 32[ 32] }
  91 c16 c c |
  92 \repeat unfold 6 { c32 } |
  93 @end lilypond
  94
  95 @noindent
  96 with multiple exceptions separated with @code{|} bar checks
  97 (writing the exception pattern without pitches is convenient but
  98 not mandatory).  Previously, setting the beam exceptions would
  99 have required writing
 100
 101 @example
 102 \set Timing.beamExceptions =
 103 #'(                         ;start of alist
 104    (end .                   ;entry for end of beams
 105     (                       ;start of alist of end points
 106      ((1 . 32) . (2 2 2))   ;rule for 1/32 beams -- end each 1/16
 107     )))
 108 @end example
 109
 110 @item
 111 The most common articulations are now reflected in MIDI output.
 112 Accent and marcato make notes louder; staccato, staccatissimo and
 113 portato make them shorter. Breath marks shorten the previous
 114 note.
 115
 116 This behavior is customizable through the @code{midiLength} and
 117 @code{midiExtraVelocity} properties on @code{ArticulationEvent}.
 118 See @file{script-init.ly} for examples.
 119
 120 @item
 121 The PostScript functionality of stroke adjustment is no longer
 122 applied automatically but left to the discretion of the PostScript
 123 device (by default, Ghostscript uses it for resolutions up to
 124 150dpi when generating raster images).  When it is enabled, a more
 125 complex drawing algorithm designed to benefit from stroke
 126 adjustment is employed mostly for stems and bar lines.
 127
 128 Stroke adjustment can be forced by specifying the command line
 129 option @samp{-dstrokeadjust} to LilyPond.  When generating
 130 @code{PDF} files, this will usually result in markedly better
 131 looking @code{PDF} previews but significantly larger file size.
 132 Print quality at high resolutions will be unaffected.
 133
 134 @end itemize
 135
 136 @ifhtml
 137 For older news, go to
 138 @uref{http://lilypond.org/doc/v2.18/Documentation/changes/},
 139 @uref{http://lilypond.org/doc/v2.16/Documentation/changes/},
 140 or @uref{../,go back} to the Documentation index.
 141
 142
 143 @end ifhtml
 144
 145 @bye