diff --git a/ChangeLog b/ChangeLog
index 9262ff0f4..973f68931 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2001-07-03  Clint Adams  <clint@zsh.org>
 
+	* 15234: Doc/Zsh/mod_pcre.yo: describe
+	behavior introduced by 15228.
+
 	* 15228: zshconfig.ac, Src/Modules/pcre.c:
 	switch AC_CHECK_LIB to AC_SEARCH_LIBS for pcre.
 	Have pcre_match set positional parameters
diff --git a/Doc/Zsh/mod_pcre.yo b/Doc/Zsh/mod_pcre.yo
index 76cf5dec6..2d9989083 100644
--- a/Doc/Zsh/mod_pcre.yo
+++ b/Doc/Zsh/mod_pcre.yo
@@ -18,5 +18,9 @@ findex(pcre_match)
 item(tt(pcre_match) var(string))(
 Returns successfully if tt(string) matches the previously-compiled
 PCRE.
+
+If the expression captures substrings within parentheses,
+tt(pcre_match) will set the positional parameters to
+those substrings, starting with $1 for the first.
 )
 enditem()