Clean up and extend parse_apache example

Add code comments and implement follow mode (like tail -f). Also fixes
scaling of request_rate.
Small API doc fix

Remove reference to a method that was never implemented.
Extend README