From adac8cdb87709e50fe9a3cb5601775555c125707 Mon Sep 17 00:00:00 2001
From: Graham Percival <graham@percival-music.ca>
Date: Sun, 27 Aug 2006 06:54:06 +0000
Subject: [PATCH] Info from NEWS into the manual.
---
ChangeLog | 7 +++++
Documentation/topdocs/NEWS.tely | 1 +
Documentation/user/advanced-notation.itely | 28 ++++++++-----------
Documentation/user/basic-notation.itely | 29 ++++++++++++++++++--
Documentation/user/changing-defaults.itely | 12 ++++++++
Documentation/user/instrument-notation.itely | 24 ++++++++++++++++
Documentation/user/page.itely | 9 +++---
7 files changed, 87 insertions(+), 23 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 0d5b3e5544..a83ed89be5 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+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
diff --git a/Documentation/topdocs/NEWS.tely b/Documentation/topdocs/NEWS.tely
index 17a68755d8..eb12135459 100644
--- a/Documentation/topdocs/NEWS.tely
+++ b/Documentation/topdocs/NEWS.tely
@@ -192,6 +192,7 @@ Nested tuplets can have different formatting for each nesting level,
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
diff --git a/Documentation/user/advanced-notation.itely b/Documentation/user/advanced-notation.itely
index 5231745bfe..f5802482a3 100644
--- a/Documentation/user/advanced-notation.itely
+++ b/Documentation/user/advanced-notation.itely
@@ -1922,26 +1922,22 @@ Program reference: @internalsref{NoteHead}.
@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
diff --git a/Documentation/user/basic-notation.itely b/Documentation/user/basic-notation.itely
index a511c18940..4a8b13c730 100644
--- a/Documentation/user/basic-notation.itely
+++ b/Documentation/user/basic-notation.itely
@@ -1826,7 +1826,12 @@ e' ~ e' <c' e' g'> ~ <c' e' g'>
@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
@@ -1875,6 +1880,7 @@ for example, to tie a tremolo to a chord. For example,
\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
@@ -2550,7 +2556,13 @@ c\< c\! d\> e\!
@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,
@@ -2567,6 +2579,19 @@ example
\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
diff --git a/Documentation/user/changing-defaults.itely b/Documentation/user/changing-defaults.itely
index e63bb9ab88..97525e0c46 100644
--- a/Documentation/user/changing-defaults.itely
+++ b/Documentation/user/changing-defaults.itely
@@ -393,6 +393,18 @@ beaming should be switched off with @code{\autoBeamOff}.
@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
diff --git a/Documentation/user/instrument-notation.itely b/Documentation/user/instrument-notation.itely
index dff24703ed..900b5f551a 100644
--- a/Documentation/user/instrument-notation.itely
+++ b/Documentation/user/instrument-notation.itely
@@ -4371,6 +4371,30 @@ Internally, the code produces markup texts. You can use any of the
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},
diff --git a/Documentation/user/page.itely b/Documentation/user/page.itely
index 2c94b648fd..bce2eced58 100644
--- a/Documentation/user/page.itely
+++ b/Documentation/user/page.itely
@@ -596,6 +596,7 @@ negative.
@menu
* Horizontal spacing overview::
+* New spacing area::
* Changing horizontal spacing::
* Line length::
@end menu
@@ -707,8 +708,6 @@ following work-around may be used to insert extra space into a score.
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
@@ -719,15 +718,15 @@ sections with a different notions of long and short notes.
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
--
2.39.5