Deprecate allow_sorting and allow_pagination options

[OpenStack Infra]

https://review.openstack.org/330482
Dear bug triager. This bug was created since a commit was marked with DOCIMPACT.
Your project "openstack/neutron" is set up so that we directly report the documentation bugs against it. If this needs changing, the docimpact-group option needs to be added for the project. You can ask the OpenStack infra team (#openstack-infra on freenode) for help if you need to.

commit fdf66024d38276f6eed111973127e1008ca68326
Author: Ihar Hrachyshka <email address hidden>
Date: Thu Jun 16 13:41:23 2016 +0200

    Deprecate allow_sorting and allow_pagination options

    There is no technical reason to disable sorting and pagination, except
    maybe performance concerns. But there are other ways to DoS-attack
    neutron-server services, like... any other type of request. So the
    concern is moot.

    Keeping those options available for configuration reduces compatibility
    between Neutron installations. It's better to do the right thing, and do
    it right, implementing the feature for the benefit of API users.

    DocImpact Update configuration documentation to reflect deprecation.

    Change-Id: Iad26221a58589b10381f1a0d69a88c92fb5adeee
    Related-Bug: #1566514

[Ihar Hrachyshka (ihar-hrachyshka)]

I don't think there is any work to do at this point since deprecation does not remove the options. We will need to clean up manuals once we remove the options in Ocata.