From: Graham Percival <graham@percival-music.ca>
Date: Mon, 24 Aug 2009 23:46:46 +0000 (+0100)
Subject: Doc: slight clarification of accidentals.
X-Git-Tag: release/2.13.4-1~142
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=eda038a76dcacd74d890887008df3e8865a66468;p=lilypond.git

Doc: slight clarification of accidentals.
---

diff --git a/Documentation/learning/common-notation.itely b/Documentation/learning/common-notation.itely
index ac86a64286..c9eb78dd1d 100644
--- a/Documentation/learning/common-notation.itely
+++ b/Documentation/learning/common-notation.itely
@@ -62,6 +62,10 @@ on one staff.
 @node Accidentals and key signatures
 @subsection Accidentals and key signatures
 
+@warning{New users are often confused by these -- please read the
+warning at the bottom of this page, especially if you are not
+familiar with music theory!}
+
 @subheading Accidentals
 
 @cindex accidentals
@@ -169,6 +173,11 @@ note with pitch B-natural.}  In the key of A-flat major, it
 b
 @end lilypond
 
+If the above seems confusing, consider this: if you were playing a
+piano, which key would you hit?  If you would press a black key,
+then you @emph{must} add @code{-is} or @code{-es} to the note
+name!
+
 Adding all alterations explicitly might require a little more
 effort when typing, but the advantage is that
 @notation{transposing} is easier, and accidentals can be printed