From 488bab2c015ae5b65d28a8b1cb6bcb7315195f69 Mon Sep 17 00:00:00 2001 From: Nextcloud bot Date: Fri, 2 Sep 2022 04:30:27 +0000 Subject: [PATCH] generate documentation from config.sample.php --- .../config_sample_php_parameters.rst | 28 ++++++++++++++----- 1 file changed, 21 insertions(+), 7 deletions(-) diff --git a/admin_manual/configuration_server/config_sample_php_parameters.rst b/admin_manual/configuration_server/config_sample_php_parameters.rst index 7492d1b7d..1b60629b3 100644 --- a/admin_manual/configuration_server/config_sample_php_parameters.rst +++ b/admin_manual/configuration_server/config_sample_php_parameters.rst @@ -798,25 +798,39 @@ for when files and folders in the trash bin will be permanently deleted. The app allows for two settings, a minimum time for trash bin retention, and a maximum time for trash bin retention. + Minimum time is the number of days a file will be kept, after which it -may be deleted. Maximum time is the number of days at which it is guaranteed -to be deleted. +_may be_ deleted. A file may be deleted after the minimum number of days +is expired if space is needed. The file will not be deleted if space is +not needed. + +Whether "space is needed" depends on whether a user quota is defined or not: + + * If no user quota is defined, the available space on the Nextcloud data + partition sets the limit for the trashbin + (issues: see https://github.com/nextcloud/server/issues/28451). + * If a user quota is defined, 50% of the user's remaining quota space sets + the limit for the trashbin. + +Maximum time is the number of days at which it is _guaranteed +to be_ deleted. There is no further dependency on the available space. + Both minimum and maximum times can be set together to explicitly define file and folder deletion. For migration purposes, this setting is installed initially set to "auto", which is equivalent to the default setting in Nextcloud. -Available values: +Available values (D1 and D2 are configurable numbers): * ``auto`` default setting. keeps files and folders in the trash bin for 30 days and automatically deletes anytime after that if space is needed (note: files may not be deleted if space is not needed). -* ``D, auto`` - keeps files and folders in the trash bin for D+ days, delete anytime if +* ``D1, auto`` + keeps files and folders in the trash bin for D1+ days, delete anytime if space needed (note: files may not be deleted if space is not needed) -* ``auto, D`` - delete all files in the trash bin that are older than D days +* ``auto, D2`` + delete all files in the trash bin that are older than D2 days automatically, delete other files anytime if space needed * ``D1, D2`` keep files and folders in the trash bin for at least D1 days and