Ticket #16014: doc-patch.diff
File doc-patch.diff, 13.4 KB (added by , 14 years ago) |
---|
-
docs/intro/tutorial01.txt
593 593 Unicode string, and ``str(p)`` will return a normal string, with characters 594 594 encoded as UTF-8. 595 595 596 If all of this is jibberish to you, just remember to add596 If all of this is gibberish to you, just remember to add 597 597 :meth:`~django.db.models.Model.__unicode__` methods to your models. With any 598 598 luck, things should Just Work for you. 599 599 -
docs/internals/svn.txt
199 199 fixes, and shortly after the release of Django 1.1 the branch 200 200 ``django/branches/releases/1.1.X`` was created. 201 201 202 Prior to the Django 1.0 release, these branches were maintain d within202 Prior to the Django 1.0 release, these branches were maintained within 203 203 the top-level ``django/branches`` directory, and so the following 204 204 branches exist there and provided support for older Django releases: 205 205 -
docs/internals/contributing.txt
472 472 * Then, click the "Join this Team" button to become a member of this team. 473 473 Every team has at least one coordinator who is responsible to review 474 474 your membership request. You can of course also contact the team 475 coordinator to clarify procedu al problems and handle the actual475 coordinator to clarify procedural problems and handle the actual 476 476 translation process. 477 477 478 478 * Once you are a member of a team choose the translation resource you -
docs/internals/deprecation.txt
20 20 21 21 * 1.4 22 22 * ``CsrfResponseMiddleware``. This has been deprecated since the 1.2 23 release, in favo ur of the template tag method for inserting the CSRF23 release, in favor of the template tag method for inserting the CSRF 24 24 token. ``CsrfMiddleware``, which combines ``CsrfResponseMiddleware`` 25 25 and ``CsrfViewMiddleware``, is also deprecated. 26 26 … … 129 129 130 130 * The undocumented function 131 131 :func:`django.contrib.formtools.utils.security_hash` 132 is deprecated, in favo ur of :func:`django.contrib.formtools.utils.form_hmac`132 is deprecated, in favor of :func:`django.contrib.formtools.utils.form_hmac` 133 133 134 134 * The function-based generic views have been deprecated in 135 135 favor of their class-based cousins. The following modules … … 161 161 a :class:`~django.contrib.gis.geos.GEOSException` when called 162 162 on a geometry with no SRID value. 163 163 164 * :class:`~django.http.CompatCookie` will be removed in favo ur of164 * :class:`~django.http.CompatCookie` will be removed in favor of 165 165 :class:`~django.http.SimpleCookie`. 166 166 167 167 * :class:`django.core.context_processors.PermWrapper` and -
docs/howto/jython.txt
65 65 running on standard Python. However, are a few differences to keep in mind: 66 66 67 67 * Remember to use the ``jython`` command instead of ``python``. The 68 documentation uses ``python`` for consist ancy, but if you're using Jython68 documentation uses ``python`` for consistency, but if you're using Jython 69 69 you'll want to mentally replace ``python`` with ``jython`` every time it 70 70 occurs. 71 71 -
docs/howto/custom-template-tags.txt
894 894 .. admonition:: Variable scope in context 895 895 896 896 Any variable set in the context will only be available in the same ``block`` 897 of the template in which it was assigned. This behavio ur is intentional;897 of the template in which it was assigned. This behavior is intentional; 898 898 it provides a scope for variables so that they don't conflict with 899 899 context in other blocks. 900 900 -
docs/howto/custom-management-commands.txt
71 71 <poll_id>``. 72 72 73 73 The ``handle()`` method takes zero or more ``poll_ids`` and sets ``poll.opened`` 74 to ``False`` for each one. If the user referenced any nonexist ant polls, a74 to ``False`` for each one. If the user referenced any nonexistent polls, a 75 75 :class:`CommandError` is raised. The ``poll.opened`` attribute does not exist 76 76 in the :doc:`tutorial</intro/tutorial01>` and was added to 77 77 ``polls.models.Poll`` for this example. -
docs/howto/static-files.txt
137 137 directly in your templates. This means that a switch of static files servers 138 138 only requires changing that single value. Much better! 139 139 140 ``staticfiles`` in ludes two built-in ways of getting at this setting in your140 ``staticfiles`` includes two built-in ways of getting at this setting in your 141 141 templates: a context processor and a template tag. 142 142 143 143 With a context processor … … 170 170 every template. However, context processors require that you use 171 171 :class:`~django.template.RequestContext` when rendering templates. This happens 172 172 automatically if you're using a :doc:`generic view </ref/class-based-views>`, 173 but in views written by hand you'll need to explicit ally use ``RequestContext``173 but in views written by hand you'll need to explicitly use ``RequestContext`` 174 174 To see how that works, and to read more details, check out 175 175 :ref:`subclassing-context-requestcontext`. 176 176 … … 439 439 440 440 Once that's done, all you have to do is run :djadmin:`collectstatic` and your 441 441 static files would be pushed through your storage package up to S3. If you 442 later needed to swi ch to a different storage provider, it could be as simple442 later needed to switch to a different storage provider, it could be as simple 443 443 as changing your :setting:`STATICFILES_STORAGE` setting. 444 444 445 445 For details on how you'd write one of these backends, -
docs/howto/error-reporting.txt
44 44 .. versionadded:: 1.3 45 45 46 46 Server error emails are sent using the logging framework, so you can 47 customize this behavio ur by :doc:`customizing your logging configuration47 customize this behavior by :doc:`customizing your logging configuration 48 48 </topics/logging>`. 49 49 50 50 404 errors -
docs/topics/auth.txt
283 283 The :attr:`~django.contrib.auth.models.User.username` and 284 284 :attr:`~django.contrib.auth.models.User.password` are set as given. The 285 285 domain portion of :attr:`~django.contrib.auth.models.User.email` is 286 automatically conver ed to lowercase, and the returned286 automatically converted to lowercase, and the returned 287 287 :class:`~django.contrib.auth.models.User` object will have 288 288 :attr:`~models.User.is_active` set to ``True``. 289 289 … … 1244 1244 :ref:`model Meta attribute <meta-options>`. 1245 1245 1246 1246 This example Task model creates three custom permissions, i.e., actions users 1247 can or cannot do with Task instances, specific to your app ication::1247 can or cannot do with Task instances, specific to your application:: 1248 1248 1249 1249 class Task(models.Model): 1250 1250 ... -
docs/topics/http/shortcuts.txt
4 4 5 5 .. module:: django.shortcuts 6 6 :synopsis: 7 Conv ience shortcuts that spam multiple levels of Django's MVC stack.7 Convenience shortcuts that spam multiple levels of Django's MVC stack. 8 8 9 9 .. index:: shortcuts 10 10 -
docs/topics/cache.txt
615 615 :ref:`respect the active language<i18n-cache-key>`. For the ``cache`` template 616 616 tag you could use one of the 617 617 :ref:`translation-specific variables<template-translation-vars>` available in 618 templates to a rchieve the same result:618 templates to achieve the same result: 619 619 620 620 .. code-block:: html+django 621 621 … … 843 843 # Version 2 isn't available, either 844 844 >>> cache.get('my_key', version=2) 845 845 None 846 # But version 3 *is* avail ble846 # But version 3 *is* available 847 847 >>> cache.get('my_key', version=3) 848 848 'hello world!' 849 849 -
docs/topics/db/models.txt
188 188 189 189 :: 190 190 191 >>> p = Person(name="Fred Flin stone", gender="M")191 >>> p = Person(name="Fred Flintstone", gender="M") 192 192 >>> p.save() 193 193 >>> p.gender 194 194 u'M' … … 791 791 2. If you're subclassing an existing model (perhaps something from another 792 792 application entirely) and want each model to have its own database table, 793 793 :ref:`multi-table-inheritance` is the way to go. 794 3. Finally, if you only want to modify the Python-level behavio ur of a model,794 3. Finally, if you only want to modify the Python-level behavior of a model, 795 795 without changing the models fields in any way, you can use 796 796 :ref:`proxy-models`. 797 797 … … 1218 1218 from that base class. 1219 1219 1220 1220 Overriding fields in a parent model leads to difficulties in areas such as 1221 initiali sing new instances (specifying which field is being initialized in1221 initializing new instances (specifying which field is being initialized in 1222 1222 ``Model.__init__``) and serialization. These are features which normal Python 1223 1223 class inheritance doesn't have to deal with in quite the same way, so the 1224 1224 difference between Django model inheritance and Python class inheritance isn't -
docs/topics/db/aggregation.txt
233 233 publisher; the second query will only include good books in the annotated 234 234 count. In the first query, the annotation precedes the filter, so the 235 235 filter has no effect on the annotation. In the second query, the filter 236 prece eds the annotation, and as a result, the filter constrains the objects236 precedes the annotation, and as a result, the filter constrains the objects 237 237 considered when calculating the annotation. 238 238 239 239 ``order_by()`` -
docs/topics/class-based-views.txt
72 72 73 73 Then, we just need to add this new view into our URLconf. As the class-based 74 74 views themselves are classes, we point the URL to the as_view class method 75 instead, which is the entry point for class-based views::75 instead, which is the entry point for class-based views:: 76 76 77 77 # urls.py 78 78 from django.conf.urls.defaults import * -
docs/topics/testing.txt
95 95 96 96 import unittest 97 97 98 If you want to continue to use the base unittest lib ary, you can --98 If you want to continue to use the base unittest library, you can -- 99 99 you just won't get any of the nice new unittest2 features. 100 100 101 101 .. _unittest2: http://pypi.python.org/pypi/unittest2 -
docs/topics/logging.txt
156 156 some other way of organizing your logging messages, you can provide 157 157 any dot-separated name to identify your logger:: 158 158 159 # Get an instance of a spec fic named logger159 # Get an instance of a specific named logger 160 160 logger = logging.getLogger('project.interesting.stuff') 161 161 162 162 The dotted paths of logger names define a hierarchy. The -
docs/topics/signals.txt
106 106 Connecting receiver functions 107 107 ----------------------------- 108 108 109 There are two ways you can connect a recei ever to a signal. You can take the109 There are two ways you can connect a receiver to a signal. You can take the 110 110 manual connect route: 111 111 112 112 .. code-block:: python