Doctr

==================
- Fix for critical bug that allowed pushing docs from any branch. (:issue:`160`)

==================
- The ``--gh-pages-docs`` flag of ``doctr deploy`` has been deprecated.
Specify the deploy directory like ``doctr deploy .`` or ``doctr deploy docs``.
There is also no longer a default deploy directory. (:issue:`128`)
- ``setup_GitHub_push`` now takes a ``branch_whitelist`` parameter instead of
of a ``require_master``
- ``.travis.yml`` can be used to store some of doctr configuration in addition
to the command line flags. Write doctr configuration under the ``doctr`` key.
(:issue:`137`)
- All boolean command line flags now have a counterpart that can overwrite
the config values set in ``.travis.yml``
- ``doctr`` can now deploy to organization accounts (``github.io``)
(:issue:`25`)
- Added ``--deploy-branch-name`` flag to specify which branch docs will be
deployed to

==================
- Fix Travis API endpoint when checking if a repo exists. (:issue:`143`)
- Add warnings about needing ``set -e`` in ``.travis.yml``. (:issue:`146`)
- Explicitly pull from ``doctr_remote`` on Travis. (:issue:`147`)
- Don't attempt to push ``gh-pages`` to the remote when pushing is disallowed
(e.g., on a pull request). (:issue:`150`)
- ``doctr configure`` now deletes the public key automatically. (:issue:`151`)

==================

- Set the git ``user.email`` configuration option. This is now required by the
latest versions of git. (:issue:`138`, :issue:`139`)
- Add more information to the automated commit messages. (:issue:`134`)
- Run doctr tests on Travis with a personal access token, avoiding rate
limiting errors. (:issue:`133`)
- Run all doctr steps except for the push on every build. Add ``--no-push``
option. Thanks :user:`Carreau`. (:issue:`125`, :issue:`126`, :issue:`132`)
- Clarify in docs that doctr is not just for Sphinx. (:issue:`129`,
:issue:`130`)
- Use the latest version of sphinxcontrib.autoprogram to build the doctr docs.
(:issue:`127`)
- Check that the build repo exists on Travis. (:issue:`114`, :issue:`123`)

==================

- Add support for private GitHub repositories using travis-ci.com (thanks
:user:`dan-blanchard`). (:issue:`121`)
- Add a list of projects using doctr to the docs. (:issue:`116`)
- Use the sphinx-issues extension in the changelog. (:issue:`99`)
- Swap "description" and "long_description" in setup.py. (:issue:`120`)

==================

Major Changes
-------------

- Fix the --built-docs option. (:issue:`111`)

Minor Changes
-------------

- Get the setup.py description from the README. (:issue:`103`)
- Add link to GitHub docs for branch protection (thanks :user:`willingc`). (:issue:`100`)