django/docs
Marc Tamlyn be733bf672 [1.7.x] Fixed #22510 -- Harden field removal to only None.
Refs #8620.

If we allow any value to remove form fields then we get name clashes
with method names, media classes etc. There was a backwards
incompatibility introduced meaning ModelForm subclasses with declared
fields called media or clean would lose those fields.

Field removal is now only permitted by using the sentinel value None.
The docs have been slightly reworded to refer to removal of fields
rather than shadowing.

Thanks to gcbirzan for the report and initial patch, and several of the
core team for opinions.

Backport of 9fb0f5dddc from master
2014-05-24 13:11:50 +01:00
..
_ext Fixed #21869 -- Fixed docs building with Sphinx 1.2.1. 2014-01-24 08:52:43 -05:00
_theme Fixed some typos and formatting issues in docs. 2014-03-03 08:37:17 -05:00
faq [1.7.x] Used link label in models FAQ to ease translation 2014-05-22 09:48:04 +02:00
howto [1.7.x] Fixed #22619 -- Corrected description of os.path. 2014-05-12 18:58:11 -04:00
internals [1.7.x] Updated some docs for the delayed deprecation of legacy table creation; refs #22340. 2014-05-07 09:04:21 -04:00
intro [1.7.x] Reordered tutorial 1 so that the database is configured first. 2014-05-05 13:42:36 -04:00
man Removed a man page for a command that was removed 2014-01-10 15:23:06 -08:00
misc Fixed #16785 -- Documented some of the design decisions of the cache framework. 2014-01-16 21:13:08 -05:00
ref [1.7.x] Fixed #22510 -- Harden field removal to only None. 2014-05-24 13:11:50 +01:00
releases [1.7.x] Fixed #22510 -- Harden field removal to only None. 2014-05-24 13:11:50 +01:00
topics [1.7.x] Fixed #22510 -- Harden field removal to only None. 2014-05-24 13:11:50 +01:00
Makefile Fixed #22141 -- Added a spelling checker for documentation. 2014-03-07 09:29:23 -05:00
README Whitespace cleanup. 2013-10-10 16:49:20 -04:00
conf.py [1.7.x] Updated doc links to point to Python 3 documentation 2014-04-26 16:03:40 +02:00
contents.txt Removed an obsolete documentation page about admin style customization. 2012-09-10 17:19:35 -07:00
glossary.txt Fixed some typos in the documentation. 2014-03-02 17:05:57 +01:00
index.txt [1.7.x] Link new testing tools document from main index. 2014-05-10 23:29:42 -03:00
make.bat Fixed #19516 - Fixed remaining broken links. 2013-01-02 18:32:57 -05:00
spelling_wordlist [1.7.x] Fixed spelling mistake and added a word to the word list. 2014-05-13 09:17:32 -04: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 ``sudo 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/