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