diff --git a/doc/bash_completion.txt b/doc/bash_completion.txt
index a58351c5..1d1e2cf6 100644
--- a/doc/bash_completion.txt
+++ b/doc/bash_completion.txt
@@ -1,6 +1,20 @@
 Bash completion
 ===============
 
+Configuration files
+-------------------
+
+*~/.bash_completion*::
+    Sourced late by bash_completion, pretty much after everything else.
+    Use this file for example to load additional completions, and to remove
+    and override ones installed by bash_completion.
+
+*$XDG_CONFIG_HOME/bash_completion*::
+    Sourced by the bash_completion.sh profile.d script.  This file is
+    suitable for definitions of all `COMP_*` environment variables
+    below.  If `$XDG_CONFIG_HOME` is unset or null, `~/.config` is
+    used instead of it.
+
 Environment variables
 ---------------------