Bump version to 1.0.7.1 to distinguish from upstream release

[django-pagination.git] / docs / usage.txt

diff --git a/docs/usage.txt b/docs/usage.txt
index 9c97c51..bb819b5 100644 (file)
--- a/docs/usage.txt
+++ b/docs/usage.txt
@@ -1,7 +1,7 @@
-How to use django-pagination
+How to use linaro-django-pagination

 ----------------------------
 
 ----------------------------
 

-``django-pagination`` allows for easy Digg-style pagination without modifying
+``linaro-django-pagination`` allows for easy Digg-style pagination without modifying

 your views.
 
 There are really 5 steps to setting it up with your projects (not including 
 your views.
 
 There are really 5 steps to setting it up with your projects (not including 


@@ -70,10 +70,20 @@ That's it!  You have now paginated ``object_list`` and given users of the site
 a way to navigate between the different pages--all without touching your views.
 
 
 a way to navigate between the different pages--all without touching your views.
 
 

+A Note About Uploads
+--------------------
+
+It is important, when using linaro-django-pagination in conjunction with file uploads,
+to be aware of when ``request.page`` is accessed.  As soon as ``request.page``
+is accessed, ``request.upload_handlers`` is frozen and cannot be altered in any
+way.  It's a good idea to access the ``page`` attribute on the request object 
+as late as possible in your views.
+
+

 Optional Settings
 ------------------
 
 Optional Settings
 ------------------
 

-In django-pagination, there are no required settings.  There are, however, a
+In linaro-django-pagination, there are no required settings.  There are, however, a

 small set of optional settings useful for changing the default behavior of the
 pagination tags.  Here's an overview:
 
 small set of optional settings useful for changing the default behavior of the
 pagination tags.  Here's an overview: