Usage notes and subtle features

lmadsen 2010-08-10