Changeset 4869 for django/branches/full-history/docs

Timestamp:

03/30/07 06:49:28 (2 years ago)

Author:

utrebec

Message:

[full-history]
svnmerge: merging in revision(s) 4816,4818-4823,4825-4835,4837,4844-4850,4856-4868 from "http://code.djangoproject.com/svn/django/trunk"

Files:

• django/branches/full-history (modified) (1 prop)
• django/branches/full-history/docs/add_ons.txt (modified) (2 diffs)
• django/branches/full-history/docs/cache.txt (modified) (1 diff)
• django/branches/full-history/docs/django-admin.txt (modified) (1 diff)
• django/branches/full-history/docs/modpython.txt (modified) (1 diff)
• django/branches/full-history/docs/newforms.txt (modified) (1 diff)
• django/branches/full-history/docs/release_notes_0.96.txt (modified) (1 diff)
• django/branches/full-history/docs/sessions.txt (modified) (1 diff)
• django/branches/full-history/docs/templates.txt (modified) (4 diffs)
• django/branches/full-history/docs/testing.txt (modified) (2 diffs)
• django/branches/full-history/docs/tutorial01.txt (modified) (5 diffs)
• django/branches/full-history/docs/webdesign.txt (copied) (copied from django/trunk/docs/webdesign.txt)

django/branches/full-history/docs/add_ons.txt

@@ -9 +9 @@
-This code lives in ``django/contrib`` in the Django distribution. Here's a
-rundown of the packages in ``contrib``:
+
+.. admonition:: Note
+
+    For most of these add-ons -- specifically, the add-ons that include either
+    models or template tags -- you'll need to add the package name (e.g.,
+    ``'django.contrib.admin'``) to your ``INSTALLED_APPS`` setting and re-run
+    ``manage.py syncdb``.
-
-.. _"batteries included" philosophy: http://docs.python.org/tut/node12.html#batteries-included
@@ -148 +155 @@
-======
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-.. _Textile: http://en.wikipedia.org/wiki/Textile_%28markup_language%29

django/branches/full-history/docs/cache.txt

@@ -67 +67 @@
-
-After installing Memcached itself, you'll need to install the Memcached Python
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-To use Memcached with Django, set ``CACHE_BACKEND`` to

django/branches/full-history/docs/django-admin.txt

@@ -343 +343 @@
-``<appname>/sql/<modelname>.sql``, where ``<appname>`` is the given appname and
-``<modelname>`` is the model's name in lowercase. For example, if you have an
-initialdata
+custom
-to read a file ``news/sql/story.sql`` and append it to the output of this
-command.

django/branches/full-history/docs/modpython.txt

@@ -38 +38 @@
-    </Location>
-
-
+
+
-
-This tells Apache: "Use mod_python for any URL at or under '/mysite/', using the

django/branches/full-history/docs/newforms.txt

@@ -861 +861 @@
-    <tr><th>Comment:</th><td><input type="text" name="comment" /></td></tr>
-
+Creating custom fields
+----------------------
+
+If the built-in ``Field`` classes don't meet your needs, you can easily create
+custom ``Field`` classes. To do this, just create a subclass of
+``django.newforms.Field``. Its only requirements are that it implement a
+``clean()`` method and that its ``__init__()`` method accept the core arguments
+mentioned above (``required``, ``label``, ``initial``, ``widget``,
+``help_text``).
+
-More coming soon
-================

django/branches/full-history/docs/release_notes_0.96.txt

@@ -63 +63 @@
-references have changed slightly. These names are generally only used
-when it is not possible to put the reference directly on the affected
-is
+are
-
-The effect of this change is that running ``manage.py reset`` and

django/branches/full-history/docs/sessions.txt

@@ -159 +159 @@
-
-    >>> from django.contrib.sessions.models import Session
-_object
+
-    >>> s.expire_date
-    datetime.datetime(2005, 8, 20, 13, 35, 12)

django/branches/full-history/docs/templates.txt

@@ -738 +738 @@
-            {% endfor %}
-        </ul>
+        </li>
-    {% endfor %}
-    </ul>
@@ -873 +874 @@
-which is rounded up to 88).
-
+with
+~~~~
+
+**New in Django development version**
+
+Caches a complex variable under a simpler name. This is useful when accessing
+an "expensive" method (e.g., one that hits the database) multiple times.
+
+For example::
+
+    {% with business.employees.count as total %}
+        {{ total }} employee{{ total|pluralize }}
+    {% endwith %}
+
+The populated variable (in the example above, ``total``) is only available
+between the ``{% with %}`` and ``{% endwith %}`` tags.
+
-Built-in filter reference
--------------------------
@@ -971 +989 @@
-    * ``36`` gets converted to ``36``
-
- 
+
-many decimal places.  For example:
-
@@ -984 +1002 @@
-    * ``36`` with floatformat:-4 gets converted to ``36``
-
- 
+
-an argument of ``-1``.
-

django/branches/full-history/docs/testing.txt

@@ -277 +277 @@
-                     full list of HTTP status codes.
-
-e
+is
-                     content as rendered by the view, or any error message
-                     (such as the URL for a 302 redirect).
@@ -469 +469 @@
-    FAILED (failures=1)
-
-
+
+
-
-Regardless of whether the tests pass or fail, the test database is destroyed when

django/branches/full-history/docs/tutorial01.txt

@@ -134 +134 @@
-database's connection parameters:
-
-
-More coming soon
+_psycopg2
+Other backends are `also available`_
-    * ``DATABASE_NAME`` -- The name of your database, or the full (absolute)
-      path to the database file if you're using SQLite.
@@ -144 +144 @@
-      (not used for SQLite).
-
+.. _also available: ../settings/
+
-.. admonition:: Note
-
@@ -320 +322 @@
-    python manage.py sql polls
-
-
+
+
-
-    BEGIN;
@@ -338 +341 @@
-Note the following:
-
+    * The exact output will vary depending on the database you are using.
+    
-    * Table names are automatically generated by combining the name of the app
-      (``polls``) and the lowercase name of the model -- ``poll`` and
@@ -366 +371 @@
-      construction of your models.
-
-
-
+
+
+
-
-    * ``python manage.py sqlclear polls`` -- Outputs the necessary ``DROP