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