From: Jarkko Hietaniemi <jhi@iki.fi>
Date: Sun, 18 Nov 2001 15:13:57 +0000 (+0000)
Subject: Document how "no utf8;" can become handy.
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=ae90e350a48eda38ca3091c1032a6e477a3e8a31;p=p5sagit%2Fp5-mst-13.2.git

Document how "no utf8;" can become handy.

p4raw-id: //depot/perl@13070
---

diff --git a/lib/utf8.pm b/lib/utf8.pm
index cb19686..86456d5 100644
--- a/lib/utf8.pm
+++ b/lib/utf8.pm
@@ -63,6 +63,12 @@ UTF-EBCDIC character.
 
 =back
 
+Note that if you have bytes with the eighth bit on in your script
+(for example embedded Latin-1 in your string literals), C<use utf8>
+will be unhappy since the bytes are most probably not well-formed
+UTF-8.  If you want to have such bytes and use utf8, you can disable
+utf8 until the end the block (or file, if at top level) by C<no utf8;>.
+
 =head2 Utility functions
 
 The following functions are defined in the C<utf8::> package by the perl core.