DOC: Update documentation with respect to recycle bin configuration changes

and what steps system admins can take to clean up the old configurtaion.

Author: esindril

doc/diopside/manual/interfaces.rst

@@ -2715,6 +2715,17 @@ If you want to list all the parameter affecting the recycle bin you running
    collect_interval_sec=20
    remove_interval_sec=10
 
+Enable/Disable the recycle bin
+""""""""""""""""""""""""""""""
+
+If you want to enable or disable the recycle bin globally you run
+**recycle config --enable <on|off>**:
+
+.. code-block:: bash
+
+   EOS Console [root://localhost] |/eos/> recycle config --enable on
+
+
 Define the object lifetime
 """"""""""""""""""""""""""
 

doc/diopside/releases/5.4.0/recycle_bin_config.rst

@@ -0,0 +1,68 @@
+Recycle Bin Configuration Update
+================================
+
+.. important::
+   **Configuration Migration Required**
+
+   The recycle bin configuration has moved from extended attributes on the recycle directory to the global EOS configuration.
+
+New Configuration Commands
+--------------------------
+
+Use the ``eos recycle config`` command to configure the recycle bin policy.
+
+**Enable/Disable:**
+
+.. code-block:: bash
+
+   # Enable the recycle bin globally
+   eos recycle config --enable on
+
+   # Disable the recycle bin globally
+   eos recycle config --enable off
+
+
+**Set Policy Parameters:**
+
+.. code-block:: bash
+
+   # Set keep time in seconds (e.g., 1 day)
+   eos recycle config --lifetime 86400
+
+   # Set space keep ratio (0.0 - 1.0)
+   eos recycle config --ratio 0.8
+
+   # Set collection interval in seconds
+   eos recycle config --collect-interval 300
+
+
+Cleanup Legacy Configuration
+----------------------------
+
+Old extended attributes on the recycle directory (typically ``/eos/<instance>/proc/recycle/`` or configured path) are **NO LONGER USED** for policy enforcement and should be removed to avoid confusion.
+
+**Attributes to Remove:**
+
+* ``sys.recycle.keeptime``
+* ``sys.recycle.keepratio``
+* ``sys.recycle.collectinterval``
+* ``sys.recycle.removeinterval``
+
+**How to Remove:**
+
+Use the ``eos attr rm`` command on your recycle bin directory (check your specific path, commonly ``/eos/<instance>/proc/recycle/``):
+
+.. code-block:: bash
+
+   eos attr rm sys.recycle.keeptime /eos/<instance>/proc/recycle/
+   eos attr rm sys.recycle.keepratio /eos/<instance>/proc/recycle/
+   eos attr rm sys.recycle.collectinterval /eos/<instance>/proc/recycle/
+   eos attr rm sys.recycle.removeinterval /eos/<instance>/proc/recycle/
+
+.. note::
+   The ``sys.recycle`` attribute on individual directories is **STILL SUPPORTED** to explicitly mark a subtree for recycling even if global enforcement is off. You do not need to remove ``sys.recycle`` from user directories.
+
+Space Policy Notice
+-------------------
+
+The ``eos space config ... policy.recycle=on`` command is **DEPRECATED** and has been removed. Use ``eos recycle config --enable on`` instead.

doc/diopside/releases/diopside-release.rst

@@ -16,6 +16,18 @@ Introduction
 
 This release is based on XRootD V5.
 
+``v5.4.0 Diopside``
+===================
+
+2025-12-08
+
+Major Change
+------------
+
+* **Recycle Bin Configuration Update**: The recycle bin configuration has been refactored.
+  Please see :doc:`5.4.0/recycle_bin_config` for important migration instructions regarding new configuration commands and cleanup of legacy attributes.
+
+
 ``v5.3.26 Diopside``
 ====================