mirror of https://github.com/django/django.git
Merge pull request #2602 from intgr/typofix
Various documentation typo/spelling fixes
This commit is contained in:
commit
c3152e5bcd
|
@ -310,7 +310,7 @@ Ramiro Morales
|
||||||
|
|
||||||
Honza Král
|
Honza Král
|
||||||
Honza first discovered Django in 2006 and started using it right away,
|
Honza first discovered Django in 2006 and started using it right away,
|
||||||
first for school and personal projects and later in his full time job. He
|
first for school and personal projects and later in his full-time job. He
|
||||||
contributed various patches and fixes mostly to the newforms library,
|
contributed various patches and fixes mostly to the newforms library,
|
||||||
newforms admin and, through participation in the Google Summer of Code
|
newforms admin and, through participation in the Google Summer of Code
|
||||||
project, assisted in creating the :ref:`model validation
|
project, assisted in creating the :ref:`model validation
|
||||||
|
@ -510,7 +510,7 @@ Marc Tamlyn
|
||||||
documentation at DjangoCon EU 2012, and also helped to develop `CCBV`_, an
|
documentation at DjangoCon EU 2012, and also helped to develop `CCBV`_, an
|
||||||
additional class based view reference tool.
|
additional class based view reference tool.
|
||||||
|
|
||||||
Marc is currently a full time parent, part time developer, and lives in
|
Marc is currently a full-time parent, part-time developer, and lives in
|
||||||
Oxford, UK.
|
Oxford, UK.
|
||||||
|
|
||||||
.. _CCBV: http://ccbv.co.uk/
|
.. _CCBV: http://ccbv.co.uk/
|
||||||
|
|
|
@ -206,7 +206,7 @@ Miscellaneous
|
||||||
|
|
||||||
* Remove ``import`` statements that are no longer used when you change code.
|
* Remove ``import`` statements that are no longer used when you change code.
|
||||||
`flake8`_ will identify these imports for you. If an unused import needs to
|
`flake8`_ will identify these imports for you. If an unused import needs to
|
||||||
remain for backwards-compatibility, mark the end of of with ``# NOQA`` to
|
remain for backwards-compatibility, mark the end of with ``# NOQA`` to
|
||||||
silence the flake8 warning.
|
silence the flake8 warning.
|
||||||
|
|
||||||
* Systematically remove all trailing whitespaces from your code as those
|
* Systematically remove all trailing whitespaces from your code as those
|
||||||
|
|
|
@ -205,7 +205,7 @@ Our policy for new features is:
|
||||||
release, not the development version.
|
release, not the development version.
|
||||||
|
|
||||||
Our preferred way for marking new features is by prefacing the features'
|
Our preferred way for marking new features is by prefacing the features'
|
||||||
documentation with: "``.. versionadded:: X.Y``", followed by a a mandatory
|
documentation with: "``.. versionadded:: X.Y``", followed by a mandatory
|
||||||
blank line and an optional content (indented).
|
blank line and an optional content (indented).
|
||||||
|
|
||||||
General improvements, or other changes to the APIs that should be emphasized
|
General improvements, or other changes to the APIs that should be emphasized
|
||||||
|
|
|
@ -145,7 +145,7 @@ Handling errors in actions
|
||||||
|
|
||||||
If there are foreseeable error conditions that may occur while running your
|
If there are foreseeable error conditions that may occur while running your
|
||||||
action, you should gracefully inform the user of the problem. This means
|
action, you should gracefully inform the user of the problem. This means
|
||||||
handling exceptions and and using
|
handling exceptions and using
|
||||||
:meth:`django.contrib.admin.ModelAdmin.message_user` to display a user friendly
|
:meth:`django.contrib.admin.ModelAdmin.message_user` to display a user friendly
|
||||||
description of the problem in the response.
|
description of the problem in the response.
|
||||||
|
|
||||||
|
|
|
@ -106,7 +106,7 @@ respectively).
|
||||||
in the :doc:`sessions documentation </topics/http/sessions>` on
|
in the :doc:`sessions documentation </topics/http/sessions>` on
|
||||||
how to enable sessions.
|
how to enable sessions.
|
||||||
|
|
||||||
We will use the :class:`SessionWizardView` in all examples but is is completely
|
We will use the :class:`SessionWizardView` in all examples but is completely
|
||||||
fine to use the :class:`CookieWizardView` instead. As with your
|
fine to use the :class:`CookieWizardView` instead. As with your
|
||||||
:class:`~django.forms.Form` classes, this :class:`WizardView` class can live
|
:class:`~django.forms.Form` classes, this :class:`WizardView` class can live
|
||||||
anywhere in your codebase, but convention is to put it in :file:`views.py`.
|
anywhere in your codebase, but convention is to put it in :file:`views.py`.
|
||||||
|
|
|
@ -739,7 +739,7 @@ systems and coordinate transformation::
|
||||||
.. attribute:: z
|
.. attribute:: z
|
||||||
|
|
||||||
Returns the Z coordinate of this point, or ``None`` if the
|
Returns the Z coordinate of this point, or ``None`` if the
|
||||||
the point does not have a Z coordinate::
|
point does not have a Z coordinate::
|
||||||
|
|
||||||
>>> OGRGeometry('POINT (1 2 3)').z
|
>>> OGRGeometry('POINT (1 2 3)').z
|
||||||
3.0
|
3.0
|
||||||
|
|
|
@ -880,7 +880,7 @@ Returns WKB of the geometry in hexadecimal. Example::
|
||||||
|
|
||||||
.. attribute:: WKBWriter.byteorder
|
.. attribute:: WKBWriter.byteorder
|
||||||
|
|
||||||
This property may be be set to change the byte-order of the geometry
|
This property may be set to change the byte-order of the geometry
|
||||||
representation.
|
representation.
|
||||||
|
|
||||||
=============== =================================================
|
=============== =================================================
|
||||||
|
|
|
@ -768,7 +768,7 @@ Threaded option
|
||||||
----------------
|
----------------
|
||||||
|
|
||||||
If you plan to run Django in a multithreaded environment (e.g. Apache using the
|
If you plan to run Django in a multithreaded environment (e.g. Apache using the
|
||||||
the default MPM module on any modern operating system), then you **must** set
|
default MPM module on any modern operating system), then you **must** set
|
||||||
the ``threaded`` option of your Oracle database configuration to True::
|
the ``threaded`` option of your Oracle database configuration to True::
|
||||||
|
|
||||||
'OPTIONS': {
|
'OPTIONS': {
|
||||||
|
|
|
@ -174,7 +174,7 @@ RunSQL
|
||||||
|
|
||||||
RunSQL(sql, reverse_sql=None, state_operations=None, multiple=False)
|
RunSQL(sql, reverse_sql=None, state_operations=None, multiple=False)
|
||||||
|
|
||||||
Allows runnning of arbitrary SQL on the database - useful for more advanced
|
Allows running of arbitrary SQL on the database - useful for more advanced
|
||||||
features of database backends that Django doesn't support directly, like
|
features of database backends that Django doesn't support directly, like
|
||||||
partial indexes.
|
partial indexes.
|
||||||
|
|
||||||
|
|
|
@ -1016,7 +1016,7 @@ For a complete discussion on the usage of the following see the
|
||||||
current point in time. Exactly what's returned depends on the value of
|
current point in time. Exactly what's returned depends on the value of
|
||||||
:setting:`USE_TZ`:
|
:setting:`USE_TZ`:
|
||||||
|
|
||||||
* If :setting:`USE_TZ` is ``False``, this will be be a
|
* If :setting:`USE_TZ` is ``False``, this will be a
|
||||||
:ref:`naive <naive_vs_aware_datetimes>` datetime (i.e. a datetime
|
:ref:`naive <naive_vs_aware_datetimes>` datetime (i.e. a datetime
|
||||||
without an associated timezone) that represents the current time
|
without an associated timezone) that represents the current time
|
||||||
in the system's local timezone.
|
in the system's local timezone.
|
||||||
|
|
|
@ -77,7 +77,7 @@ handlers have been refactored to allow finer-grained control over the
|
||||||
uploading process as well as streaming uploads of large files.
|
uploading process as well as streaming uploads of large files.
|
||||||
|
|
||||||
Along with these improvements and additions, we've made a number of
|
Along with these improvements and additions, we've made a number of
|
||||||
of backwards-incompatible changes to the framework, as features have been
|
backwards-incompatible changes to the framework, as features have been
|
||||||
fleshed out and APIs have been finalized for the 1.0 release. A
|
fleshed out and APIs have been finalized for the 1.0 release. A
|
||||||
complete guide to these changes will be available as part of the final
|
complete guide to these changes will be available as part of the final
|
||||||
Django 1.0 release, and a comprehensive list of backwards-incompatible
|
Django 1.0 release, and a comprehensive list of backwards-incompatible
|
||||||
|
|
|
@ -50,7 +50,7 @@ Following this change, all platforms, regardless of word size, will generate a
|
||||||
|
|
||||||
As a result of this change, you will not be able to use the ``reset``
|
As a result of this change, you will not be able to use the ``reset``
|
||||||
management command on any table made by a 64-bit machine. This is because the
|
management command on any table made by a 64-bit machine. This is because the
|
||||||
the new generated name will not match the historically generated name; as a
|
new generated name will not match the historically generated name; as a
|
||||||
result, the SQL constructed by the reset command will be invalid.
|
result, the SQL constructed by the reset command will be invalid.
|
||||||
|
|
||||||
If you need to reset an application that was created with 64-bit constraints,
|
If you need to reset an application that was created with 64-bit constraints,
|
||||||
|
|
|
@ -520,7 +520,7 @@ Added ``readonly_fields`` to ``ModelAdmin``
|
||||||
|
|
||||||
:attr:`django.contrib.admin.ModelAdmin.readonly_fields` has been added to
|
:attr:`django.contrib.admin.ModelAdmin.readonly_fields` has been added to
|
||||||
enable non-editable fields in add/change pages for models and inlines. Field
|
enable non-editable fields in add/change pages for models and inlines. Field
|
||||||
and calculated values can be displayed along side editable fields.
|
and calculated values can be displayed alongside editable fields.
|
||||||
|
|
||||||
Customizable syntax highlighting
|
Customizable syntax highlighting
|
||||||
--------------------------------
|
--------------------------------
|
||||||
|
|
|
@ -10,5 +10,5 @@ Bugfixes
|
||||||
========
|
========
|
||||||
|
|
||||||
* Added backwards compatibility support for the :mod:`django.contrib.messages`
|
* Added backwards compatibility support for the :mod:`django.contrib.messages`
|
||||||
cookie format of Django 1.4 and earlier to faciliate upgrading to 1.6 from
|
cookie format of Django 1.4 and earlier to facilitate upgrading to 1.6 from
|
||||||
1.4 (`#22426 <http://code.djangoproject.com/ticket/22426>`_).
|
1.4 (`#22426 <http://code.djangoproject.com/ticket/22426>`_).
|
||||||
|
|
|
@ -508,7 +508,6 @@ roadmap
|
||||||
Roald
|
Roald
|
||||||
rss
|
rss
|
||||||
runfcgi
|
runfcgi
|
||||||
runnning
|
|
||||||
runserver
|
runserver
|
||||||
safeseq
|
safeseq
|
||||||
Sandvik
|
Sandvik
|
||||||
|
|
|
@ -96,7 +96,7 @@ The standard pattern for processing a form in a view looks like this:
|
||||||
|
|
||||||
def contact(request):
|
def contact(request):
|
||||||
if request.method == 'POST': # If the form has been submitted...
|
if request.method == 'POST': # If the form has been submitted...
|
||||||
# ContactForm was defined in the the previous section
|
# ContactForm was defined in the previous section
|
||||||
form = ContactForm(request.POST) # A form bound to the POST data
|
form = ContactForm(request.POST) # A form bound to the POST data
|
||||||
if form.is_valid(): # All validation rules pass
|
if form.is_valid(): # All validation rules pass
|
||||||
# Process the data in form.cleaned_data
|
# Process the data in form.cleaned_data
|
||||||
|
|
|
@ -124,7 +124,7 @@ specified with Python's standard named-string interpolation syntax. Example::
|
||||||
This technique lets language-specific translations reorder the placeholder
|
This technique lets language-specific translations reorder the placeholder
|
||||||
text. For example, an English translation may be ``"Today is November 26."``,
|
text. For example, an English translation may be ``"Today is November 26."``,
|
||||||
while a Spanish translation may be ``"Hoy es 26 de Noviembre."`` -- with the
|
while a Spanish translation may be ``"Hoy es 26 de Noviembre."`` -- with the
|
||||||
the month and the day placeholders swapped.
|
month and the day placeholders swapped.
|
||||||
|
|
||||||
For this reason, you should use named-string interpolation (e.g., ``%(day)s``)
|
For this reason, you should use named-string interpolation (e.g., ``%(day)s``)
|
||||||
instead of positional interpolation (e.g., ``%s`` or ``%d``) whenever you
|
instead of positional interpolation (e.g., ``%s`` or ``%d``) whenever you
|
||||||
|
|
|
@ -51,7 +51,7 @@ The following is a simple unit test using the request factory::
|
||||||
# Create an instance of a GET request.
|
# Create an instance of a GET request.
|
||||||
request = self.factory.get('/customer/details')
|
request = self.factory.get('/customer/details')
|
||||||
|
|
||||||
# Recall that middleware are not suported. You can simulate a
|
# Recall that middleware are not supported. You can simulate a
|
||||||
# logged-in user by setting request.user manually.
|
# logged-in user by setting request.user manually.
|
||||||
request.user = self.user
|
request.user = self.user
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue