]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/topdocs/NEWS.tely
\label and \page-ref documentation and news item.
[lilypond.git] / Documentation / topdocs / NEWS.tely
1 \input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
2 @setfilename NEWS.info
3 @settitle NEWS
4
5 @ifhtml
6 @macro inputfileref{DIR,NAME}
7 @uref{../../\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c
8 @end macro
9 @macro usermanref{NAME}
10 @inforef{\NAME\,,../user/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 @macro textanchor{NAME}
24 @html
25 <a name="\NAME\"></a>
26 @end html
27 @end macro
28
29
30 @documentencoding utf-8
31 @documentlanguage en
32
33 @finalout
34
35 @ifnottex
36 @node Top
37 @top
38 @end ifnottex
39 @unnumbered New features in 2.11 since 2.10
40
41 @ifhtml
42 This document is also available in @uref{NEWS.pdf,PDF}. It's part of
43 the @uref{../,LilyPond Documentation} 
44 @end ifhtml
45
46
47
48
49 @itemize @bullet
50
51 @ignore
52
53 HINTS
54
55 * only show verbatim input for syntax/input changes
56
57 * try to be as brief possible in those cases
58
59 * don't try to provide real-world examples, they often get too big,
60 which scares away people.
61
62 * Write complete sentences.
63
64 * only show user-visible changes. 
65
66 @end ignore
67
68 @item
69 Particular points of a book may be marked with the @code{\label}
70 command. Then, the page where these points are placed can be refered to
71 using the @code{\page-ref} markup command.
72
73 @item
74 Page breaking and page turning commands (@code{\pageBreak},
75 @code{\noPageBreak}, etc) can be used at top-level, between scores and
76 top-level markups.
77
78 @item
79 The following options are now changed as a @code{-d} sub-option:
80 @code{--backend}, @code{--safe}, @code{--preview} and
81 @code{--no-pages} (which became @code{-dno-print-pages}).  The @code{-b}
82 option does not exist any more.
83
84 @item
85 Improved testing procedure now catch changes in CPU and memory
86 performance, page layout, MIDI results and warnings.  This helps to
87 reduce the number of regression errors during development, resulting
88 in more stable releases.
89
90 See @uref{INSTALL.html#testing} for more information.
91 @item
92 Nested properties, such as @code{details} in @code{Slur}, can be
93 reverted as well.  The syntax for this is
94
95 @example
96 \revert Slur #'(details closeness-factor)
97 @end example
98
99 @item
100 All line spanners are more flexible now in the configuration of their
101 end points.  This includes glissando, voice followers, text crescendos
102 and other text spanners.
103
104 @c  with ragged-right we can't see the gliss.
105 @lilypond[]
106 \relative c'' {
107   \override Glissando #'bound-details #'right #'text = \markup { \hcenter \bold down }
108   \override Glissando #'bound-details #'right #'Y = #-4
109   \override Glissando #'bound-details #'right #'padding = #0.0
110   \override Glissando #'bound-details #'left #'arrow = ##t
111   \override Glissando #'bound-details #'left #'padding = #3.0
112   \override Glissando #'style = #'trill
113   
114   c1 \glissando c'
115 }
116 @end lilypond
117
118 This feature was sponsored by Trevor Bača.
119
120  
121 @item
122 The environment variable LILYPONDPREFIX has been renamed to
123 LILYPOND_DATADIR.
124
125 @item
126 Notes or rests, such as a typical end note, that fill an entire
127 measure are preceded by some more space.
128
129 @lilypond[ragged-right]
130 \relative c' {
131   \time 4/4
132   s1
133   c2. c4
134   \time 3/4
135   c2.
136 }
137 @end lilypond
138
139 @item All @code{\score}s in a lilypond-book fragment are now inserted
140 into the document. Also, toplevel markups don't result in an entire
141 page.
142
143 @item Alterations (such as a sharp and flat) may now be arbitrary
144 fractions. This allows some forms of microtonal music.  For example,
145 Turkish makam music uses 1/9th tone alterations.
146
147 @lilypondfile{makam.ly}
148
149
150
151 @item Tie directions may be set with @code{^~} and @code{_~}
152
153 @item Tablature now supports harmonics and slides,
154
155 @lilypond[fragment,ragged-right,relative=1]
156 \new TabVoice
157 {
158     <c g'\harmonic> d\2\glissando e\2
159 }
160 @end lilypond
161
162 This feature was sponsored by Mike Amundsen
163
164 @item Horizontal spacing now follows object outlines more
165 accurately. This allows tighter horizontal spacing.
166
167 @lilypond[fragment,ragged-right]
168 {
169   \stemUp c''4...*1/2
170   ceses'!
171 }
172 @end lilypond
173
174
175 @item Objects that belong outside of the staff are
176 now positioned automatically to avoid collisions.
177
178 @lilypond[fragment,ragged-right,relative=1]
179   c''
180   \once \override TextScript #'self-alignment-X = #CENTER
181   a,^"this doesn't collide with the c"
182   b^"this goes above the previous markup"
183   a8_"this goes below the dynamic"
184   a\f
185 @end lilypond
186
187 @item Staves are spaced vertically using a skyline algorithm. This helps to avoid
188 uneven vertical spacing.
189
190 @lilypond[ragged-right]
191
192 %% todo: fix 'landscape PDF.
193 #(set-default-paper-size "a6" )
194 \header {
195   tagline = ##f
196 }
197
198 \book {
199   \score {
200     {
201       a,,1 | a'4 b' c'' d'' \break
202       \repeat unfold 2 {a' b' c'' d''} | b''''1
203     }
204   }
205 }
206 @end lilypond
207
208 @end itemize
209
210
211
212 @ifhtml
213 For older news, go to
214 @uref{http://lilypond.org/doc/v2.10/Documentation/topdocs/NEWS.html},
215 or @uref{../,go back} to the Documentation index.
216
217
218 @end ifhtml
219
220 @bye