0
0
mirror of https://github.com/django/django.git synced 2024-12-01 15:42:04 +01:00
django/docs
Aymeric Augustin 8b5b199e20 Fixed #3214 -- Stopped parsing SQL with regex.
Avoided introducing a new regex-based SQL splitter in the migrations
framework, before we're bound by backwards compatibility.

Adapted this change to the legacy "initial SQL data" feature, even
though it's already deprecated, in order to facilitate the transition
to migrations.

sqlparse becomes mandatory for RunSQL on some databases (all but
PostgreSQL). There's no API to provide a single statement and tell
Django not to attempt splitting. Since we have a more robust splitting
implementation, that seems like a good tradeoff. It's easier to add a
new keyword argument later if necessary than to remove one.

Many people contributed to both tickets, thank you all, and especially
Claude for the review.

Refs #22401.
2014-04-26 17:46:23 +02:00
..
_ext
_theme
faq Added Python 3.4 support notes. 2014-03-27 08:01:33 -04:00
howto Specified 'csv and unicode' note as Python 2 only 2014-04-26 16:09:19 +02:00
internals Fixed #3214 -- Stopped parsing SQL with regex. 2014-04-26 17:46:23 +02:00
intro Updated doc links to point to Python 3 documentation 2014-04-26 16:02:53 +02:00
man Fixed #22328 -- Added --exclude option to compilemessages and makemessages. 2014-04-26 17:07:44 +07:00
misc
ref Fixed #3214 -- Stopped parsing SQL with regex. 2014-04-26 17:46:23 +02:00
releases Fixed #3214 -- Stopped parsing SQL with regex. 2014-04-26 17:46:23 +02:00
topics Updated doc links to point to Python 3 documentation 2014-04-26 16:02:53 +02:00
conf.py Updated doc links to point to Python 3 documentation 2014-04-26 16:02:53 +02:00
contents.txt
glossary.txt
index.txt
make.bat
Makefile Fixed #22141 -- Added a spelling checker for documentation. 2014-03-07 09:29:23 -05:00
README
spelling_wordlist Various documentation typo/spelling fixes 2014-04-23 02:31:49 +03:00

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/