Merge pull request #2355 from owncloud/versions-config

New page on config.php settings for files_versions

admin_manual/configuration_files/file_versioning.rst

@@ -0,0 +1,51 @@
+===================================
+Controlling File Versions and Aging
+===================================
+
+The Versions app (files_versions) expires old file versions automatically to 
+ensure that users don't exceed their storage quotas. This is the default 
+pattern used to delete old versions:
+
+* For the first second we keep one version
+* For the first 10 seconds ownCloud keeps one version every 2 seconds
+* For the first minute ownCloud keeps one version every 10 seconds
+* For the first hour ownCloud keeps one version every minute
+* For the first 24 hours ownCloud keeps one version every hour
+* For the first 30 days ownCloud keeps one version every day
+* After the first 30 days ownCloud keeps one version every week
+
+The versions are adjusted along this pattern every time a new version is 
+created.
+
+The Versions app never uses more that 50% of the user's currently available 
+free space. If the stored versions exceed this limit, ownCloud deletes the 
+oldest file versions until it meets the disk space limit again.
+
+You may alter the default pattern in ``config.php``. The default setting is 
+``auto``, which sets the default pattern::
+
+ 'versions_retention_obligation' => 'auto',
+
+Additional options are:
+
+* ``D, auto``   
+    Keep versions at least for D days, apply expiration rules to all versions 
+    that are older than D days
+
+* ``auto, D``   
+    Delete all versions that are older than D days automatically, delete other 
+    versions according to expiration rules
+ 
+* ``D1, D2``    
+    Keep versions for at least D1 days and delete when they exceed D2 days.
+
+* ``disabled``  
+    Disable Versions; no files will be deleted.
+
+Enterprise File Retention
+-------------------------
+
+Enterprise customers have additional tools for managing file retention 
+policies; see :doc:`../enterprise_file_management/files_tagging`.
+
+    

admin_manual/configuration_files/index.rst

@@ -17,3 +17,4 @@ File Sharing and Management
     encryption_configuration
     files_locking_transactional
     previews_configuration
+    file_versioning