diff --git a/doc_src/functions.txt b/doc_src/functions.txt
index 7643bfc68..b9057e18b 100644
--- a/doc_src/functions.txt
+++ b/doc_src/functions.txt
@@ -8,6 +8,7 @@
This builtin command is used to print or erase functions.
- -a
or --all
list all functions, even those whose name start with an underscore.
+- -c OLDNAME NEWNAME
or --copy OLDNAME NEWNAME
creates a new function named NEWNAME, using the definition of the OLDNAME function.
- -d DESCRIPTION
or --description=DESCRIPTION
change the description of this function
- -e
or --erase
causes the specified functions to be erased.
- -h
or --help
display a help message and exit
@@ -23,5 +24,8 @@ Automatically loaded functions can not be removed using functions
-e. Either remove the definition file or change the
$fish_function_path variable to remove autoloaded functions.
+Function copies, created with -c, will not have any event/signal/on-exit
+notifications that the original may have had.
+
The exit status of the functions builtin is the number functions
specified in the argument list that do not exist.