[stable31] DAV pagination / deprecation

developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_30.rst

@@ -280,6 +280,7 @@ Deprecated APIs
 - Using ``OCP\TextProcessing\SummaryTaskType`` is deprecated and will be removed in the future. Use ``OCP\TaskProcessing`` instead (see :ref:`Task Processing<task_processing>`). Existing ``TextProcessing`` providers will continue to work with the TaskProcessing API until then.
 - Using ``OCP\TextProcessing\Task`` is deprecated and will be removed in the future. Use ``OCP\TaskProcessing`` instead (see :ref:`Task Processing<task_processing>`). Existing ``TextProcessing`` providers will continue to work with the TaskProcessing API until then.
 - Using ``OCP\TextProcessing\TopicsTaskType`` is deprecated and will be removed in the future. Use ``OCP\TaskProcessing`` instead (see :ref:`Task Processing<task_processing>`). Existing ``TextProcessing`` providers will continue to work with the TaskProcessing API until then.
+- Using ``OCP\Group\Backend\ICreateGroupBackend`` interface is deprecated and will be removed in the future. Use ``OCP\Group\Backend\ICreateNamedGroupBackend`` instead.
 
 Removed APIs
 ^^^^^^^^^^^^

developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_31.rst

@@ -154,6 +154,24 @@ Changed APIs
   - ``DATETIME_TZ`` for fields that will (de)serialized as ``\DateTime`` instances with both the time part set and with timezone information.
   - ``DATETIME_TZ_IMMUTABLE`` for fields that will (de)serialized as ``\DateTimeImmutable`` instances with both the time part set and with timezone information.
 
+- It's now possible to paginate DAV requests with new headers. 
+
+  - First request should contains the following headers:
+
+    - ``X-NC-Paginate: true`` enables the functionality
+    - ``X-NC-Paginate-Count: X``  sets the number of results per page (default 100)
+
+  - Server will answer with new headers:
+
+    - ``X-NC-Paginate-Total`` indicates the total number of results.
+    - ``X-NC-Paginate-Token`` gives a token to access other pages of the same result.
+
+  - Issue new requests with token:
+
+    - ``X-NC-Paginate-Token: xxx`` contains the token as sent by the server
+    - ``X-NC-Paginate-Count: X``  sets the number of results per page (default 100)
+    - ``X-NC-Paginate-Offset: Y`` sets the offset (number of ignored results) for the required page (usually "page_number × page_size")
+
 Deprecated APIs
 ^^^^^^^^^^^^^^^
 
@@ -178,3 +196,4 @@ Removed APIs
     - ``OCP\IServerContainer::getLogger`` was removed, use dependency injection with ``Psr\Log\LoggerInterface`` instead.
 - The internal class ``OC\AppFramework\Logger`` was removed, it should have been never used by apps.
   All using apps should migrate to ``Psr\Log\LoggerInterface``.
+- Legacy endpoint to test remote share endpoint (``/testremote``) was removed.