record with timing info about the fetch.

Submitted by: Geoff Simmons @ UPLEX

RFC-compliant.

Fixes #1356

Fixes #1363

Thanks to James Pearson for the suggestion.

Fixes #1357

UTF-8 BOM's at the start of an ESI-object.

Notice that the removal only happens if the file is actually ESI
processed on delivery, so to get BOM removal for non-XML files,
you may have to disable the XML test and insert a dummy ESI directive
such as <esi:remove>BOMs Be Gone!<esi:remove/> or similar.

Fixes   #1355

If the short description of a log record contains the string
"(unused)" it will not be listed in the documentation.

Format the long log record descriptions for use with pre-formatted
text style.

The xid field is not present in ReqEnd any more, as it is not needed
now that the vxid is used as the record ID. Remove it from the
description.

This patch generates an rst file containing the record tag
documentation from the corresponding header tables.

It also adds a man-page from the vsl.rst document and includes the tag
descriptions.

The old list of tags in varnishlog.rst is removed.

Fixes: #1338

Thanks scoof

instead of the number of incomplete transactions.

Session grouping mode could grab an unintended amount of memory
because the transaction limit was counted towards the incomplete
rather that not yet reported transactions. A long lasting session
would only count as 1 towards the limit even if it had thousands of
complete children that should put it above the limit.

VSL_Dispatch would return with (1) when the cursor reports more data
available, causing the processing of ready transaction not to be
run. Would cause 'varnishlog -d' not to report any data in some
situations.

Add some comments about the different return points in VSL_Dispatch.

If this option is set, the cursor will return EOF when reaching the log tail.

evaluation.