Commit 55ebc2b5 authored by Malcolm Tredinnick's avatar Malcolm Tredinnick
Browse files

Modified [7999] based on some feedback from Marty Alchin. 


git-svn-id: http://code.djangoproject.com/svn/django/trunk@8001 bcc190cf-cafb-0310-a4f2-bffc1f526a37
parent 44c329e1

docs/db-api.txt

+4 −6
Original line number Diff line number Diff line
@@ -2281,10 +2281,9 @@ where ``FOO`` is the name of the field. This returns the full filesystem path 
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.

    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 (the `upload_to` parameter) in the path.



Note that ``ImageField`` is technically a subclass of ``FileField``, so every

model with an ``ImageField`` will also get this method.
@@ -2298,8 +2297,7 @@ 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

    As with ``get_FOO_filename()``, it is only valid to call this method

    **after** saving the model, otherwise an incorrect result will be

    returned.