From ae90e350a48eda38ca3091c1032a6e477a3e8a31 Mon Sep 17 00:00:00 2001
From: Jarkko Hietaniemi <jhi@iki.fi>
Date: Sun, 18 Nov 2001 15:13:57 +0000
Subject: [PATCH] Document how "no utf8;" can become handy.

p4raw-id: //depot/perl@13070
---
 lib/utf8.pm | 6 ++++++
 1 file changed, 6 insertions(+)

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.
-- 
2.7.4