Usage notes and subtle features

lmadsen 2011-02-21