From cdd94ca776dceea28cef3714a8bc6d873614b2bf Mon Sep 17 00:00:00 2001
From: Nicholas Clark <nick@ccl4.org>
Date: Fri, 14 Jan 2005 09:55:16 +0000
Subject: Improve documentation for sv_catpvf, to note that pattern's UTF-8ness
 is taken from the SV's UTF-8ness

p4raw-id: //depot/perl@23800
---
 pod/perlapi.pod | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

(limited to 'pod')

diff --git a/pod/perlapi.pod b/pod/perlapi.pod
index 39390985e0..a1ddb13f06 100644
--- a/pod/perlapi.pod
+++ b/pod/perlapi.pod
@@ -3949,7 +3949,8 @@ output to an SV.  If the appended data contains "wide" characters
 (including, but not limited to, SVs with a UTF-8 PV formatted with %s,
 and characters >255 formatted with %c), the original SV might get
 upgraded to UTF-8.  Handles 'get' magic, but not 'set' magic.  See
-C<sv_catpvf_mg>.
+C<sv_catpvf_mg>. If the original SV was UTF-8, the pattern should be
+valid UTF-8; if the original SV was bytes, the pattern should be too.
 
 	void	sv_catpvf(SV* sv, const char* pat, ...)
 
-- 
cgit v1.2.1