Now that we have a proper purge-mechanism, all the magic to
set obj.{ttl,grace,keep} in vcl_hit{} can go away.

The builtin VCL supports this now. Since so many noticed this missing
in 3.0, I think it should be mentioned.

Generated RST file should live in include/ like the others, not in reference/.

Try to make the code slightly more readable through a descriptive variable name
for the file handle.

I don't have Python 3.1, but I do have Python 3.3.5 which should suffice.

We include these autogenerated files directly where they are needed.

Let the main sphinx process ignore them, so it doesn't complain that they're
not referenced anywhere.

Try to document our conventions when it comes to commands, paths, tool names
and similar.

Also write some formatting rules for maintainers, like wrapping at 80
characters and avoiding tabs.

I'm happy to discuss changing these if someone feels strongly about anything,
the main point is just to make it easier to read though being consequent about
it throughout the manual.

req.request is now called req.method.

We don't know how to handle incoming chunked bodies currently, but the backend
might.

Done. Important changes are consequently commented and all comments are marked with the string 'benc' for easy identification. There are some heavy refactorings done, that fundamentally changes content meaing.