encode/django-rest-framework
1
1
Fork 0
mirror of https://github.com/encode/django-rest-framework.git synced 2024-11-29 21:14:01 +03:00
Code Issues Packages Projects Releases Wiki Activity

Prominent notes on deprecation status of pagination settings. Closes #3173.

Browse Source
This commit is contained in:
Tom Christie 2015-07-22 12:36:32 +01:00
parent 7b21336872
commit f9c61e8090
1 changed files with 16 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
docs/api-guide/settings.md
View File

@ -119,6 +119,14 @@ Default: `None`
#### PAGINATE_BY_PARAM #### PAGINATE_BY_PARAM
---
**This setting is pending deprecation.**
See the pagination documentation for further guidance on [setting the pagination style](pagination.md#modifying-the-pagination-style).
---
The name of a query parameter, which can be used by the client to override the default page size to use for pagination. If set to `None`, clients may not override the default page size. The name of a query parameter, which can be used by the client to override the default page size to use for pagination. If set to `None`, clients may not override the default page size.
For example, given the following settings: For example, given the following settings:
@ -136,6 +144,14 @@ Default: `None`
#### MAX_PAGINATE_BY #### MAX_PAGINATE_BY
---
**This setting is pending deprecation.**
See the pagination documentation for further guidance on [setting the pagination style](pagination.md#modifying-the-pagination-style).
---
The maximum page size to allow when the page size is specified by the client. If set to `None`, then no maximum limit is applied. The maximum page size to allow when the page size is specified by the client. If set to `None`, then no maximum limit is applied.
For example, given the following settings: For example, given the following settings: