django/docs
Raphaël Hertzog 9f4e031bd3 Fixed #25761 -- Added __cause__.__traceback__ to reraised exceptions.
When Django reraises an exception, it sets the __cause__ attribute even
in Python 2, mimicking Python's 3 behavior for "raise Foo from Bar".
However, Python 3 also ensures that all exceptions have a __traceback__
attribute and thus the "traceback2" Python 2 module (backport of Python
3's "traceback" module) relies on the fact that whenever you have a
__cause__ attribute, the recorded exception also has a __traceback__
attribute.

This is breaking testtools which is using traceback2 (see
https://github.com/testing-cabal/testtools/issues/162).

This commit fixes this inconsistency by ensuring that Django sets
the __traceback__ attribute on any exception stored in a __cause__
attribute of a reraised exception.
2015-12-03 16:31:50 -05:00
..
_ext Removed a docs workaround for an old Sphinx version. 2015-11-16 18:49:32 -05:00
_theme Fixed many spelling mistakes in code, comments, and docs. 2015-12-03 12:48:24 -05:00
faq Fixed #25778 -- Updated docs links to use https when available. 2015-12-01 08:01:34 -05:00
howto Fixed #25851 -- Removed links to deprecated assignment tag docs. 2015-12-03 10:40:56 -05:00
internals Fixed #25778 -- Updated docs links to use https when available. 2015-12-01 08:01:34 -05:00
intro Fixed #25778 -- Updated docs links to use https when available. 2015-12-01 08:01:34 -05:00
man Fixed #25578 -- Corrected the casing of "GitHub". 2015-10-21 07:31:11 -04:00
misc Fixed #25755 -- Unified spelling of "website". 2015-11-16 06:44:14 -05:00
ref Fixed #25761 -- Added __cause__.__traceback__ to reraised exceptions. 2015-12-03 16:31:50 -05:00
releases Refs #25659 -- Added missing docs for Difference/Intersection/SymDifference functions. 2015-12-03 12:59:01 -05:00
topics Fixed many spelling mistakes in code, comments, and docs. 2015-12-03 12:48:24 -05:00
Makefile
README
conf.py Fixed many spelling mistakes in code, comments, and docs. 2015-12-03 12:48:24 -05:00
contents.txt
glossary.txt Updated Wikipedia links to use https 2015-08-08 12:02:32 +02:00
index.txt Fixed #25778 -- Updated docs links to use https when available. 2015-12-01 08:01:34 -05:00
make.bat
spelling_wordlist Fixed many spelling mistakes in code, comments, and docs. 2015-12-03 12:48:24 -05:00

README

The documentation in this tree is in plain text files and can be viewed using
any text file viewer.

It uses ReST (reStructuredText) [1], and the Sphinx documentation system [2].
This allows it to be built into other forms for easier viewing and browsing.

To create an HTML version of the docs:

* Install Sphinx (using ``pip install Sphinx`` or some other method)

* In this docs/ directory, type ``make html`` (or ``make.bat html`` on
  Windows) at a shell prompt.

The documentation in _build/html/index.html can then be viewed in a web browser.

[1] http://docutils.sourceforge.net/rst.html
[2] http://sphinx-doc.org/