Add warning not to place predefs immediately before grace notes
\new Staff { c4 \bar "|:" \grace s16 d2. } >>
@end lilypond
+Predefined commands, like @code{\voiceOne}, which are intended to
+change the behaviour of the notation after a grace note, may not
+be effective if placed immediately before the grace note -- they
+should be placed after it.
+
Grace sections should only be used within sequential music
expressions. Nesting or juxtaposing grace sections is not
supported, and might produce crashes or other errors.