+2006-08-27 Graham Percival <gpermus@gmail.com>
+
+ * Documentation/topdocs/NEWS.itely: add @c marker for
+ stuff I've processed.
+
+ * Documentation/user/ various: info from NEWS.
+
2006-08-27 Joe Neeman <joeneeman@gmail.com>
* lily/paper-column-engraver.cc (finalize): Oops, this change
This feature was sponsored by Trevor Bača.
+@c TODO: I haven't processed stuff above this mark. -gp
@item
New sections with different spacing parameters can be started with
@node Feathered beams
@subsection Feathered beams
-Feathered beams are not supported natively, but they can be faked by
-forcing two beams to overlap. Here is an example,
+Feathered beams are printed by setting the @code{grow-direction}
+property of a @code{Beam}. The @code{\featherDurations} function
+can be used to adjust note durations.
-@c don't change relative setting witout changing positions!
@lilypond[ragged-right,relative=1,fragment,verbatim,quote]
-\new Staff <<
- \new Voice
- {
- \stemUp
- \once \override Voice.Beam #'positions = #'(0 . 0.5)
- c8[ c c c c ]
- }
- \new Voice {
- \stemUp
- \once \override Voice.Beam #'positions = #'(0 . -0.5)
- c[ c c c c]
- }
->>
+\featherDurations #(ly:make-moment 5 4)
+{
+ \override Beam #'grow-direction = #LEFT
+ c16[ c c c c c c]
+}
@end lilypond
+@refbugs
+
+The @code{\featherDuration} command only works with very short
+music snippets.
@node Improvisation
@subsection Improvisation
@end lilypond
When a tie is applied to a chord, all note heads whose pitches match
-are connected. When no note heads match, no ties will be created.
+are connected. When no note heads match, no ties will be created. Chords
+may be partially tied by placing the tie inside the chord,
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+<c~ e g~ b> <c e g b>
+@end lilypond
A tie is just a way of extending a note duration, similar to the
augmentation dot. The following example shows two ways of notating
\set tieWaitForNote = ##t
\grace { c16[~ e~ g]~ } <c, e g>2
\repeat "tremolo" 8 { c32~ c'~ } <c c,>1
+e8~ c~ a~ f~ <e' c a f>2
@end lilypond
@noindent
A hairpin starts at the left edge of the beginning note and ends on the
-right edge of the ending note.
+right edge of the ending note. This may be modified by setting
+the @code{hairpinToBarline} property,
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\set hairpinToBarline = ##t
+c4\< c2. c4\!
+@end lilypond
In some situations the @code{\espressivo} articulation mark may
be suitable to indicate a crescendo and decrescendo on the one note,
\override Voice.Hairpin #'minimum-length = #5
@end example
+@cindex al niente
+@cindex niente, al
+
+Hairpins may be printed with a circled tip (al niente notation) by
+setting the @code{circled-tip} property,
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\override Hairpin #'circled-tip = ##t
+c2\< c\!
+c4\> c\< c2\!
+@end lilypond
+
+
@cindex crescendo
@cindex decrescendo
@cindex diminuendo
@funindex \autoBeamOn
@code{\autoBeamOn}.
+@commonprop
+
+Beaming patterns may be altered with the @code{beatGrouping} property,
+
+@lilypond[quote,verbatim,relative=2,fragment,ragged-right]
+\time 5/16
+\set beatGrouping = #'(2 3)
+c8[^"(2+3)" c16 c8]
+\set beatGrouping = #'(3 2)
+c8[^"(3+2)" c16 c8]
+@end lilypond
+
@refbugs
markup text properties to override formatting. For example, the
vertical spacing of the figures may be set with @code{baseline-skip}.
+
+Figured bass can also be added to @code{Staff} contexts
+directly. In this case, their vertical position is adjusted
+automatically.
+
+@lilypond[ragged-right,fragment,quote]
+<<
+ \new Staff = someUniqueName
+ \relative c'' {
+ c4 c'8 r8 c,4 c'
+ }
+
+ %% send to existing Staff.
+ \context Staff = someUniqueName
+ \figuremode {
+ <4>4 <6 10>8 s8
+
+ \set Staff.useBassFigureExtenders = ##t
+ <4 6>4 <4 6>
+ }
+>>
+@end lilypond
+
+
@seealso
Program reference: @internalsref{NewBassFigure},
@menu
* Horizontal spacing overview::
+* New spacing area::
* Changing horizontal spacing::
* Line length::
@end menu
No work-around exists for decreasing the amount of space.
-@c FIXME: include this in 2.9; currently removed for 2.8 -gp
-@ignore
@node New spacing area
@subsection New spacing area
In the following example, the time signature change introduces a new
section, and hence the 16ths notes are spaced wider.
-@li lypond[relative,fragment,verbatim,quote]
+@lilypond[relative,fragment,verbatim,quote]
\time 2/4
c4 c8 c
c8 c c4 c16[ c c8] c4
\newSpacingSection
\time 4/16
c16[ c c8]
-@e nd lilypond
-@end ignore
+@end lilypond
+
@node Changing horizontal spacing
@subsection Changing horizontal spacing