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