diff --git a/doc_src/set.txt b/doc_src/set.txt
index eda46da9c..d41b514e4 100644
--- a/doc_src/set.txt
+++ b/doc_src/set.txt
@@ -3,6 +3,10 @@
\subsection set-synopsis Synopsis
set [OPTIONS] [VARIABLE_NAME [VALUES...]]
+or
+
+set [OPTIONS] [VARIABLE_NAME[INDICES]... [VALUES...]]
+
The set
builtin causes fish to assign the variable VARIABLE_NAME
the values VALUES...
.
\subsection set-description Description
@@ -29,7 +33,9 @@ elements, it will become an array with zero elements.
If the variable name is one or more array elements, such as
PATH[1 3 7]
, only those array elements specified will be
-changed.
+changed. When array indices are specified to set, multiple arguments
+may be used to specify additional indexes, e.g. set PATH[1]
+PATH[4] /bin /sbin
.
The set command requires all switch arguments to come before any
non-switch arguments. For example, set flags -l
will have