Updated documentation

* Added paragraph and example about returning tuples from a filter
  (Issue #859)

* Added section about manualpois
  (Issue #858, Issue #869, Issue #598)

* Fixed a typo in the FAQ

* Added logging to file to the FAQ
  (Issue #871)
Merge in pull request #872