+@c TODO - this isn't such a great place for this note, but I can't
+@c find a better place without rearranging a lot of lyric stuff.
+@c It's yet another thing to look at post-3.0.
+
+The @code{\addlyrics} command is actually just a convienient way
+to write a more complicated LilyPond structure that sets up the
+lyrics. You should use @code{\addlyrics} unless you need to
+fancy things, in which case you should investigate
+@code{\lyricsto} or @code{\lyricmode}.
+
+@example
+ @{ MUSIC @}
+ \addlyrics @{ LYRICS @}
+@end example
+
+is the same as
+
+@example
+ \context Voice = blah @{ music @}
+ \lyricsto "blah" \lyricsmode \new lyrics @{ LYRICS @}
+@end example
+
+