From cd4dd66b3c24a96415a065852c300ebb47e76013 Mon Sep 17 00:00:00 2001
From: Graham Percival <graham@percival-music.ca>
Date: Thu, 4 Oct 2007 18:54:09 -0700
Subject: [PATCH] Misc updates for pitches.

---
 Documentation/user/pitches.itely | 24 +++++++++++-------------
 1 file changed, 11 insertions(+), 13 deletions(-)

diff --git a/Documentation/user/pitches.itely b/Documentation/user/pitches.itely
index faae41a6f6..3fddbdd814 100644
--- a/Documentation/user/pitches.itely
+++ b/Documentation/user/pitches.itely
@@ -77,6 +77,10 @@ a pitch; this method does not require as many octave
 specifications (@code{'} and @code{,}).  See @ref{Relative
 octaves}.
 
+@seealso
+
+Snippets: @lsrdir{pitch}
+
 
 @node Accidentals
 @unnumberedsubsubsec Accidentals
@@ -306,16 +310,6 @@ off by one octave
 \relative @var{startpitch} @var{musicexpr}
 @end example
 
-@noindent
-or
-
-@example
-\relative @var{musicexpr}
-@end example
-
-@noindent
-@code{c'} is used as the default if no starting pitch is defined.
-
 The octave of notes that appear in @var{musicexpr} are calculated
 as follows:
 
@@ -345,9 +339,6 @@ the pitch by two octaves.
 The pitch of the first note is relative to @code{\relative
 @var{startpitch} }.  
 
-@item
-If you do not specify @var{startpitch} then middle C is used.
-
 @end itemize 
 
 Here is the relative mode shown in action
@@ -379,11 +370,18 @@ used to determine the first note of the next chord
 
 The pitch after @code{\relative} contains a note name.
 
+@refbugs
+
 The relative conversion will not affect @code{\transpose},
 @code{\chordmode} or @code{\relative} sections in its argument.
 To use relative within transposed music, an additional
 @code{\relative} must be placed inside @code{\transpose}.
 
+@c DEPRECATED
+If no @var{startpitch} is specified for @code{\relative}, then
+@code{c'} is assumed.  However, this is a deprecated option and
+may disappear in future versions, so its use is discouraged.
+
 
 @node Octave check
 @unnumberedsubsubsec Octave check
-- 
2.39.5