From: Trevor Daniels <t.daniels@treda.co.uk>
Date: Tue, 26 Jun 2012 07:34:46 +0000 (+0100)
Subject: Doc: clarify operation of \inversion (2618)
X-Git-Tag: release/2.15.41-1~18
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=e061d65d89f0b0e48edbfc4e9674703cc05eeea1;p=lilypond.git

Doc: clarify operation of \inversion (2618)
---

diff --git a/Documentation/notation/pitches.itely b/Documentation/notation/pitches.itely
index d3d2d9a220..be5c34edae 100644
--- a/Documentation/notation/pitches.itely
+++ b/Documentation/notation/pitches.itely
@@ -820,15 +820,16 @@ rather than e-triple-flat).
 @cindex operation, inversion
 @funindex \inversion
 
-A music expression can be inverted with:
+A music expression can be inverted and transposed in a single
+operation with:
 
 @example
-\inversion @var{from-pitch} @var{to-pitch} @var{musicexpr}
+\inversion @var{around-pitch} @var{to-pitch} @var{musicexpr}
 @end example
 
-The @code{@var{musicexpr}} is inverted interval-by-interval,
-and then transposed so that @code{@var{from-pitch}} is mapped
-to @code{@var{to-pitch}}.
+The @code{@var{musicexpr}} is inverted interval-by-interval around
+@code{@var{around-pitch}}, and then transposed so that
+@code{@var{around-pitch}} is mapped to @code{@var{to-pitch}}.
 
 @lilypond[verbatim,quote]
 music = \relative c' { c d e f }
@@ -839,6 +840,10 @@ music = \relative c' { c d e f }
 }
 @end lilypond
 
+@warning{Motifs to be inverted should be expressed in absolute form
+or be first converted to absolute form by enclosing them in a 
+@code{\relative} block.}
+
 @seealso
 Notation Reference:
 @ref{Modal transformations},