From 94cce45d444cd6700d3f4df84cda68fb7de96cd7 Mon Sep 17 00:00:00 2001
From: Trevor Daniels <t.daniels@treda.co.uk>
Date: Tue, 22 Feb 2011 12:32:39 +0000
Subject: [PATCH] Doc: Move Retrograde to a section on its own

 - as it is independent of the scale it does not
   belong with modal transformations
---
 Documentation/notation/pitches.itely | 80 +++++++++++++++++-----------
 1 file changed, 50 insertions(+), 30 deletions(-)

diff --git a/Documentation/notation/pitches.itely b/Documentation/notation/pitches.itely
index cf3f2206f4..1bd632d33c 100644
--- a/Documentation/notation/pitches.itely
+++ b/Documentation/notation/pitches.itely
@@ -595,6 +595,7 @@ This section discusses how to modify pitches.
 * Octave checks::
 * Transpose::
 * Inversion::
+* Retrograde::
 * Modal transformations::
 @end menu
 
@@ -789,9 +790,11 @@ see @ref{Instrument transpositions}.
 
 @seealso
 Notation Reference:
-@ref{Relative octave entry},
+@ref{Instrument transpositions},
+@ref{Inversion},
 @ref{Modal transformations},
-@ref{Instrument transpositions}.
+@ref{Relative octave entry},
+@ref{Retrograde}.
 
 Snippets:
 @rlsr{Pitches}.
@@ -840,6 +843,45 @@ music = \relative c' { c d e f }
 }
 @end lilypond
 
+@seealso
+Notation Reference:
+@ref{Modal transformations},
+@ref{Retrograde},
+@ref{Transpose}.
+
+
+@node Retrograde
+@unnumberedsubsubsec Retrograde
+
+@cindex retrograde transformation
+@cindex transformation, retrograde
+@cindex operation, retrograde
+@funindex \retrograde
+@funindex retrograde
+
+A music expression can be reversed to produce its retrograde:
+
+@lilypond[verbatim,quote]
+music = \relative c' { c8. ees16( fis8. a16 b8.) gis16 f8. d16 }
+
+\new Staff {
+  \music
+  \retrograde \music
+}
+@end lilypond
+
+@knownissues
+Manual ties inside @code{\retrograde} will be broken and
+generate warnings.  Some ties can be generated automatically
+by enabling @ref{Automatic note splitting}.
+
+@seealso
+Notation Reference:
+@ref{Inversion},
+@ref{Modal transformations},
+@ref{Transpose}.
+
+
 @node Modal transformations
 @unnumberedsubsubsec Modal transformations
 
@@ -849,9 +891,10 @@ music = \relative c' { c d e f }
 
 In a musical composition that is based on a scale, a motif is
 frequently transformed in various ways.  It may be
-@notation{transposed} to start at different places in the scale, it
-may be @notation{inverted} around a pivot point in the scale, and/or
-it may be converted to its @notation{retrograde} (written backwards).
+@notation{transposed} to start at different places in the scale or
+it may be @notation{inverted} around a pivot point in the scale.
+It may also be reversed to produce its @notation{retrograde}, see
+@ref{Retrograde}.
 
 @warning{Any note that does not lie within the given scale will be
 left untransformed.}
@@ -961,26 +1004,6 @@ motive = \relative c' { c c g' c, }
 }
 @end lilypond
 
-
-@subsubheading Retrograde transformation
-
-@cindex retrograde transformation
-@cindex transformation, retrograde
-@cindex operation, retrograde
-@funindex \retrograde
-@funindex retrograde
-
-A motif can be reversed to produce its retrograde:
-
-@lilypond[verbatim,quote]
-motif = \relative c' { c8. ees16( fis8. a16 b8.) gis16 f8. d16 }
-
-\new Staff {
-  \motif
-  \retrograde \motif
-}
-@end lilypond
-
 The combined operation of inversion and retrograde produce the
 retrograde-inversion:
 
@@ -996,13 +1019,10 @@ motif = \relative c' { c8. ees16 fis8. a16 b8. gis16 f8. d16 }
 
 @seealso
 Notation Reference:
+@ref{Inversion},
+@ref{Retrograde},
 @ref{Transpose}.
 
-@knownissues
-Manual ties inside @code{\retrograde} will be broken and
-generate warnings.  Some ties can be generated automatically
-by enabling @ref{Automatic note splitting}.
-
 
 @node Displaying pitches
 @subsection Displaying pitches
-- 
2.39.2