Usage notes and subtle features

lmadsen 2009-06-05