@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
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