Documentation/topdocs/NEWS.texi

   1 \input texinfo @c -*-texinfo-*-
   2 @setfilename NEWS.info
   3 @settitle NEWS
   4
   5 @node Top, , ,
   6 @top
   7
   8 @chapter New features in 1.9 since 1.8
   9
  10 @itemize
  11 @item
  12 Markup text (ie. general text formatting) may now be used for lyrics too.
  13
  14 @item
  15 Two new commands for grace notes have been added, @code{\acciaccatura}
  16 and @code{\appoggiatura},
  17
  18 @example
  19   \appoggiatura f8 e4
  20   \acciaccatura g8 f4
  21 @end example
  22
  23 Both reflect the traditional meanings of acciaccatura and appogiatura,
  24 and both insert insert a slur from the first grace note to the main
  25 note.
  26
  27 @item
  28 Layout options for grace notes are now stored in a context property,
  29 and may now be set separately from musical content.
  30
  31 @item
  32 The @code{\new} command will create a context with a unique
  33 name automatically. Hence, for multi-staff scores, it is no longer
  34 necessary to invent arbitrary context names. For example, a two-staff
  35 score may be created by
  36
  37 @example
  38   \simultaneous @{
  39     \new Staff @{ @var{notes for 1st staff} @}
  40     \new Staff @{ @var{notes for 2nd staff} @}
  41   @}
  42 @end example
  43
  44
  45
  46 @item
  47 Octave checks make octave errors easier to correct.
  48 The syntax is
  49
  50 @example
  51   \octave @var{pitch}
  52 @end example
  53
  54 This checks that @var{pitch} (without octave) yields @var{pitch} (with
  55 octave) in \relative mode. If not, a warning is printed, and the
  56 octave is corrected.
  57
  58 @item
  59 All articulations must now be entered postfix. For example,
  60
  61 @example
  62         c8[( d8])
  63 @end example
  64
  65 @noindent
  66 is a pair of beamed slurred eighth notes.
  67
  68 @item
  69 The definition of @code{\relative} has been simplified.  Octaves are
  70 now always propagated in the order that music is entered. In the
  71 following example,
  72
  73 @example
  74   PRE
  75   \repeat "unfold" 3  BODY \alternative @{ ALT1 ALT2 @}
  76   POST
  77 @end example
  78
  79 @noindent
  80 the octave of BODY is based on PRE, the starting octave of ALT1 on
  81 BODY, the starting octave of ALT2 on ALT1, and the starting octave of
  82 POST on ALT2.
  83
  84 The same mechanism is used for all other music expressions, except the
  85 chord. Backwards compatibility is retained through a special program option,
  86 which is set through
  87
  88 @example
  89   #(ly:set-option 'old-relative)
  90 @end example
  91
  92 @end itemize
  93
  94
  95
  96
  97 @chapter New features in 1.8 since 1.6
  98
  99 @itemize
 100
 101 @item
 102 The chord entry code has been completely rewritten. It is now
 103 cleaner and more flexible.
 104
 105 @item
 106 A new syntax has been added for text entry.  This syntax is more
 107 friendly than the old mechanism, and it is implemented in a more
 108 robust and modular way. For more information, refer to the section on
 109 "Text markup" in the notation manual.
 110
 111 @item
 112 The integration of the input language and Scheme has been made deeper:
 113 you can now use LilyPond identifiers in Scheme, and use Scheme
 114 expressions instead of LilyPond identifiers.
 115
 116 @item
 117 The internal representation of music has been cleaned up completely
 118 and converted to Scheme data structures.  The representation may be
 119 exported as XML.
 120
 121 @item
 122 A new uniform postfix syntax for articulation has been introduced.
 123 A beamed slurred pair of eighth notes can be entered as
 124
 125 @example
 126         c8-[-( d8-]-)
 127 @end example
 128
 129 In version 2.0, postfix syntax will be the only syntax
 130 available, and the dashes will become optional.
 131
 132 This will simplify the language: all articulations can be entered as
 133 postfix, in any order.
 134
 135 @item
 136 A new syntax has been added for chords:
 137
 138
 139 @example
 140         << PITCHES >>
 141 @end example
 142
 143 It is not necessary to update files to this syntax, but it will be for
 144 using LilyPond version 2.0.  In version 2.0, this syntax will be
 145 changed to
 146
 147 @example
 148         < PITCHES >
 149 @end example
 150
 151 for chords, and
 152
 153 @example
 154         \simultaneous @{ .. @}
 155 @end example
 156
 157 for simultaneous music.
 158
 159 To convert your files from <PITCHES> to <<PITCHES>>, use the script
 160 included in buildscripts/convert-new-chords.py
 161
 162 This change was introduced for the following reasons
 163
 164 @itemize @bullet
 165 @item
 166 It solves the "start score with chord" problem, where you have to
 167   state \context Voice explicitly when a chord was the start of a
 168   Staff or Score.
 169 @item
 170 With the new syntax, it is possible to distinguish between
 171   articulations (or fingerings) which are for a single chord note,
 172   and which are for the entire chord. This allows for per-note
 173   fingerings, and is more logical on the whole.
 174 @end itemize
 175
 176 @item
 177 User code may now be executed during interpreting.  The syntax for
 178 this code is
 179
 180 @example
 181         \applycontext #SCHEME-FUNCTION
 182 @end example
 183
 184 @item
 185 User code may now be executed on arbitrary grobs during interpreting.
 186 The syntax for this feature is
 187
 188 @example
 189         \applyoutput #SCHEME-FUNCTION
 190 @end example
 191
 192 @noindent
 193 SCHEME-FUNCTION takes a single argument, and is called for every grob
 194 that is created in the current context.
 195
 196 @item
 197 New algorithms for chord-name formatting have been installed. They
 198 can be tuned and have ergonomic syntax for entering exceptions.
 199
 200 @item
 201 Texts may now be put on multimeasure rests, e.g.
 202
 203 @example
 204         R1*20^\markup @{ "GP" @}
 205 @end example
 206
 207 @item
 208 Ancient notation now prints ligatures in Gregorian square neumes
 209 notation, roughly following the typographical style of the Liber
 210 hymnarius of Solesmes, published in 1983.  Ligatures are still printed
 211 without the proper line breaking and horizontal spacing.
 212
 213 @item
 214 Glissandi can now be printed using the zigzag style.
 215
 216 @item
 217 LilyPond can now print clusters. The syntax is
 218
 219 @example
 220         \apply #notes-to-clusters @{ NOTE NOTE .. @}
 221 @end example
 222
 223 @item
 224 For irregular meters, beat grouping marks can be printed. The
 225 syntax for this is
 226
 227 @example
 228         #(set-time-signature 7 8 '(3 2 2))
 229 @end example
 230
 231
 232 @item
 233 Nested horizontal brackets for music analysis can now be printed:
 234
 235 @example
 236         NOTE-\startGroup
 237                 ..
 238         NOTE-\stopGroup
 239 @end example
 240
 241
 242 @item  Ottava brackets are now fully supported as a feature.  The syntax
 243 is
 244
 245 @example
 246         #(set-octavation 1)
 247 @end example
 248
 249
 250 @item  Metronome markings are printed when a \tempo command is processed.
 251
 252
 253
 254 @item Fingerings can be put on chords horizontally.
 255
 256
 257
 258 @item  The appearance of various glyphs has been fine-tuned.
 259
 260
 261
 262 @item  Different types of percent style repeats may now be nested.
 263
 264
 265
 266 @item  The emacs support has been extended.
 267
 268
 269 @item
 270 The manual has been completely revised and extended.
 271
 272 @end itemize
 273
 274 @chapter New features in 1.6 since 1.4
 275
 276
 277 @itemize @bullet
 278
 279 @item
 280 Support for figured bass and tablature.
 281
 282 @item
 283 Completely rewritten beam formatting: provides much better output
 284 now.
 285
 286
 287 @item
 288 Completely revised and improved music font.
 289
 290
 291 @item
 292 Completely rewritten MIDI import support.
 293
 294 @item
 295 Completely rewritten grace note support. Practically speaking this
 296 means that grace notes can be slurred to normal normal notes.
 297
 298
 299 @item
 300 Improved accidental handling and formatting: styles for producing
 301 cautionaries may vary, and complex collisions between accidentals of a
 302 chord are handled much better.
 303
 304 @item
 305 Better spacing: both globally and locally. This includes subtle
 306 details like optical stem spacing.
 307
 308 @item
 309 More support for ancient notation: mensural ligatures, ambitus
 310 (pitch range) of voices, more shapes, etc.
 311
 312 @item
 313 More support for piano notation: bracket pedals, directed arpeggios,
 314 arpeggio brackets.
 315
 316 @item
 317 Easier music polyphonic music entry.
 318
 319 @item
 320 More extensibility, many speedups and bugfixes
 321
 322 @item
 323 The manual has been thoroughly revised.
 324
 325 @item
 326 Development is now hosted at http://savannah.gnu.org, and sources
 327 can be downloaded through anonymous CVS.
 328
 329 @item
 330 Support for windows: LilyPond is part of the cygwin distribution,
 331 which comes with a user-friendly installer.
 332
 333 @end itemize