fix: add note about change in behaviour of the job

This commit is contained in:
yemkareems
2025-10-13 12:11:26 +05:30
parent bae6fc4372
commit 02dfcf09be

View File

@@ -54,4 +54,22 @@ Deactivate background job: ``occ config:app:set --value=no files_versions backgr
Activate background job: ``occ config:app:delete files_versions background_job_expire_versions``
Expire versions: ``occ versions:expire`` or ``occ versions:expire --quiet`` (without the progress bar)
Expire versions: ``occ versions:expire`` or ``occ versions:expire --quiet`` (without the progress bar)
.. note::
*Deviations in behavior: “job run” vs “auto-expiry”*
The ``versions_retention_obligation`` setting behaves slightly differently
depending on whether version expiration is triggered by an *explicit job run*
(for example, via ``occ versions:expire`` or a scheduled background job) or by
*automatic expiry*.
Explicit job-based expiration is *strict* and adheres closely to the configured
``versions_retention_obligation``.
Auto-expiry follows the same retention principles but may apply them more flexibly, allowing minor deviations when
necessary to maintain adequate free storage space.
This distinction can lead to different results depending on whether cleanup is
performed automatically or manually.