diff --git a/doc/pages/commands.asciidoc b/doc/pages/commands.asciidoc
index b5ebefd0..cdca31ed 100644
--- a/doc/pages/commands.asciidoc
+++ b/doc/pages/commands.asciidoc
@@ -72,7 +72,7 @@ of the file onto the filesystem
 
 *source* <filename> <param>...::
     execute commands in <filename>
-    parameters are avilable in the sourced script through the `arg` values
+    parameters are available in the sourced script as `%arg{0}`, `%arg{1}`, …
 
 == Clients and Sessions
 
diff --git a/src/commands.cc b/src/commands.cc
index f65d4a20..bbb32b14 100644
--- a/src/commands.cc
+++ b/src/commands.cc
@@ -1304,7 +1304,8 @@ const CommandDesc debug_cmd = {
 const CommandDesc source_cmd = {
     "source",
     nullptr,
-    "source <filename> <params>...: execute commands contained in <filename>",
+    "source <filename> <params>...: execute commands contained in <filename>\n"
+    "parameters are available in the sourced script as %arg{0}, %arg{1}, …",
     ParameterDesc{ {}, ParameterDesc::Flags::None, 1, (size_t)-1 },
     CommandFlags::None,
     CommandHelper{},
diff --git a/src/highlighters.cc b/src/highlighters.cc
index dbc7e8eb..1493724a 100644
--- a/src/highlighters.cc
+++ b/src/highlighters.cc
@@ -2240,7 +2240,7 @@ void register_highlighters()
     registry.insert({
         "region",
         { RegionsHighlighter::create_region,
-          "Parameters:  [-match-capture] [-recurse <recurse>] <opening> <closing> <type> <params>..."
+          "Parameters:  [-match-capture] [-recurse <recurse>] <opening> <closing> <type> <params>...\n"
           "Define a region for a regions highlighter, and apply the given delegate\n"
           "highlighter as defined by <type> and eventual <params>...\n"
           "The region starts at <begin> match and ends at the first <end>\n"