diff --git a/docs/db-api.txt b/docs/db-api.txt index 9d167a69dab..ecd2a17e7a5 100644 --- a/docs/db-api.txt +++ b/docs/db-api.txt @@ -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.