diff --git a/docs/xonshrc.xsh b/docs/xonshrc.xsh
index 77a3268ef..d19e8c12e 100644
--- a/docs/xonshrc.xsh
+++ b/docs/xonshrc.xsh
@@ -11,7 +11,10 @@ def _quit_awesome(args, stdin=None):
 
 aliases['qa'] = _quit_awesome
 
-# some customization options
+# some customization options, see https://xon.sh/envvars.html for details
 $MULTILINE_PROMPT = '`·.,¸,.·*¯`·.,¸,.·*¯'
 $XONSH_SHOW_TRACEBACK = True
 $XONSH_STORE_STDOUT = True
+$XONSH_HISTORY_MATCH_ANYWHERE = True
+$COMPLETIONS_CONFIRM = True
+$XONSH_AUTOPAIR = True