From c5994eee0ff57d26cde7f7e14de0c92ae9520f25 2022-11-12 22:33:18
From: krassowski <5832902+krassowski@users.noreply.github.com>
Date: 2022-11-12 22:33:18
Subject: [PATCH] Explain expected format for `disable_matchers`/identifiers

---

diff --git a/IPython/core/completer.py b/IPython/core/completer.py
index fc3aea7..645f8b8 100644
--- a/IPython/core/completer.py
+++ b/IPython/core/completer.py
@@ -684,7 +684,10 @@ def completion_matcher(
     identifier : Optional[str]
         identifier of the matcher allowing users to modify the behaviour via traitlets,
         and also used to for debugging (will be passed as ``origin`` with the completions).
-        Defaults to matcher function ``__qualname__``.
+
+        Defaults to matcher function's ``__qualname__`` (for example,
+        ``IPCompleter.file_matcher`` for the built-in matched defined
+        as a ``file_matcher`` method of the ``IPCompleter`` class).
     api_version: Optional[int]
         version of the Matcher API used by this matcher.
         Currently supported values are 1 and 2.
@@ -1447,14 +1450,18 @@ class IPCompleter(Completer):
 
         If False, only the completion results from the first non-empty
         completer will be returned.
-        
+
         As of version 8.6.0, setting the value to ``False`` is an alias for:
         ``IPCompleter.suppress_competing_matchers = True.``.
         """,
     ).tag(config=True)
 
     disable_matchers = ListTrait(
-        Unicode(), help="""List of matchers to disable."""
+        Unicode(),
+        help="""List of matchers to disable.
+
+        The list should contain matcher identifiers (see :any:`completion_matcher`).
+        """,
     ).tag(config=True)
 
     omit__names = Enum(
diff --git a/IPython/core/magics/config.py b/IPython/core/magics/config.py
index f442ba1..87fe3ee 100644
--- a/IPython/core/magics/config.py
+++ b/IPython/core/magics/config.py
@@ -82,6 +82,8 @@ class ConfigMagics(Magics):
                 Current: False
             IPCompleter.disable_matchers=<list-item-1>...
                 List of matchers to disable.
+                        The list should contain matcher identifiers (see
+                :any:`completion_matcher`).
                 Current: []
             IPCompleter.greedy=<Bool>
                 Activate greedy completion