fix misspelled words, remove line ending spaces, change ``-`` to ``--``,
add some ``'`` between subject and 'to be' verb (e.g. "it's", "i'm"),
add some ending dots to sentences, change some letters "capitalness", etc.

- add conditionals to pygments-dependent tests that ensure
pygments 1.4, separate check for no pygments.

  now succeed, as "pass" is added for these
  when no statements are otherwise present.
  Courtesy Ben Trofatter [ticket:146]

- fix up links, formatting in docs
- remove some repetition in the _compile logic

Corrected the success conditions of test_utf8_html_error_template and
test_utf8_format_exceptions when testing in py2.x without pygments to
match the currently expected output.

  "pass_context"; when True, the keyword argument
  'context' will be passed to get_or_create()
  containing the Mako Context object.
  [ticket:185]

- changelog

  apply Pygments highlighting to the source
  code displayed in the traceback, if Pygments
  if available.  Courtesy Ben Trofatter
  [ticket:95]

  i.e. "% with x as e:/ % endwith" support.
  Courtesy Ben Trofatter [ticket:147]

  nesting multiple def-calls with content.
  Thanks to Jeff Dairiki. [ticket:186]

``TITLE``, ``USER`` and ``(U_)ITEMS``.

*   add two new templates directory: ``examples/bench/jinja2`` and ``examples/bench/jinja2_inheritance``;
*   add two set of Jinja2 templates, matching those related to Mako;
*   add new ``jinja2`` function in ``examples/bench/basic.py`` module to load these new templates.

  to filehandles being implicitly closed.
  [ticket:182]

  Cache() constructor, which was preventing file
  version checks and not allowing Mako 0.6 to
  recompile the module files.

  (even though several of those old template libs aren't
  available on Py3K, so YMMV) [ticket:175]

  in templates.   Usage of regions should be considered
  as superseding the very obsolete idea of passing in
  backend options, timeouts, etc. within templates.
- rewrite the cache docs again which had a lot of misleading/inaccurate
info.