]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/topdocs/NEWS.tely
This commit was manufactured by cvs2svn to create tag 'lilypond_2_5_32'.
[lilypond.git] / Documentation / topdocs / NEWS.tely
1 \input texinfo @c -*-texinfo-*-
2 @setfilename NEWS.info
3 @settitle NEWS
4
5 @ifhtml
6 @macro inputfileref{DIR,NAME}
7 @uref{../../../\DIR\/out-www/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c
8 @end macro
9 @macro usermanref{NAME}
10 @inforef{\NAME\,,../../user/out-www/lilypond/lilypond}@c
11 @end macro
12 @end ifhtml
13
14 @ifnothtml
15 @macro inputfileref{DIR,NAME}
16 @file{\DIR\/\NAME\}@c
17 @end macro
18 @macro usermanref{NAME}
19 See user manual, \NAME\
20 @end macro
21 @end ifnothtml
22
23
24 @documentencoding utf-8
25 @documentlanguage en
26
27 @ifnottex
28 @node Top
29 @top
30 @end ifnottex
31 @unnumbered New features in 2.5 since 2.4
32
33
34 @itemize @bullet
35
36 @item
37 Global font styles (roman, sans, typewriter) can be defined for each
38 @code{\paper} block, with
39
40 @verbatim
41 #(define fonts
42   (make-pango-font-tree
43    "Times New Roman" "Helvetica" "Courier"
44    (/ myStaffSize 20)))
45 @end verbatim
46
47
48 @item
49 Newly created staves and lyric lines, can be put in any vertical order,
50 by setting @code{alignBelowContext} or @code{alignAboveContext}
51 properties in the newly created context. An example of the use of this
52 is in @inputfileref{input/regression,alignment-order.ly}.
53
54 This feature has been sponsored by Bertalan Fodor. 
55
56
57 @item
58 Staves may be stopped and started halfway a line, e.g.
59
60 @lilypond[relative=2,fragment,verbatim]
61 b4 b \stopStaff b \startStaff b
62 @end lilypond
63
64 @noindent
65 This feature has been sponsored by Hans Forbrich.
66
67 @item
68 Grid lines, vertical lines synchronized with notes, can be drawn across
69 staves, by adding suitable engravers.
70 An example is in @inputfileref{input/regression,grid-lines.ly},
71
72 @lilypondfile[]{grid-lines.ly}
73
74 @item
75 Lines, such as glissandi or Text-spanner lines, can have arrows at the
76 end, e.g.
77
78 @lilypond[verbatim,fragment]
79 \override Glissando #'arrow = ##t
80 b''2 \glissando b'
81 @end lilypond
82
83 @item
84 Chord names may now be rendered in Italian and French.
85
86 @item
87 @file{lilypond-book} now makes @file{lilypond} print line numbers
88 relative to the input file for every error message.
89
90 @item
91 The command @code{\epsfile} allows inclusion of EPS graphics into
92 markup texts.
93
94 @item
95 There is a music function @code{\displayMusic}, which will display a
96 music expression as indented Scheme code.
97
98 @item
99 Automatic beaming is now specified explicitly for each moment
100 throughout a measure, which enables automatic beaming in compound
101 measures, as demonstrated in the following item.
102
103 @item
104 A plus sign was added to the number font.  This enables printing of
105 compound time signatures
106
107 @lilypondfile[]{compound-time.ly}
108
109 @item
110 A new @code{\circle} markup command allows for all kinds of circled
111 texts
112
113 @lilypondfile[]{circle.ly}
114
115 @item
116 String numbers are now printed on chords as well
117
118 @lilypond[relative,relative=1,raggedright,fragment,verbatim]
119 <c\1 e\2 g\3>
120 @end lilypond
121
122 See also @inputfileref{input/regression,string-number.ly}.
123
124 This feature was sponsored by Gunther Strube.
125
126 @item
127 Notes with ledger lines will be kept at a distance, so they never
128 disappear.
129
130 @item
131 Clefs that are below notes of other staves are now spaced according to
132 engraving conventions.
133  
134 @item
135 Markup texts can be appended to a @code{\score} block or toplevel
136 music expression, for example,
137
138 @example
139 \relative @{ c' d e @}
140 \markup @{ first text @}
141 \markup @{ second text @}
142 @end example
143 @c FIXME, cannot use toplevel music examples in lilypond-book,
144 @c but it works at toplevel too, as shown.
145 @lilypond[quote,raggedright]
146 \paper {
147    vsize = 60\mm
148    hsize = 60\mm
149    %% FIXME?
150    printpagenumber = ##f
151 }
152 \header {
153    tagline = ""
154 }
155 \book {
156   \score {
157     \relative { c' d e }
158   }
159   \markup { first text }
160   \markup { second text }
161 }
162 @end lilypond
163
164
165 See @inputfileref{input/regression,score-text.ly}.
166
167
168 @item
169 @TeX{}'s @code{kpathsea} library is loaded dynamically, so installing
170 LilyPond does not require installing @TeX{} anymore.
171
172 @item
173 Point and click editing is now supported in the PS/PDF backend as
174 well.
175 See
176 @ifhtml
177 @uref{../../user/out-www/lilypond/Point-and-click.html,Point and click}.
178 @end ifhtml
179 @ifnothtml
180 the section Point and click in he user manual. 
181 @end ifnothtml
182
183 @item
184 White mensural ligatures now conform more closely to Renaissance
185 usage.
186
187
188 @item
189 With the new @code{tieWaitForNote} property, arpeggios may be written
190 out using ties, for example,
191
192 @lilypond[fragment,verbatim,relative=1,raggedright]
193 \set tieWaitForNote = ##t
194 \grace { c16[~ e~ g]~ } <c, e g>4   
195 @end lilypond
196
197 Thanks to Steve Doonan for funding development of this feature.
198
199 @item
200 Individual objects may be assigned colors, for example,
201
202 @lilypond[fragment,relative=1,verbatim,raggedright] 
203         \override NoteHead #'color = #red
204         c4
205 @end lilypond 
206
207 @item
208 The PostScript backend is now used by default.  This backend requires
209 less machinery to run, and gives more consistent results.
210
211 Ghostscript 8.x is required for PDF output.  Earlier versions may hang
212 while converting PostScript to PDF. 
213
214 @item
215 Separator slashes may be inserted between systems in a score. For an
216 example, see @inputfileref{input/regression,system-separator.ly}:
217
218 @item
219 Locations of errors in the input are now calculated more precisely.
220
221
222
223 @item
224 LilyPond now uses Pango and FontConfig for selecting and rendering
225 UTF-8 input in non-@TeX{} backends. A font may be selected by using a
226 FontConfig name,
227
228 @example
229 \override TextScript #'font-name = #"Serif"
230 @end example
231
232
233 @noindent
234 or using the classic font selection mechanism
235
236 @example
237 \override TextScript #'font-family = #'roman
238 \override TextScript #'font-series = #'bold
239 @end example
240
241 Any Type1 and TrueType font recognized by FontConfig is available in
242 LilyPond as well.
243
244 @item
245 Metrics of blocks of text can be retrieved from (La)@TeX{} directly,
246 using the @code{-f texstr} output backend. This provides exact metrics
247 for texts, including kerning and accents.
248
249 @item
250 LilyPond now uses FreeType to read the Feta font as an OpenType
251 font. This is a cleaner design and more robust.  Recent versions of
252 FontForge (2004 1211 or newer) and Freetype are required.  
253
254 @item
255 The SVG backend is now a fully functional backend.
256
257 @item
258 A new script, @code{\espressivo} has been added, for a combination of
259 crescendo and decrescendo on a single note.
260
261 @item
262 In markups, expressions stacked with @code{\column},
263 @code{\center-align}, etc, are not grouped with @code{< ... >} anymore,
264 but with @code{@{ ... @}}, eg:
265 @example
266 \markup \column @{
267   \line @{ first line @}
268   \line @{ second line @}
269 @}
270 @end example
271
272 @item
273 LilyPond will now avoid line breaks that cause long texts to stick
274 outside of the page staff.
275
276 @item
277 Grace notes following a main note, used to be entered by letting the
278 grace notes follow a skip in a parallel expression, for example,
279
280 @verbatim
281   << { d1 }
282      { s2 \grace { c16[ d] } } >>
283   c4
284 @end verbatim
285
286 @noindent
287 This can now be shortened by doing
288
289 @example
290 \afterGrace @{ d1 @} @{ c16[ d] @} 
291 @end example 
292
293 @item
294 Pagebreaks can now be forced or forbidden after title blocks. This is
295 achieved by setting @code{breakbefore} in the @code{\header} block to
296 true or false.
297
298 @item
299 Shaped note heads. This feature has been sponsored by Jonathan Walther,
300
301 @lilypond[relative=1,fragment,verbatim,raggedright]
302   \set shapeNoteStyles = ##(do re mi fa #f la ti)
303   c d e f g a b c d e f g a b c
304 @end lilypond
305
306 @item
307 Layout for titles, page header and footer can now be entered as
308 @code{\markup} commands.
309
310 @item Positioning of slurs can now be adjusted manually
311
312 @item Grace notes are correctly quoted and formatted when using cue notes.
313
314 @item Cue notes can now be created with
315
316 @example
317 \cueDuring #@var{voice-name} #@var{direction} @{ @var{music} @}
318 @end example
319
320 @noindent
321 This will set stem directions and put the cue notes in the @code{cue}
322 @code{Voice}.
323
324 @item Stemlets, short stems over beamed rests, have been added.
325
326 @lilypond[relative=1,verbatim,fragment,raggedright]
327 \override Stem #'stemlet-length = #0.75
328 c8[ r8 c16 r16 c8]
329 @end lilypond
330
331 @end itemize
332
333 @ifhtml
334 For older news, go to
335 @uref{http://lilypond.org/doc/v2.4/Documentation/topdocs/out-www/NEWS.html}.
336 @end ifhtml
337
338 @bye