From 3c79c9b271ebcf9841cea0672e5658c3f9f15ff0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mike=20F=C3=A4hrmann?= <mike_faehrmann@web.de>
Date: Thu, 6 Jan 2022 23:36:57 +0100
Subject: [PATCH] document extended blacklist/whitelist syntax (#2025)

and not just in the commit message of 010d65dc
---
 docs/configuration.rst | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/docs/configuration.rst b/docs/configuration.rst
index f9aca468..a1064ae0 100644
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -550,11 +550,19 @@ Type
     ``list`` of ``strings``
 Default
     ``["oauth", "recursive", "test"]`` + current extractor category
+Example
+    ``["imgur", "gfycat:user", "*:image"]``
 Description
-    A list of extractor categories to ignore (or allow)
+    A list of extractor identifiers to ignore (or allow)
     when spawning child extractors for unknown URLs,
     e.g. from ``reddit`` or ``plurk``.
 
+    Each identifier can be
+
+    * A category or basecategory name (``"imgur"``, ``"mastodon"``)
+    * | A (base)category-subcategory pair, where both names are separated by a colon (``"gfycat:user"``).
+      | Both names can be a `*` or left empty, matching all possible names (``"*:image"``, ``":user"``).
+
     Note: Any ``blacklist`` setting will automatically include
     ``"oauth"``, ``"recursive"``, and ``"test"``.