p31829507
/
django
mirror of https://github.com/django/django.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
29,990 Commits 28 Branches 411 Tags 641 MiB
Commit Graph

331 Commits

Author SHA1 Message Date
Mariusz Felisiak 081e787160 Refs #23919 -- Stopped inheriting from object to define new style classes. 
Tests and docs complement to cecc079168.
 2017-06-26 10:30:31 -04:00
Tim Graham c68f5d83c0 Fixed #27655 -- Added some guidelines to the coding style docs. 2017-06-12 15:39:09 -04:00
Claude Paroz 01f658644a Updated various links in docs to avoid redirects 
Thanks Tim Graham and Mariusz Felisiak for review and completion.
 2017-05-22 19:28:44 +02:00
Mariusz Felisiak 9b2d47bcde Fixed broken link to QUnit docs. 2017-05-03 07:31:59 -04:00
Markus Holtermann 6d7cbe67f0 Removed inappropriate highlighting in committing-code.txt. 2017-04-20 11:32:56 -04:00
Sergey Fedoseev 24d40e7e0c Removed unused links in docs/internals/contributing/triaging-tickets.txt. 2017-03-25 13:05:48 -04:00
Mikkel Munch Mortensen 1e93210f1f Fixed #27963 -- Removed unneeded docstring example in contributing docs. 2017-03-21 10:12:41 -04:00
Tim Graham 3d14cbc867 Removed docs/internals/roles.txt. 
It's moved to https://www.djangoproject.com/foundation/teams/.
 2017-02-15 09:31:41 +01:00
Tim Graham f6acd1d271 Refs #23919 -- Removed Python 2 notes in docs. 2017-01-18 11:51:29 -05:00
Claude Paroz f3c43ad1fd Refs #23919 -- Removed python_2_unicode_compatible decorator usage 2017-01-18 13:44:34 +01:00
Tim Graham e27e4c0339 Removed versionadded/changed annotations for 1.10. 2017-01-17 20:52:05 -05:00
Tim Graham 61225ef721 Removed the importance of "core developers" in triaging tickets, etc. 2016-12-21 20:18:13 -05:00
Alix Martineau 0a8c685447 Fixed #27439 -- Documented macOS locale configuration for Django tests. 2016-12-20 12:58:14 -05:00
Tim Graham b5f0b3478d Fixed #27579 -- Added aliases for Python 3's assertion names in SimpleTestCase. 2016-12-07 17:42:31 -05:00
François Freitag 0783aa7deb Refs #23811 -- Corrected git bisect run example usage. 2016-11-21 06:55:03 -05:00
akki 74ed20b49a Replaced "django" with "Django" in spelling_wordlist. 2016-11-15 17:00:50 -05:00
za 321e94fa41 Refs #27392 -- Removed "Tests that", "Ensures that", etc. from test docstrings. 2016-11-10 21:30:21 -05:00
Tim Graham b741fe397a Updated "fork Django on GitHub" link. 2016-11-04 05:47:49 +01:00
Tim Graham 414ad25b09 Fixed #27327 -- Simplified time zone handling by requiring pytz. 2016-10-27 08:53:20 -04:00
Tim Graham d84ffcc22b Updated "running the tests" to use 'pip install -e'. 2016-10-27 08:18:56 -04:00
Julian Andrews adc93e8599 Fixed #26357 -- Allowed admin popups to work on links added after page load. 2016-10-24 20:17:31 -04:00
Tim Graham e261337eea Fixed docs typos in lines ending with a dash. 2016-10-06 11:01:20 -04:00
Tim Graham ddef397b0d Doc'd how to use GitHub's "Squash and merge" button. 2016-09-21 12:13:21 -04:00
an0o0nym 2b759c94c5 Fixed #26952 -- Added tips for installing test suite dependencies. 2016-08-09 18:37:09 -04:00
Adam Zapletal 4f113483d7 Fixed a few grammar issues in working-with-git doc. 2016-08-06 08:11:48 -04:00
Tobias McNulty 09d38746ba Fixed #22446 -- Added tox.ini to automate pull request checks. 2016-07-20 14:06:28 -04:00
Jiang Haiyun 10883b63b7 Fixed typo in docs/internals/contributing/writing-code/coding-style.txt 2016-07-13 10:15:39 -04:00
shaunagm 44c7e5d374 Fixed #26701 -- Replaced /newticket links to Trac with /. 2016-06-03 08:48:12 -04:00
Tim Graham abc5223834 Added a ticket tracker link in docs/internals/contributing/bugs-and-features.txt 2016-06-02 16:03:29 -04:00
Philip James 2c90981c5f Fixed #26699 -- Mentioned doc theming difference (locally-built vs. website). 2016-06-02 14:06:56 -04:00
Tim Graham 46a38307c2 Removed versionadded/changed annotations for 1.9. 2016-05-20 11:44:29 -04:00
Tim Graham 2e1d44e46d Fixed #26637 -- Removed obsolete note in docs/internals/contributing/writing-documentation.txt 2016-05-19 09:11:56 -04:00
Bas Westerbaan a5033dbc58 Refs #26033 -- Added password hasher support for Argon2 v1.3. 
The previous version of Argon2 uses encoded hashes of the form:
   $argon2d$m=8,t=1,p=1$<salt>$<data>

The new version of Argon2 adds its version into the hash:
   $argon2d$v=19$m=8,t=1,p=1$<salt>$<data>

This lets Django handle both version properly.
 2016-04-25 21:17:53 -04:00
krishbharadwaj 361cb7a857 Fixed #26448 -- Added details for running tests with a different database backend. 2016-04-05 21:34:26 -04:00
Amine 8b5a4fa941 Fixed a broken link in docs/internals/contributing/writing-documentation.txt. 2016-03-19 16:19:01 -04:00
Tim Graham 460dab0b40 Removed obsolete section on "Improving the documentation". 2016-03-15 19:05:54 -04:00
Akshesh 44c0ecdd92 Fixed #25364 -- Added generic way to test on all browsers supported by selenium. 
Browser names should be passed as a comma separated list to the --selenium flag.

Thanks Tim Graham, Simon Charette and Moritz Sichert for review and discussion.
 2016-03-15 13:10:32 -04:00
Bas Westerbaan b4250ea04a Fixed #26033 -- Added Argon2 password hasher. 2016-03-08 11:22:18 -05:00
Tim Graham e19fc9f08a Removed claim that you can use different database backends for Django's tests. 
Such as a setup isn't tested through continuous integration and therefore
isn't likely to work reliably.
 2016-03-05 08:42:18 -05:00
Akshesh 6670da75ff Fixed #25653 -- Made --selenium run only the selenium tests. 2016-02-19 14:21:00 -05:00
Elif T. Kus bca9faae95 Fixed #26020 -- Normalized header stylings in docs. 2016-01-22 12:12:17 -05:00
Tim Graham e519aab43a Fixed #23868 -- Added support for non-unique django-admin-options in docs. 
Also documented missing short command line options to fix #24134. This bumps
the minimum sphinx version required to build the docs to 1.3.4.

Thanks Simon Charette for review.
 2016-01-14 18:21:33 -05:00
pp b34ff66e5b Added missing period to "etc.". 2016-01-11 18:05:15 -05:00
Varun Sharma 3d6474e1a5 Fixed #25385 -- Allowed importing views.generic.View from views.View. 2016-01-11 08:18:44 -05:00
Simon Charette 7bb373e309 Refs #25746 -- Added a test utility to isolate inlined model registration. 
Thanks to Tim for the review.
 2016-01-06 20:00:07 -05:00
Marten Kenbeek 16411b8400 Fixed #26013 -- Moved django.core.urlresolvers to django.urls. 
Thanks to Tim Graham for the review.
 2015-12-31 14:21:29 -05:00
Tim Graham df3d5b1d73 Fixed #26003 -- Added "how the documentation is organized" sections. 
Thanks Daniele Procida for coauthoring.
 2015-12-31 11:35:00 -05:00
Tim Graham 77f50c9cfc Fixed #25948 -- Added guidelines for SimpleTestCase.assertRaisesMessage() usage. 2015-12-23 07:29:06 -05:00
Jon Dufresne 7aabd62380 Fixed #25778 -- Updated docs links to use https when available. 2015-12-01 08:01:34 -05:00
Andrei Fokau 998894e1b9 Fixed #25764 -- Added support for serialization of enum.Enum in migrations. 
Thanks Tim Graham for the review.
 2015-11-19 17:21:12 -05:00
Tim Graham 101dbeb673 Corrected outdated information in submitting patches guide. 2015-11-16 09:59:56 -05:00
Tim Graham 21c82646fe Documented how to see the full traceback of a test failure. 2015-11-16 09:12:26 -05:00
Agnieszka Lasyk 1f8dad6915 Fixed #25755 -- Unified spelling of "website". 2015-11-16 06:44:14 -05:00
Curtis Maloney 35440ceab7 Optimized docs images and documented the process. 2015-10-24 14:57:21 -04:00
Yusuke Miyazaki 230d8c7301 Fixed #25578 -- Corrected the casing of "GitHub". 2015-10-21 07:31:11 -04:00
Tim Graham 54848a96dd Removed versionadded/changed annotations for 1.8. 2015-09-23 19:31:11 -04:00
David Gibbons 91e3d1215b Updated docs coverage example to run in a single process. 2015-09-16 08:20:29 -04:00
Aymeric Augustin 33c7c2a557 Enabled parallel testing by default in runtests.py. 2015-09-10 13:34:05 +02:00
Aymeric Augustin 6d1110f2f0 Updated references to the TEST_* database settings. 
They were removed in Django 1.9.

I could leave the reference to TEST_DEPENDENCIES in the 1.2.4 release
notes because the link points to the right location and the name was
accurate at the time.
 2015-09-05 19:21:22 +02:00
Aymeric Augustin 0eb846605e Recommend relative imports within Django components. 
django-developers thread:
https://groups.google.com/d/msg/django-developers/11XvmVdx58w/sFrF0pL8LTgJ
 2015-08-22 19:58:44 +02:00
Claude Paroz e9c5c39631 Updated various links in docs 2015-08-08 13:57:15 +02:00
Claude Paroz 18f3d4c1bd Updated Transifex links in docs 2015-08-08 11:33:28 +02:00
Flavio Curella 7f0953ce1f Fixed #25184 -- Added support for MaxMind GeoLite2 database format 2015-07-31 09:45:03 -04:00
Tim Graham adffff79a3 Allowed installing closure with pip for admin JavaScript compression. 2015-07-17 13:22:34 -04:00
Tim Graham 074706c64d Added a link to running the unit tests to new contributors page. 2015-07-10 11:02:25 -04:00
Tim Graham 0e3193a386 Updated mock note since Django no longer works with Python 3.2. 2015-07-03 08:24:58 -04:00
Tim Graham ca58181bac Fixed #25056 -- Documented minimum version of jinja2 for testing. 2015-07-03 08:20:53 -04:00
Trey Hunner 2d0dead224 DEP 0003 -- Added JavaScript unit tests. 
Setup QUnit, added tests, and measured test coverage.

Thanks to Nick Sanford for the initial tests.
 2015-06-30 21:04:16 -04:00
Trey Hunner ec4f219ecb Fixed #22463 -- Added code style guide and JavaScript linting (EditorConfig and ESLint) 2015-06-27 16:36:26 -04:00
Tim Graham aed437d567 Updated release process for new release schedule. 2015-06-25 11:36:17 -04:00
Tim Graham 7f1168e387 Removed support for Python 3.3. 2015-06-18 08:36:50 -04:00
Tim Graham ccfb5c7408 Removed obsolete literals_to_xrefs.py script. 2015-06-15 10:22:18 -04:00
Tim Graham 2fbea621e6 Capitalized "Python" in docs. 2015-06-05 08:24:53 -04:00
Steadman dfdcb3ca22 Improved wording in writing documentation docs. 2015-06-04 11:58:32 +01:00
Dave Hodder 08c980d752 Updated capitalization in the word "JavaScript" for consistency 2015-05-01 13:26:42 -04:00
Carolina 118cae2df8 Fixed #23666 -- Recommended Git Bash for running unit tests on Windows. 2015-03-24 10:45:58 -04:00
Erik Romijn f66c2bdc0f Fixed #23903 -- Configured Sphinx to autogenerate django-admin manpage 2015-03-10 08:12:09 -04:00
Sean Wang eba6dff581 Fixed #24358 -- Corrected code-block directives for console sessions. 2015-02-22 09:35:39 -05:00
Tim Graham d28bcba209 Fixed typo in docs/internals/contributing/triaging-tickets.txt 2015-02-20 07:26:16 -05:00
Tim Graham dbacbc729a Simplified and updated committing code guidelines. 2015-02-19 20:36:24 -05:00
Tim Graham 0adf766e16 Fixed #23811 -- Added a guide for using git bisect. 2015-02-19 20:18:52 -05:00
Tim Graham 7cf3a5786b Updated docs and runtests.py for removal of tests from contrib. 2015-02-11 10:29:54 -05:00
Tim Graham a3473454ad Updated docs on running selenium tests. 2015-02-10 12:30:28 -05:00
Tim Graham 6704b52980 Fixed #24269 -- Added docs about the process of managing translations in Django. 2015-02-09 13:07:45 -05:00
Peter Inglesby a8f1c70dce Fixed docs typo 2015-02-07 18:46:04 +01:00
wrwrwr cd155c7c71 Fixed #23860 -- Documented import order convention. 2015-02-06 14:48:56 -05:00
Riccardo Magliocchetti 9410d69835 Added cross references to contributing docs. 2015-02-05 10:40:46 -05:00
darkryder 9ec8aa5e5d Fixed #24149 -- Normalized tuple settings to lists. 2015-02-03 14:59:45 -05:00
Tim Graham c79faae761 Removed versionadded/changed notes for 1.7. 2015-02-01 21:02:40 -05:00
Tim Graham 63412262e5 Fixed #24175 -- Updated docstring convention. 2015-01-29 12:21:44 -05:00
Marc Tamlyn b5c1a85b50 Fixed #24118 -- Added --debug-sql option for tests. 
Added a --debug-sql option for tests and runtests.py which outputs the
SQL logger for failing tests. When combined with --verbosity=2, it also
outputs the SQL for passing tests.

Thanks to Berker, Tim, Markus, Shai, Josh and Anssi for review and
discussion.
 2015-01-12 08:16:08 +00:00
Tim Graham 7102b99653 Added best practices for versionadded/changed annotations. 2015-01-09 13:23:29 -05:00
Claude Paroz 66f9a74b45 Added ignore_warnings decorator 
And removed Ignore*DeprecationWarningsMixin, now obsolete.
Thanks Berker Peksag and Tim Graham for the review.
 2014-12-30 18:16:25 +01:00
Tim Graham 6571ed14b6 Fixed #24049 -- Removed obsolete Java notes for Mac OS. 2014-12-24 18:38:07 -05:00
Tim Graham 82e4f956e3 Fixed #23289 -- Added mock as a test dependency. 2014-12-01 16:08:25 -05:00
Tim Graham 3131e9cef5 Fixed #23923 -- Promoted Django's deprecation warnings to errors in runtests.py 2014-11-29 10:27:04 -05:00
wrwrwr e22c64dfc0 Fixed #23742 -- Added an option to reverse tests order. 
This is useful for debugging side effects affecting tests that
are usually executed before a given test. Full suite and pair
tests sort cases more or less deterministically, thus some test
cross-dependencies are easier to reveal by reversing the order.

Thanks Preston Timmons for the review.
 2014-11-24 19:24:11 -05:00
wrwrwr ca801b8c8f Improved line breaking in runtests docs. 2014-11-24 17:38:28 -05:00
Erik Romijn de912495ab Added reminder to committing docs to test a PR with Jenkins first. 2014-11-16 13:32:40 +01:00
wrwrwr f9213a85c3 Fixed #23775 -- Added docs for --bisect and --pair runtests options. 
Thanks Baptiste Mispelon for review.
 2014-11-12 20:46:34 +01:00
Berker Peksag 22c85bf1a8 Fixed versionchanged indentation in unit-tests.txt. 2014-10-23 08:03:41 -04:00
Berker Peksag 303a848631 Fixed IRC channel name in submitting-patches.txt. 
The development channel is #django-dev.
 2014-10-16 16:56:37 +03:00
Corey Farwell 37b13033c6 Removed sudo from pip commands in docs. 2014-09-22 15:49:48 -04:00
Tim Graham 1101467ce0 Limited lines to 119 characters in django/ 
refs #23395.
 2014-09-05 09:22:16 -04:00
Erik Romijn 2154004802 Fixed tiny commit style inconsistency in committing code documentation. 2014-08-27 09:18:56 +02:00
Duncan Parkes 905c4fdcc3 Fixed clone URL of Django git repository. 2014-08-26 20:48:12 -04:00
Tim Graham fca677fa43 Added sphinx extension to ease generation of ticket links. 2014-08-19 17:40:50 -04:00
Tim Graham 0efd72dc90 Fixed broken links in docs. 2014-08-05 08:23:34 -04:00
Aymeric Augustin a4ead67ee9 Adjusted 'internals' docs to the new organization. 
Most of these changes are about using the correct vocabulary -- "core
team member" vs "core developer/committer" and adding internal links.
 2014-08-01 14:41:25 +02:00
Aymeric Augustin dd9c8f9382 Left formal decisions up to the technical board. 
As the core team grows towards 50 people, it isn't reasonable to give
everyone veto rights anymore.
 2014-08-01 14:41:24 +02:00
Aymeric Augustin 4a475ce1c8 Introduced a technical board. 
Extended the scope of the core team a bit (depending on your current
perspective on that scope).
 2014-08-01 14:41:24 +02:00
Aymeric Augustin e9fde1c7ec Removed references to partial commit acces. 2014-08-01 14:41:24 +02:00
Aymeric Augustin 5ad48a9ef2 Renamed "committers" to "team". 2014-08-01 14:41:24 +02:00
Petras Zdanavičius 5a311d2ccc Fixed #23103 -- Added contributing tutorial link to contributing index. 2014-07-26 09:50:05 -04:00
Iain Dawson 8fbf13a6c8 Replaced instances of 'his/her' with 'their'. 2014-07-21 19:49:12 +00:00
Tim Graham dd6ef3197a Fixed #23015 -- Fixed major/minor release terminology in docs. 2014-07-13 13:37:56 -04:00
Tim Graham 1a3bec4a26 Fixed #18108 -- Added instructions for translating documentation. 
Thanks Claude Paroz.
 2014-07-02 13:16:31 -04:00
Tim Graham bcc3d2b978 Fixed #22818 -- Clarified you need to cd into the Django clone. 
Thanks Josh Parris.
 2014-06-12 10:19:03 -04:00
Tim Graham 61960dd02c Added a patch review checklist. 2014-06-03 11:55:17 -04:00
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
Claude Paroz 7c24027bad Renamed Transifex project from django-core to django 
See also http://blog.transifex.com/post/83622601443/new-teams-management-transifex
 2014-04-24 11:38:18 +02:00
Marti Raudsepp 11d453bcad Various documentation typo/spelling fixes 
Errors detected by Topy (https://github.com/intgr/topy), all changes
verified by hand.
 2014-04-23 02:31:49 +03:00
Tim Graham 47927eb786 Revert "Fixed #22401 -- Deprecated regular expression parsing of initial SQL in favor of installing sqlparse." 
This reverts commit 071c933775.

This introduced a regression on MySQL and custom SQL is deprecated.
 2014-04-16 21:03:22 -04:00
Jordi Yeh 2810299117 Fixed #22457 -- Fixed contributing guide w/o github set-up 
The published commnand was not working when the user did not have
the git client set-up with the public-key. Changed the contributing
guide to clone it from https instead.
 2014-04-16 09:33:53 -04:00
julien 'pouete' Godin 071c933775 Fixed #22401 -- Deprecated regular expression parsing of initial SQL in favor of installing sqlparse. 2014-04-09 19:25:07 -04:00
Anubhav Joshi 0399523cf1 Fixed #22253 -- Added django-i18n to the mailing lists docs. 
Thanks bmispelon for the suggestion.
 2014-03-19 07:22:01 -04:00
Anubhav Joshi abade6413b Fixed #21991 -- Added warning regarding tests failure if locales not installed. 
Thanks reidrac for the report.
 2014-03-16 14:34:18 -04:00
Claude Paroz 210d0489c5 Fixed #21188 -- Introduced subclasses for to-be-removed-in-django-XX warnings 
Thanks Anssi Kääriäinen for the idea and Simon Charette for the
review.
 2014-03-08 09:57:40 +01:00
Szczepan Cieślik a0f2525202 Fixed #22141 -- Added a spelling checker for documentation. 2014-03-07 09:29:23 -05:00
Rodolfo Carvalho 2b6436e2d5 Fixed some typos and formatting issues in docs. 2014-03-03 08:37:17 -05:00
Tim Graham 1f5f015c32 Fixed spelling mistakes in docs. 2014-02-28 21:03:46 -05:00
Tim Graham 7f2505ad9e Fixed doc typos. 2014-02-28 11:44:03 -05:00
Martin Matusiak d399731bf2 Fixed #22007 -- Fixed cbv docs - make imports consistent 
Thanks to trac user kinjal.dixit for the report.
 2014-02-22 14:39:09 +01:00
Adrian Holovaty 660b7e7000 Removed BDFL stuff from docs/internals/contributing/bugs-and-features.txt 2014-01-13 10:32:09 -06:00
Tim Graham 9953e98e6a Fixed #21701 -- Improved testing doc titles and added testing/tools.txt. 
Thanks cjerdonek for the suggestion.
 2013-12-31 08:14:09 -05:00
Yaroslav Halchenko 80027d2c38 Unified listing of shell commands/code 
- use code-block:: bash
- prefix the command with $
 2013-12-25 15:19:14 -05:00
Aymeric Augustin 9b8192ce51 Updated a few doc paragraphs following the app-loading refactor. 2013-12-24 17:20:11 +01:00
Bouke Haarsma bed52afee7 Removed usage of to-be-deprecated ADMIN_FOR setting in contributing docs 2013-12-14 16:49:25 +01:00
Simon Charette c047dda057 Removed an erroneous leading slash introduced by a626bdf648a. 2013-12-08 13:18:53 -05:00
Claude Paroz 626bdf648a Updated a bunch of hyperlinks in documentation 2013-12-08 18:40:09 +01:00
Alasdair Nicol c75dd664cf Fixed #21538 -- Added numpy to test/requirements/base.txt 
Thanks Tim Graham for the report
 2013-12-02 13:37:59 -05:00
Alex Gaynor c0a2daad78 Documented the house style for gender neutral pronouns. 2013-11-30 08:31:58 -05:00
Cody Scott 4a54b69e88 Fixed sentence structure in docs/internals/contributing/triaging-tickets.txt 2013-11-22 09:07:10 -05:00
Tim Graham 98de90d3d8 Fixed spelling of compatibility. 2013-11-09 10:17:17 -05:00
Tim Graham 14c1872d29 Recommended flake8 to check coding style. 2013-11-09 06:39:55 -05:00
Claude Paroz e953c78eeb Fixed #16969 -- Don't connect to named database when possible 
Thanks Andreas Pelme for the report and initial patch, and
Aymeric Augustin, Shai Berger and Tim Graham for the reviews.
 2013-11-09 09:42:17 +01:00
Tim Graham c573d6de17 Fixed #19941 -- Removed sys.path hack when running the test suite. 
Thanks jezdez for the suggestion.
 2013-10-23 18:27:06 -04:00
Tim Graham 1dae4ac177 Whitespace cleanup. 
* Removed trailing whitespace.
* Added newline to EOF if missing.
* Removed blank lines at EOF.
* Removed some stray tabs.
 2013-10-10 16:49:20 -04:00
Tim Graham 9700194195 Fixed #21222 - Documented that 'default' and 'other' must be different databases when running tests. 
Thanks vernondcole for the suggestion.
 2013-10-09 11:42:27 -04:00
Unai Zalakain 3895d8899d Fixed #21213 -- Added docs for Django's mailing lists. 
Added docs/internals/mailing-lists.txt documenting the use of django's
mailing lists. All references across docs changed to point to this page.

The referencing makes use of substitution because there's no way to make
a :ref: link in a non-inline fashion in Sphinx. It also makes use of
rst_epilog Sphinx conf for making this substitutions across all the
docs.
 2013-10-04 10:00:36 -04:00