updated documentation, no more 'DEFINE's