Changeset 7999

Timestamp:

07/19/08 17:26:46 (4 months ago)

Author:

mtredinnick

Message:

Added a cavaet to the use of get_FOO_filename() and get_FOO_url(). This
constraint has always existed, but it's very hard to fix in the current code,
so better to work around it for now.

Refs #5619

Files:

• django/trunk/docs/db-api.txt (modified) (2 diffs)

django/trunk/docs/db-api.txt

@@ -2281 +2281 @@
-to the file, according to your ``MEDIA_ROOT`` setting.
-
+.. note::
+    If you are using the ``upload_to`` parameter in your ``FileField``, it is
+    only valid to call this method **after** saving the model when the field
+    has been set. Prior to saving, the value returned will not contain the
+    upload directory in the path.
+
-Note that ``ImageField`` is technically a subclass of ``FileField``, so every
-model with an ``ImageField`` will also get this method.
@@ -2291 +2297 @@
-according to your ``MEDIA_URL`` setting. If the value is blank, this method
-returns an empty string.
+
+.. note::
+    As with ``get_FOO_filename()``, if you are using the ``upload_to``
+    parameter on your ``FileField``, it is only valid to call this method
+    **after** saving the model, otherwise an incorrect result will be
+    returned.
-
-get_FOO_size()