Yes, there are some discrepancies between the documentation and the current set of macros that is distributed with magic. There is a compile-time option for using the "old style" macros that would correspond exactly to the tutorials. Every now and then I think about updating the tutorials properly, but it's a huge task, and the existing tutorials were converted from LaTeX to HTML which makes them a pain to edit.