diff --git a/doc_src/doc.hdr b/doc_src/doc.hdr
index 7646b2dfe..39502492f 100644
--- a/doc_src/doc.hdr
+++ b/doc_src/doc.hdr
@@ -541,7 +541,6 @@ a string is expanded into a process id. The following expansions are
performed:
- If the string is the entire word \c self, the shells pid is the result
-- When inside a command substitution, if the string is the entire word \c caller, the job number (not the pid) of the job the created the command substitution is the result
- Otherwise, if the string is the id of a job, the result is the process
group id of the job.
- Otherwise, if any child processes match the specified string, their
diff --git a/doc_src/function.txt b/doc_src/function.txt
index 612b663bd..62dd41e0a 100644
--- a/doc_src/function.txt
+++ b/doc_src/function.txt
@@ -7,7 +7,7 @@
- \c -b or \c --key-binding specifies that the function is a key biding. Key binding functions work exactly like regular functions except that they can not be tab-completed, and may contain the '-' character.
- -d DESCRIPTION or \c --description=DESCRIPTION is a description of what the function does, suitable as a completion description
-- -j PID or --on-job-exit PID tells fish to run this function when the job with group id PID exits
+- -j PID or --on-job-exit PID tells fish to run this function when the job with group id PID exits. Instead of PID, the string 'caller' can be specified. This is only legal when in a command substitution, and will result in the handler being triggered by the exit of the job which created this command substitution.
- -p PID or --on-process-exit PID tells fish to run this function when the fish child process with process id PID exits
- -s or --on-signal SIGSPEC tells fish to run this function when the signal SIGSPEC is delivered. SIGSPEC can be a signal number, or the signal name, such as SIGHUP (or just HUP)
- -v or --on-variable VARIABLE_NAME tells fish to run this function when the variable VARIABLE_NAME changes value