From 5bd6f8fe6262e709b070f0035b091633b4b50820 Mon Sep 17 00:00:00 2001 From: russellm Date: Tue, 22 Mar 2011 14:35:14 +0000 Subject: [PATCH] Minor markup and organization fixes to docs to correct Sphinx errors. git-svn-id: http://code.djangoproject.com/svn/django/trunk@15893 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/faq/general.txt | 2 ++ docs/glossary.txt | 7 +++++-- docs/releases/1.3.txt | 23 +++++++++++++---------- 3 files changed, 20 insertions(+), 12 deletions(-) diff --git a/docs/faq/general.txt b/docs/faq/general.txt index d83db681e6..6014b16788 100644 --- a/docs/faq/general.txt +++ b/docs/faq/general.txt @@ -78,6 +78,8 @@ Which sites use Django? .. _DjangoSites.org: http://djangosites.org +.. _faq-mtv: + Django appears to be a MVC framework, but you call the Controller the "view", and the View the "template". How come you don't use the standard names? ----------------------------------------------------------------------------------------------------------------------------------------------------- diff --git a/docs/glossary.txt b/docs/glossary.txt index b8f7a6b904..2761c794f3 100644 --- a/docs/glossary.txt +++ b/docs/glossary.txt @@ -24,11 +24,14 @@ Glossary See :doc:`/topics/db/models`. MTV - See :ref:`mtv`. + "Model-template-view"; a software pattern, similar in style to MVC, but + a better description of the way Django does things. + + See :ref:`the FAQ entry `. MVC `Model-view-controller`__; a software pattern. Django :ref:`follows MVC - to some extent `. + to some extent `. __ http://en.wikipedia.org/wiki/Model-view-controller diff --git a/docs/releases/1.3.txt b/docs/releases/1.3.txt index 16eb726bdd..944f3b9bb8 100644 --- a/docs/releases/1.3.txt +++ b/docs/releases/1.3.txt @@ -48,6 +48,7 @@ you'll need to make to handle them -- are documented in the list of .. _using Python's logging facilities: `Logging`_ .. _easy handling of static files: `Extended static files handling`_ .. _the unittest2 library: `unittest2 support`_ +.. _begins the deprecation process for some features: `deprecated-features-1.3`_ What's new in Django 1.3 ======================== @@ -103,7 +104,7 @@ for more details or learn how to :doc:`manage static files `. unittest2 support -~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~ Python 2.7 introduced some major changes to the ``unittest`` library, adding some extremely useful features. To ensure that every Django @@ -279,7 +280,7 @@ process has been on adding lots of smaller, long standing feature requests. These include: * Improved tools for accessing and manipulating the current ``Site`` - object in :ref:`the sites framework `. + object in :doc:`the sites framework `. * A :class:`~django.test.client.RequestFactory` for mocking requests in tests. @@ -324,10 +325,12 @@ CSRF validation now applies to AJAX requests Prior to Django 1.2.5, Django's CSRF-prevention system exempted AJAX requests from CSRF verification; due to `security issues`_ reported to us, however, *all* requests are now subjected to CSRF -verification. Consult :ref:`the Django CSRF documentation -` for details on how to handle CSRF verification in +verification. Consult :doc:`the Django CSRF documentation +` for details on how to handle CSRF verification in AJAX requests. +.. _security issues: http://www.djangoproject.com/weblog/2011/feb/08/security/ + Restricted filters in admin interface ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -450,15 +453,15 @@ Localflavor changes Django 1.3 introduces the following backwards-incompatible changes to local flavors: -* Indonesia (id) -- The province "Nanggroe Aceh Darussalam (NAD)" has - been removed from the province list in favor of the new official - designation "Aceh (ACE)". - * Canada (ca) -- The province "Newfoundland and Labrador" has had its province code updated to "NL", rather than the older "NF". In addition, the Yukon Territory has had its province code corrected to "YT", instead of "YK". +* Indonesia (id) -- The province "Nanggroe Aceh Darussalam (NAD)" has + been removed from the province list in favor of the new official + designation "Aceh (ACE)". + * United States of America (us) -- The list of "states" used by ``USStateField`` has expanded to include Armed Forces postal codes. This is backwards-incompatible if you were relying on @@ -615,8 +618,8 @@ transactions that are being managed using @transaction.commit_manually def my_view(request, name): - obj = get_object_or_404(MyObject, name__iexact=name) - return render_to_response('template', {'object':obj}) + obj = get_object_or_404(MyObject, name__iexact=name) + return render_to_response('template', {'object':obj}) Prior to Django 1.3, this would work without error. However, under Django 1.3, this will raise a :class:`TransactionManagementError` because