--- CBOR-XS/XS.pm	2016/04/24 19:16:15	1.51
+++ CBOR-XS/XS.pm	2016/04/25 18:17:17	1.52
@@ -249,6 +249,50 @@
 This option does not affect C<decode> in any way - string references will
 always be decoded properly if present.
 
+=item $cbor = $cbor->text_keys ([$enable])
+
+=item $enabled = $cbor->get_text_keys
+
+If C<$enabled> is true (or missing), then C<encode> will encode all
+perl hash keys as CBOR text strings/UTF-8 string, upgrading them as needed.
+
+If C<$enable> is false (the default), then C<encode> will encode hash keys
+normally - upgraded perl strings (strings internally encoded as UTF-8) as
+CBOR text strings, and downgraded perl strings as CBOR byte strings.
+
+This option does not affect C<decode> in any way.
+
+This option is useful for interoperability with CBOR decoders that don't
+treat byte strings as a form of text. It is especially useful as Perl
+gives very little control over hash keys.
+
+Enabling this option can be slow, as all downgraded hash keys that are
+encoded need to be scanned and converted to UTF-8.
+
+=item $cbor = $cbor->text_strings ([$enable])
+
+=item $enabled = $cbor->get_text_strings
+
+This option works similar to C<text_keys>, above, but works on all strings
+(including hash keys), so C<text_keys> has no further effect after
+enabling C<text_strings>.
+
+If C<$enabled> is true (or missing), then C<encode> will encode all perl
+strings as CBOR text strings/UTF-8 strings, upgrading them as needed.
+
+If C<$enable> is false (the default), then C<encode> will encode strings
+normally (but see C<text_keys>) - upgraded perl strings (strings
+internally encoded as UTF-8) as CBOR text strings, and downgraded perl
+strings as CBOR byte strings.
+
+This option does not affect C<decode> in any way.
+
+This option has similar advantages and disadvantages as C<text_keys>. In
+addition, this option effectively removes the ability to encode byte
+strings, which might break some C<FREEZE> and C<TO_CBOR> methods that rely
+on this, such as bignum encoding, so this option is mainly useful for very
+simple data.
+
 =item $cbor = $cbor->validate_utf8 ([$enable])
 
 =item $enabled = $cbor->get_validate_utf8
@@ -665,7 +709,6 @@
 
    sub URI::THAW {
       my ($class, $serialiser, $uri) = @_;
-
       $class->new ($uri)
    }