improve documentation.  complete request parser.