]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/topdocs/NEWS.texi
43b797fa53e011daf6a48fa437123d1a0f4f7095
[lilypond.git] / Documentation / topdocs / NEWS.texi
1 \input texinfo @c -*-texinfo-*-
2 @setfilename NEWS.info
3 @settitle NEWS
4
5 @node Top, , , 
6 @top
7 @unnumbered New features in 2.4 since 2.2
8
9 @itemize @bullet
10 @item @code{\bookpaper} and @code{\paper} have been renamed to
11 @code{\paper} and @code{\layout} respectively, to better match their
12 function.
13
14 @item Parts that use @code{\quote} can now be transposed.
15
16 @item LilyPond does not try to produce output for files that
17 have a parse error.
18
19 @item @code{lilypond-book} will now remove any output  files that
20 contain failed music snippets.
21
22 @item The mode changing commands  (@code{\chords}, @code{\lyrics}, etc.)
23 have been renamed to @code{\chordmode}, @code{\lyricmode}, etc. The
24 command @code{\chords} is an abbreviation for
25
26 @example
27   \new ChordNames \chordmode ... 
28 @end example
29
30 @noindent
31 @code{\drums}, @code{\lyrics}, @code{\chords}, @code{\figures}
32 function similarly.
33
34 @item The types of events quoted with @code{\quote}  can  now be tuned
35 with @code{quotedEventTypes}. By default, only notes and rests end up
36 in quotes.
37
38 @item  LilyPond will try to keep
39 staves at the same distances across a page, but it will stretch
40 distances to prevent collisions. This results in a more even
41 appearance of the page.
42
43 @item Key signature cancellations are now printed before the bar line,
44 and their appearance has been improved.
45
46 @item Different voices that all use  @code{\quote} can now refer to
47 each other.
48
49
50 @item The automatic staff changer, which is invoked with
51 @code{\autochange}, now creates the @code{up} and @code{down} staff
52 automatically, and uses bass clef for the bottom staff.
53
54 @item There is now support for putting two slurs on chords, both above
55 and below. This is switched on with the @code{doubleSlurs} property.
56
57 @item Running trills now have their own spanner and event,
58
59 @example
60   c1\startTrillSpan c4\stopTrillSpan 
61 @end example
62
63 @item There is a new markup command @code{\postscript} that takes a
64 string that is dumped as verbatim PostScript in the output.
65
66 @item The melody  for a @code{\lyricsto} text can be changed during a
67 melody by setting the @code{associatedVoice} property.
68
69 @item The @code{\lyricsto} keyword now automatically switches on
70 lyrics mode.
71
72 @item The LilyPond binary  now supports output options
73 @code{--dvi} @code{--png} @code{--ps} @code{--pdf} and
74 @code{--preview}.  The old wrapper script for La@TeX{} has been
75 renamed to @code{lilypond-latex}.
76
77 @item Support for ambitus has been rewritten. The Ambitus object is now
78 a grouping object, composed of @code{AmbitusLine},
79 @code{AmbitusAccidental} and @code{AmbitusNoteHead}. These objects may
80 be tuned similar to accidentals and note heads.
81
82 @item Ledger lines are now shortened when the spacing is tight. This
83 prevents ledger lines from colliding with each other.
84
85 @item Slur formatting has been rewritten. The new slur code
86 works similar to the Beam formatter: scores are assigned for all
87 esthetic components of a slur. A large number of combinations for
88 begin and end points is then tried out.  Slurs will now also take into
89 account collisions with staff lines, scripts (like staccato and
90 accent) and accidentals.
91
92
93 @item In the LilyPond  emacs mode, entering @code{|} will  display the
94   current beat within the measure.
95
96 @item Colliding notes are now correctly aligned relative to notes in other staves.
97
98 @item An experimental GNOME output backend is available for developers.
99 It depends on several unreleased packages such as gnome-guile TLA and
100 Pango CVS.  The output interface coverage is sparse, but it already
101 does support point-and-click on the GNOME Canvas.  See also
102 @file{scm/output-gnome.scm}.
103
104 @item Context definitions are now stored in identifiers that match the
105 context name, in other words, to modify a @code{Staff} context, the
106 following code may be used.
107
108 @example
109 \context @{
110   \Staff
111   .. 
112 @}
113 @end example
114
115 @item A new block, @code{\bookpaper} has been introduced to
116 hold settings for paper size and output scaling. Further options
117 include @code{raggedbottom} (if set, systems are not vertically filled
118 to reach the bottom of the page), and @code{raggedlastbottom}.
119
120
121
122 @item Support for fret diagrams  has been contributed by Carl
123 D. Sorensen. @file{input/test/fret-diagram.ly} contains an example.
124  
125 @item The @code{--safe-mode} has been revisited: GUILE evaluation
126 is done in the R5RS safe module, with only the basic @code{ly:}
127 interface available and malicious @TeX{} code is stopped.  However, to
128 be reasonably safe, you are advised to use the PostScript backend
129 rather than the @TeX{} backend anyway; and if possible use an UML
130 sandbox to run gs or latex.
131
132 @item Music syntax can now be extended seamlessly. As an example,
133 here is the new implementation @code{\applymusic},
134
135 @example
136   applymusic = #(ly:make-music-function
137      (list procedure? ly:music?) ; signature
138      (lambda (where func music)  ; the function
139        (func music)))
140 @end example
141
142 @item @code{\apply} has been renamed to @code{\applymusic}.
143
144 @item Music can be used as a markup.
145 When inserting a @code{score} block as part of a @code{\markup}, it
146 produces a rendered markup of the music.  An example is in
147 @file{input/test/markup-score.ly}.
148
149 @item LilyPond expressions can be embedded into Scheme. The syntax for
150 this is @code{#@{ ... #@}}. Within such a block, Scheme forms can be
151 introduced using a @code{$} character (@code{$$} results in a single
152 `$' character).  These forms are then inserted in the pattern.
153
154 @example
155 #(define (textoffset dx dy)
156    (ly:export
157      #@{ \override Voice.TextScript #'extra-offset = #(cons $dx $dy) #@}))
158
159 @{
160   c'^"normal text"
161   %% The following embedded scheme call is the same as
162   %% \override Voice.TextScript #'extra-offset = #(cons 2 -3)
163   #(textoffset 2 -3)
164   c'^"text with offset" 
165 @}
166 @end example
167
168 @item A music list at toplevel is interpreted as implicit @code{\score}
169 a @code{\score} block at toplevel is interpreted as an implicit
170 @code{\book} and @code{\notes} mode is the default lexer mode.  The
171 result is that
172
173 @example
174 \header @{ title = "The Title" @}
175 @{ a b c @}
176 @end example
177
178 is interpreted as
179
180 @example
181 \header @{ title = "The Title" @}
182 \book @{
183   \score @{
184     \notes @{ a b c @}
185   @}
186 @}    
187 @end example
188
189 This is handled by the function defined in
190 @code{toplevel-music-handler}.  Similarly, @code{\score} and
191 @code{\book} are handled by @code{toplevel-score-handler} and a
192 @code{toplevel-book-handler}.  By changing these variables, different
193 results can be obtained.
194
195 @item Mode changing commands,
196 such as @code{\chords} and @code{\figures} must now be directly
197 followed by delimiters. The following example demonstrates the new
198 behavior,
199
200 @verbatim
201   \figures \context Figures { .. } % wrong
202   \context Figures \figures { .. } % right
203 @end verbatim 
204
205
206 @item The starting pitch for @code{relative} music is optional for music lists.
207 The default value is middle C.
208
209 @c update-me?  formal definition of newaddlyrics, once it works
210 @item Combining lyrics with music can be done with @code{\addlyrics}
211
212 @example
213     \relative @{
214         \clef bass
215         d2 d c4 bes a2 \break
216     @}
217     \newlyrics @{
218         My first Li -- ly song,
219     @}
220     \newlyrics @{
221         Not much can go wrong!
222     @}
223 @end example
224
225 Syntactically, @code{\addlyrics} acts like an infix operator.  
226
227 @item The parser is encapsulated in a Scheme function
228 @code{ly:parse-file}, so the following fragment processes two files
229
230 @verbatim
231 #(ly:parse-file "another.ly")
232 \score { \notes { c4 }}
233 @end verbatim
234
235 @item The @code{font-encoding} property can now be used to select
236 differently encoded fonts. The previous default setting
237 @code{TeX-text} has been replaced by latin1. LilyPond requires the
238 @uref{http://www.lilypond.org/download/fonts/,ec-fonts-mftraced}
239 package installed to function properly.
240
241 @item The encoding of a file can be switched with
242 @code{\encoding}. The strings for markup texts are translated
243 automatically.
244
245 @item The toplevel block @code{\book} introduces page layout.
246 A @code{\book} groups @code{\score} blocks into one page layout
247 entity. For example, two scores are combined in one book with   
248
249 @example
250 \book @{
251      \score @{ ... @}
252      \score @{ ... @}
253 @}
254 @end example
255
256
257 @item
258 Titling and page breaks are handled by LilyPond.  Page breaks may be
259 inserted manually with
260 @example
261   \pageBreak
262 @end example
263
264 @item
265 The @code{lilypond} program does not generate La@TeX{} titles or page
266 layout.  If you need La@TeX{} titles, you can use the
267 @code{lilypond-book} program.
268
269 @item There is now less of a noticeable ``hook'' at the end of a long slur.
270
271 @item The meaning of the @code{|} in the input can be redefined, by
272  assigning a music expression to @code{pipeSymbol}.
273  
274 @end itemize
275
276 @unnumbered New features in 2.2 since 2.0
277
278 @itemize @bullet
279
280 @item Setting @code{raggedlast = ##t} in the @code{\paper} block
281 causes the last line to be set flush-left instead of justified. 
282
283 @item The @code{Timing_engraver} now sets the @code{Timing} alias on
284 its containing context automatically.
285
286 @item The code for font selection has been rewritten. In addition to
287 existing font selection properties, the property @code{font-encoding}
288 has been added, which makes the switch between normal @code{text} and
289 other encodings like @code{braces}, @code{music} and @code{math}.
290
291 @item The pmx2ly script has been removed from the distribution.
292
293 @item Pedal brackets will now run to the last bar of a piece if they are not
294 explicitly ended.
295
296 @item Context definitions now use the word @code{\context} instead of @code{\translator}.
297
298 @item Property functions may be used as an argument to @code{set!},
299 for example
300
301 @example
302   (set! (ly:grob-property grob 'beam) ... )
303 @end example
304
305 @item In anticipation of Emacs 21.4 or 22.1, the info documentation contains
306 images.
307
308 @item Cue notes can be quoted directly from the parts that
309 contain them. This will take into account transposition of source and target
310 instrument. For example,
311
312 @verbatim
313 \addquote clarinet \notes\relative c' {
314   \transposition bes
315   fis4 fis fis fis
316 }
317
318 \score {
319     \notes \relative c'' {
320         c8 d8 \quote 2 oboe es8 gis  
321     }
322 }
323 @end verbatim
324
325 @item The transposition of an instrument can be specified using the
326 @code{\transposition} command.  An
327 E-flat alto saxophone is specified as 
328
329 @example
330   \transposition es'
331 @end example 
332
333 @item The naming of exported Scheme functions now follows Scheme conventions.
334 Changes be applied to Scheme files with 
335
336 @example
337         convert-ly -e -n --from=2.1.24 --to=2.1.26 *.scm 
338 @end example
339
340
341 @item Notes can  be excluded from auto-beaming, by  marking them with
342 @code{\noBeam}
343 @example
344   c8 c \noBeam c c 
345 @end example
346
347 @noindent
348 will print two separate eighth notes, and two beamed notes.
349
350 @item  Translators and contexts have been split. The result of this
351 internal cleanup is that @code{Score} no longer is the top context;
352 @code{Score} is contained in the @code{Global} context. Consequently,
353 it is possible to tweak @code{Score} as follows:
354
355 @example
356   \context Score \with @{
357     @dots{}
358   @}
359 @end example
360
361 @item The number of staff lines  in Tablature notation is now
362 automatically deduced from the @code{stringTunings} property.
363
364 @item The program reference has been cleaned up and revised.
365
366 @item The syntax for setting properties has been simplified:
367 the following table lists the differences:
368
369 @example
370       (old)                           (new)
371
372 \property A.B = #C                \set A.B = #C
373 \property A.B \unset              \unset A.B
374 \property A.B \set #C = #D        \override A.B #C = #D 
375 \property A.B \override #C = #D   (removed)
376 \property A.B \revert #C          \revert A.B #C
377 @end example
378
379 Furthermore, if @code{A} is left out, the bottommost context is used
380 by default.  In other words, it is no longer necessary to explicitly
381 mention @code{Voice}, @code{Lyrics} or @code{ChordNames}. 
382
383 Old:
384
385 @example
386    \property Voice.autoBeaming = ##f
387    \property Staff.TimeSignature \set #'style = #'C
388 @end example
389
390 New:
391
392 @example
393    \set autoBeaming = ##f
394    \override Staff.TimeSignature #'style = #'C
395 @end example
396
397
398 @item Tweaks  made with @code{\override} and @code{\revert} no longer
399 hide tweaks at higher context levels.
400
401 @item Melismata in lyrics are also properly handled  in the MIDI output.
402
403 @item The lilypond-book script has been rewritten.
404 It is shorter, cleaner and faster.  The special construct
405 @code{mbinclude} has been removed, plain @code{@@include} or
406 @code{\input} can be used now.
407
408 It now supports running convert-ly on the lilypond snippets,
409 @example
410     lilypond-book --filter='convert-ly --from=2.0.0' my-book.tely
411 @end example
412
413 @item The @code{LyricsVoice} context has been removed. Lyrics should only
414 be constructed in @code{Lyrics}.
415
416 @item The @code{Thread} context has been removed. Note heads and rests
417 are now constructed at @code{Voice} level.
418
419 @item  Harmonic notes can now be entered as
420
421 @example
422    <c' g''\harmonic>
423 @end example
424
425 @item Drum notation is now supported  as a regular feature:
426 percussion may be entered in @code{\drums} mode, and printed or
427 performed in a @code{DrumStaff} context:
428
429 @example
430   \score @{
431     \drums \new DrumStaff @{ hihat4 cowbell8 @}
432   @}
433 @end example
434
435 @item The automatic staff changer was internally rewritten. As a
436 result, the syntax has been simplified as well:
437
438 @example
439   \autochange @var{the-music}
440 @end example
441
442 @item The ergonomic syntax of @code{\markup} now has an equivalent in
443 Scheme. The @code{markup*} macro creates such objects; the following
444 two markup commands are equivalent:
445 @example
446  f4^#(markup* #:raise 0.2 #:bold "hi")
447  f4^\markup @{ \raise #0.2 \bold hi  @}
448 @end example
449
450 @item Voice names, for vocal lines, have been added. They are similar
451 to instrument names.   They can be set by defining @code{vocalName}
452 and @code{vocNam}.
453
454 @item Safe mode has been reinstated for lilypond.
455 When lilypond is invoked with @code{--safe-mode}, @TeX{} and
456 PostScript file output is disallowed, and lilypond-bin is invoked with
457 @code{--safe-mode}, the user's Guile expressions are evaluated in a
458 safe environment and file inclusion is not allowed.
459
460 Warning: this does not protect against denial-of-service attacks using
461 Guile, @TeX{} or PostScript.
462
463 (This feature is still experimental.)
464
465 @item There is now a Scheme macro for defining markup
466 commands. Special mark-up commands can be defined in user-files too.
467
468 @item Many fixes for dimension scaling have been made,
469 resulting in correct results for scores that mix staves in different
470 sizes.
471
472 @item Improved robustness when  layout properties are accidentally removed.  
473
474 @item A  more cleanly constructed part combiner has been installed.
475 It is more robust and less buggy. The part-combiner can be used with
476 @example
477   \partcombine @var{mus1} @var{mus2}
478 @end example
479
480 @noindent
481 See @file{input/regression/new-part-combine.ly} for an example.
482
483 @item Formatting of rehearsal marks has been improved. The @code{\mark}
484 command now only does automatic incrementing for marks specified as
485 integer. For example, @code{\mark #1} will print an A in the default
486 style.  See @file{input/regression/rehearsal-mark-letter.ly},
487 @file{input/regression/rehearsal-mark-number.ly}.
488
489 @item Formatting of ottava brackets has been much improved.
490
491 @item Objects in the output can now be documented: the following fragment
492  boxes the note head, and adds the text ``heads or tails?'' three
493 spaces below the box.
494
495 @example
496        \context Voice \applyoutput #(add-balloon-text
497                                      'NoteHead "heads, or tails?"
498                                      '(0 . -3))
499
500       
501        c8
502 @end example
503
504
505 @item Default staff sizes are now scalable. There are two new mechanisms for
506 setting staff sizes. Both are demonstrated in this fragment:
507
508 @example
509   #(set-global-staff-size 15)
510   \paper @{
511     #(paper-set-staff-size (* 15 pt))
512   @}   
513 @end example
514
515
516 @noindent
517 Both have the same effect on the global layout of a piece. Similarly,
518 the paper size may be changed as follows
519
520 @example
521   #(set-default-paper-size "a4")
522   \paper @{
523     #(set-paper-size "a4")
524   @}
525 @end example 
526
527
528 @item Warnings for bar check errors are more cleverly printed.  This
529 makes @code{barCheckSynchronize} superfluous, so it is now switched
530 off by default.
531
532 Warning: this will cause problems in scores that use bar checks to
533 shorten measures.
534
535 @item The black note head was made a little rounder, which causes a less
536  frantic graphic impression.
537
538 @item
539 A more concise syntax for checking octaves was introduced. A note may
540 be followed by @code{=}@var{quotes} which indicates what its absolute
541 octave should be.  In the following example, 
542
543 @example
544   \relative c'' @{ c='' b=' d,='' @}        
545 @end example
546
547 @noindent
548 the d will generate a warning, because a d'' is
549 expected, but a d' is found.
550 @c @code adds ` ', very confusing.
551
552 @item There is a new mechanism for putting lyrics to melodies.
553 With this mechanism, @code{Lyrics} lines can be put melodies
554 individually, allowing for different melismatic sections in every
555 @code{Lyrics}. See @file{input/regression/lyric-combine-new.ly}.
556
557 @item Bar lines may now be dotted.
558
559
560 @item The documentation now has links to a wiki, where everyone can
561 add personal comments to the manual.
562
563 @item Contexts may now be changed locally for an isolated music
564 expression. For example,
565   
566 @example
567   \new Voice \with @{
568      \consists "Pitch_squash_engraver"
569   @} @{
570     c'4
571   @}
572 @end example
573
574 @item The syntax for changing staffs has changed. The keyword
575 @code{\change} should now be used, e.g.
576
577 @example
578   \change Staff = up
579 @end example 
580
581 @item Features of spanner contexts, like @code{Staff}, can now be changed
582   using @code{\set}, eg.
583
584 @example
585   \new Staff @{
586        \override Staff.StaffSymbol #'line-count = #4
587        c'4
588   @} 
589 @end example
590
591 @noindent
592 puts a quarter note C on a staff with 4 lines.  
593
594
595 @item Multi measure rests are now truly centered between the
596 clefs/barlines of the staff, their position is independent of symbols
597 on the other staffs.
598
599 @item Collision resolution for dots in chords has been improved greatly. 
600
601 @item
602 Spacing following barlines was improved for widely stretched lines.
603
604 @item
605 Lyric hyphens and extenders now conform to standard typesetting
606 practice.
607
608 @item
609 Lyrics are now aligned under note heads conforming to engraving
610 standards. The responsible code has been rewritten, and is drastically
611 simpler from the previous version. To aid this rewrite, the syntactic
612 function of the extender line ( __ ) has been changed: it is now
613 attached to the lyric syllable.
614
615 @item
616 When redefining a context, the associated identifier is also
617 updated. For example, after reading 
618
619 @example
620  \translator @{
621         \ScoreContext
622         autoBeaming = ##f
623  @}
624 @end example
625
626 @noindent
627 the definition of @code{ScoreContext} is updated to include the changed
628 setting.
629
630
631 @item
632 The weight of the stafflines is now heavier at smaller staff sizes.
633 The font has been modified to match this look: at smaller sizes, the
634 font is heavier and the note heads are more rounded.
635
636 @item Processing scores is now done while parsing the file. New
637 Scheme functions give more flexibility: for example, it is now possible
638 interpret a score, collecting synchronized musical events in a list, and
639 manipulate that information using inline Scheme. For an example, see
640 @file{input/no-notation/recording.ly}.
641
642 @item Font sizes can now truly be scaled continuously: the  @code{font-size}
643 is similar to the old @code{font-relative-size}, but may be set to
644 fractional values; the closest design size will be scaled to achieve
645 the desired size. As a side-effect, there are now no longer
646 limitations in using smaller fonts (eg. grace notes) at small staff
647 sizes.
648
649 @item Stem tips are now also engraved with rounded corners.
650
651 @item
652 The placement of accidentals on chords and ledgered notes is improved.
653
654 @end itemize
655
656
657 @unnumbered New features in 2.0 since 1.8
658
659 @itemize
660
661 @item
662 Crescendos can now be drawn dotted or dashed.
663
664 @item
665 Quarter tones are now supported. They are entered by suffixing
666 @code{ih} for a half-sharp and @code{eh} for a half-flat. Hence, the
667 following is an ascending list of pitches:
668
669 @example
670   ceses ceseh ces ceh c cih cis cisih cisis
671 @end example
672
673 @item
674 The following constructs have been removed from the syntax:
675
676 @example
677   \duration #SCHEME-DURATION
678   \pitch #SCHEME-PITCH
679   \outputproperty @var{func} @var{symbol} = @var{value}
680 @end example
681
682 For @code{\outputproperty}, the following may be substituted:
683
684 @example
685    \applyoutput #(outputproperty-compatibility @var{func}
686                   @var{symbol} @var{value}) 
687 @end example 
688
689 @item
690 Clefs may now be transposed arbitrarily, for example
691
692 @example
693   \clef "G_8"
694   \clef "G_15"
695   \clef "G_9"
696 @end example
697
698
699 @item
700 The syntax for chords and simultaneous music have changed.
701 Chords are entered as
702
703 @example
704    <@var{pitches}>
705 @end example
706
707 while simultaneous music is entered as
708
709 @example
710    <<@var{..music list..}>>
711 @end example
712
713 In effect, the meanings of both have been swapped relative to their 1.8
714 definition.  The syntax for lists in @code{\markup} has changed
715 alongside, but figured bass mode was not  changed, i.e.:
716
717 @example
718   \markup @{ \center <@var{..list of markups..}> @}
719   \figure @{ <@var{figures}> @}
720 @end example
721
722 As chords the more often used than simultaneous music, this change will
723 save keystrokes.
724
725 @item
726 Each music expression can now be tagged, to make different printed
727 versions from the same music expression.  In the following example,
728 we see two versions of a piece of music, one for the full score, and
729 one with cue notes for the instrumental part:
730
731 @example
732 << \tag #'part <<
733      @{ c4 f2 g4 @}      % in the part, we have cue-notes  
734      \\ R1 >>
735   \tag #'score R1  % in the score: only a rest
736 >>
737 @end example
738  
739 The same can be applied to articulations, texts, etc.: they are
740 made by prepending
741
742 @example
743         -\tag #@var{your-tags} 
744 @end example
745
746 to an articulation, for example, 
747
748 @example
749         c4-\tag #'with-fingerings -4 -\tag #'with-strings \6
750 @end example
751
752 This defines a note, which has a conditional fingering and a
753 string-number indication.
754
755 @item
756 The settings for chord-fingering are more flexible. You can specify a
757 list where fingerings may be placed, eg.
758
759 @example
760         \property Voice.fingeringOrientations = #'(left down)
761 @end example
762
763 This will put the fingering for the lowest note below the chord, and the
764 rest to the left.
765
766 @item
767 The script previously known as @code{ly2dvi} has been renamed to
768 @code{lilypond}. The binary itself is now installed as
769 @code{lilypond-bin}.
770
771 @item
772 Markup text (ie. general text formatting) may now be used for lyrics too. 
773
774 @item
775 Two new commands for grace notes have been added, @code{\acciaccatura}
776 and @code{\appoggiatura},
777
778 @example
779   \appoggiatura f8 e4
780   \acciaccatura g8 f4
781 @end example
782
783 Both reflect the traditional meanings of acciaccatura and appogiatura,
784 and both insert insert a slur from the first grace note to the main
785 note.
786
787 @item 
788 Layout options for grace notes are now stored in a context property,
789 and may now be set separately from musical content.
790
791 @item
792 The @code{\new} command will create a context with a unique
793 name automatically. Hence, for multi-staff scores, it is no longer
794 necessary to invent arbitrary context names. For example, a two-staff
795 score may be created by
796
797 @example
798   \simultaneous @{
799     \new Staff @{ @var{notes for 1st staff} @}
800     \new Staff @{ @var{notes for 2nd staff} @}
801   @}
802 @end example
803
804
805
806 @item
807 Octave checks make octave errors easier to correct.
808 The syntax is 
809
810 @example
811   \octave @var{pitch}
812 @end example
813
814 This checks that @var{pitch} (without octave) yields @var{pitch} (with
815 octave) in \relative mode. If not, a warning is printed, and the
816 octave is corrected.
817
818 @item
819 All articulations must now be entered postfix. For example,
820
821 @example
822         c8[( d8]) 
823 @end example
824
825 @noindent
826 is a pair of beamed slurred eighth notes.
827
828 @item
829 The definition of @code{\relative} has been simplified.  Octaves are
830 now always propagated in the order that music is entered. In the
831 following example,  
832
833 @example
834   PRE
835   \repeat "unfold" 3  BODY \alternative @{ ALT1 ALT2 @}
836   POST
837 @end example
838
839 @noindent
840 the octave of BODY is based on PRE, the starting octave of ALT1 on
841 BODY, the starting octave of ALT2 on ALT1, and the starting octave of
842 POST on ALT2.
843
844 The same mechanism is used for all other music expressions, except the
845 chord. Backwards compatibility is retained through a special program option,
846 which is set through 
847
848 @example
849   #(ly:set-option 'old-relative)
850 @end example
851
852 @item
853 Windows users can double click a @code{.ly} file to process and view
854 it automagically through the new @code{lily-wins} frontend.
855
856 @end itemize
857
858
859
860
861 @unnumbered New features in 1.8 since 1.6
862
863 @itemize
864
865 @item 
866 The chord entry code has been completely rewritten. It is now
867 cleaner and more flexible.
868
869 @item 
870 A new syntax has been added for text entry.  This syntax is more
871 friendly than the old mechanism, and it is implemented in a more
872 robust and modular way. For more information, refer to the section on
873 "Text markup" in the notation manual.
874
875 @item 
876 The integration of the input language and Scheme has been made deeper:
877 you can now use LilyPond identifiers in Scheme, and use Scheme
878 expressions instead of LilyPond identifiers.
879
880 @item 
881 The internal representation of music has been cleaned up completely
882 and converted to Scheme data structures.  The representation may be
883 exported as XML.
884
885 @item 
886 A new uniform postfix syntax for articulation has been introduced.
887 A beamed slurred pair of eighth notes can be entered as
888
889 @example
890         c8-[-( d8-]-) 
891 @end example
892
893 In version 2.0, postfix syntax will be the only syntax
894 available, and the dashes will become optional.
895
896 This will simplify the language: all articulations can be entered as
897 postfix, in any order.
898
899 @item 
900 A new syntax has been added for chords:
901
902
903 @example
904         << PITCHES >>
905 @end example 
906
907 It is not necessary to update files to this syntax, but it will be for
908 using LilyPond version 2.0.  In version 2.0, this syntax will be
909 changed to
910
911 @example
912         < PITCHES >
913 @end example
914
915 for chords, and
916
917 @example
918         \simultaneous @{ .. @} 
919 @end example
920
921 for simultaneous music.
922
923 To convert your files from <PITCHES> to <<PITCHES>>, use the script
924 included in @file{buildscripts/convert-new-chords.py}.
925
926 This change was introduced for the following reasons
927
928 @itemize @bullet
929 @item
930 It solves the "start score with chord" problem, where you have to
931   state \context Voice explicitly when a chord was the start of a
932   Staff or Score.
933 @item
934 With the new syntax, it is possible to distinguish between
935   articulations (or fingerings) which are for a single chord note,
936   and which are for the entire chord. This allows for per-note
937   fingerings, and is more logical on the whole.
938 @end itemize
939
940 @item 
941 User code may now be executed during interpreting.  The syntax for
942 this code is
943
944 @example
945         \applycontext #SCHEME-FUNCTION
946 @end example
947
948 @item 
949 User code may now be executed on arbitrary grobs during interpreting.
950 The syntax for this feature is
951
952 @example
953         \applyoutput #SCHEME-FUNCTION
954 @end example
955
956 @noindent
957 SCHEME-FUNCTION takes a single argument, and is called for every grob
958 that is created in the current context.
959
960 @item 
961 New algorithms for chord-name formatting have been installed. They
962 can be tuned and have ergonomic syntax for entering exceptions.
963
964 @item 
965 Texts may now be put on multimeasure rests, e.g.
966
967 @example
968         R1*20^\markup @{ "GP" @}
969 @end example
970
971 @item
972 Ancient notation now prints ligatures in Gregorian square neumes
973 notation, roughly following the typographical style of the Liber
974 hymnarius of Solesmes, published in 1983.  Ligatures are still printed
975 without the proper line breaking and horizontal spacing.
976
977 @item 
978 Glissandi can now be printed using the zigzag style.
979
980 @item 
981 LilyPond can now print clusters. The syntax is
982
983 @example
984         \apply #notes-to-clusters @{ NOTE NOTE .. @}
985 @end example
986
987 @item
988 For irregular meters, beat grouping marks can be printed. The
989 syntax for this is
990
991 @example
992         #(set-time-signature 7 8 '(3 2 2))
993 @end example
994
995
996 @item 
997 Nested horizontal brackets for music analysis can now be printed:
998
999 @example
1000         NOTE-\startGroup
1001                 ..
1002         NOTE-\stopGroup
1003 @end example
1004
1005
1006 @item  Ottava brackets are now fully supported as a feature.  The syntax
1007 is
1008
1009 @example
1010         #(set-octavation 1)
1011 @end example
1012
1013
1014 @item  Metronome markings are printed when a \tempo command is processed.
1015
1016
1017
1018 @item Fingerings can be put on chords horizontally.
1019
1020
1021
1022 @item  The appearance of various glyphs has been fine-tuned.
1023
1024
1025
1026 @item  Different types of percent style repeats may now be nested.
1027
1028
1029
1030 @item  The emacs support has been extended.
1031
1032
1033 @item 
1034 The manual has been completely revised and extended.
1035
1036 @end itemize
1037
1038 @unnumbered New features in 1.6 since 1.4
1039
1040
1041 @itemize @bullet
1042
1043 @item
1044 Support for figured bass and tablature.
1045
1046 @item
1047 Completely rewritten beam formatting: provides much better output
1048 now.
1049
1050
1051 @item
1052 Completely revised and improved music font.
1053
1054
1055 @item
1056 Completely rewritten MIDI import support.
1057
1058 @item
1059 Completely rewritten grace note support. Practically speaking this
1060 means that grace notes can be slurred to normal normal notes.
1061
1062
1063 @item
1064 Improved accidental handling and formatting: styles for producing
1065 cautionaries may vary, and complex collisions between accidentals of a
1066 chord are handled much better.
1067
1068 @item
1069 Better spacing: both globally and locally. This includes subtle
1070 details like optical stem spacing.
1071
1072 @item
1073 More support for ancient notation: mensural ligatures, ambitus
1074 (pitch range) of voices, more shapes, etc.
1075
1076 @item
1077 More support for piano notation: bracket pedals, directed arpeggios,
1078 arpeggio brackets.
1079
1080 @item
1081 Easier music polyphonic music entry.
1082
1083 @item
1084 More extensibility, many speedups and bugfixes
1085
1086 @item
1087 The manual has been thoroughly revised.
1088
1089 @item
1090 Development is now hosted at http://savannah.gnu.org, and sources
1091 can be downloaded through anonymous CVS.
1092
1093 @item
1094 Support for windows: LilyPond is part of the cygwin distribution,
1095 which comes with a user-friendly installer.
1096
1097 @end itemize