[Checkins] [zopefoundation/zope.interface] 00b951: Port the documentation examples to Python 3

[Marius Gedminas]

  Branch: refs/heads/master
  Home:   https://github.com/zopefoundation/zope.interface
  Commit: 00b9513ded69e2384128cdb58dabd85aa0338e44
      https://github.com/zopefoundation/zope.interface/commit/00b9513ded69e2384128cdb58dabd85aa0338e44
  Author: Marius Gedminas <marius at gedmin.as>
  Date:   2019-11-11 (Mon, 11 Nov 2019)

  Changed paths:
    M docs/README.rst
    M docs/adapter.rst
    M docs/api/declarations.rst
    M docs/api/specifications.rst
    M docs/human.rst
    M docs/verify.rst
    M tox.ini

  Log Message:
  -----------
  Port the documentation examples to Python 3


  Commit: 4d722f3642ea1264180be5339985ac293098763e
      https://github.com/zopefoundation/zope.interface/commit/4d722f3642ea1264180be5339985ac293098763e
  Author: Marius Gedminas <marius at gedmin.as>
  Date:   2019-11-11 (Mon, 11 Nov 2019)

  Changed paths:
    M .travis.yml

  Log Message:
  -----------
  Build docs with Sphinx on Travis CI

YAML borrowed from zopefoundation/persistent.


  Commit: 14dad7972493430856660b759700e4836e6a17aa
      https://github.com/zopefoundation/zope.interface/commit/14dad7972493430856660b759700e4836e6a17aa
  Author: Marius Gedminas <marius at gedmin.as>
  Date:   2019-11-11 (Mon, 11 Nov 2019)

  Changed paths:
    M docs/api/declarations.rst

  Log Message:
  -----------
  Move the @provider example into the right section

Explain that implements()/implementsOnly()/classProvides() not only
should not be "preferred", but are entirely not functional on Python 3.

(These notes should probably use some Sphinx directive to stand out
better, but I'm not well versed in Sphinx and I don't know which one I
should use.)


  Commit: 98065287e23aa2f2f15c15c14ad24fd01942fc93
      https://github.com/zopefoundation/zope.interface/commit/98065287e23aa2f2f15c15c14ad24fd01942fc93
  Author: Marius Gedminas <marius at gedmin.as>
  Date:   2019-11-11 (Mon, 11 Nov 2019)

  Changed paths:
    M docs/api/declarations.rst

  Log Message:
  -----------
  Use .. caution:: to warn about the the old class-advice based APIs


  Commit: a3d9b8906afe0ce390a0148f66c9345e46bea901
      https://github.com/zopefoundation/zope.interface/commit/a3d9b8906afe0ce390a0148f66c9345e46bea901
  Author: Marius Gedminas <marius at gedmin.as>
  Date:   2019-11-11 (Mon, 11 Nov 2019)

  Changed paths:
    M .travis.yml
    M docs/README.rst
    M docs/adapter.rst
    M docs/api/declarations.rst
    M docs/api/specifications.rst
    M docs/human.rst
    M docs/verify.rst
    M tox.ini

  Log Message:
  -----------
  Merge pull request #142 from zopefoundation/docs-in-py3

Port the documentation examples to Python 3


Compare: https://github.com/zopefoundation/zope.interface/compare/e71dbc3e4b60...a3d9b8906afe