From 9dfb80b661525e38e32b8e851b40a2492f743f9c Mon Sep 17 00:00:00 2001
From: arbanhossain <arbanhossain@gmail.com>
Date: Fri, 15 Apr 2022 20:26:54 +0600
Subject: [PATCH] documentation and changelog for --exclude flag

---
 docs/changelog.rst     | 2 ++
 docs/reference/cli.rst | 4 ++++
 2 files changed, 6 insertions(+)

diff --git a/docs/changelog.rst b/docs/changelog.rst
index 4126a8cce..a86c975fb 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -20,6 +20,8 @@ New features:
 * :doc:`/plugins/convert`: Add a new `auto_keep` option that automatically
   converts files but keeps the *originals* in the library.
   :bug:`1840` :bug:`4302`
+* Added a ``-x`` (or ``--exclude``) flag to specify one/multiple plugin(s) to be 
+  disabled at startup.
 
 Bug fixes:
 
diff --git a/docs/reference/cli.rst b/docs/reference/cli.rst
index 214956873..4731dd0e7 100644
--- a/docs/reference/cli.rst
+++ b/docs/reference/cli.rst
@@ -445,6 +445,10 @@ import ...``.
   specified, the plugin list in your configuration is ignored. The long form
   of this argument also allows specifying no plugins, effectively disabling
   all plugins: ``--plugins=``.
+* ``-x EXCLUDE``: specify a comma-separated list of plugins to disable in a
+  specific beets run. If specified, it will exclude plugins from your configuration
+  and/or plugins specified using the ``-p`` flag. To disable ALL plugins, use
+  ``--plugins=`` instead.
 
 Beets also uses the ``BEETSDIR`` environment variable to look for
 configuration and data.