--- code/trunk/doc/pcreapi.3	2007/03/19 10:20:14	126
+++ code/trunk/doc/pcreapi.3	2007/03/19 11:44:45	127
@@ -1585,8 +1585,9 @@
 translation table.
 .P
 These functions call \fBpcre_get_stringnumber()\fP, and if it succeeds, they
-then call \fIpcre_copy_substring()\fP or \fIpcre_get_substring()\fP, as
-appropriate.
+then call \fBpcre_copy_substring()\fP or \fBpcre_get_substring()\fP, as
+appropriate. \fBNOTE:\fP If PCRE_DUPNAMES is set and there are duplicate names,
+the behaviour may not be what you want (see the next section). 
 .
 .
 .SH "DUPLICATE SUBPATTERN NAMES"