Debian Codegraph @

upstream/mageia-cauldron/man3pm/Encode::Unicode::UTF7.3pm

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\"
56 .\" Required to disable full justification in groff 1.23.0.
57 .if n .ds AD l
58 .\" ========================================================================
59 .\"
60 .IX Title "Encode::Unicode::UTF7 3pm"
61 .TH Encode::Unicode::UTF7 3pm 2023-12-22 "perl v5.42.0" "Perl Programmers Reference Guide"
62 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
63 .\" way too many mistakes in technical documents.
64 .if n .ad l
65 .nh
66 .SH NAME
67 Encode::Unicode::UTF7 \-\- UTF\-7 encoding
68 .SH SYNOPSIS
69 .IX Header "SYNOPSIS"
70 .Vb 3
71 \& use Encode qw/encode decode/;
72 \& $utf7 = encode("UTF\-7", $utf8);
73 \& $utf8 = decode("UTF\-7", $ucs2);
74 .Ve
75 .SH ABSTRACT
76 .IX Header "ABSTRACT"
77 This module implements UTF\-7 encoding documented in RFC 2152. UTF\-7,
78 as its name suggests, is a 7\-bit re\-encoded version of UTF\-16BE. It
79 is designed to be MTA\-safe and expected to be a standard way to
80 exchange Unicoded mails via mails. But with the advent of UTF\-8 and
81 8\-bit compliant MTAs, UTF\-7 is hardly ever used.
82 .PP
83 UTF\-7 was not supported by Encode until version 1.95 because of that.
84 But Unicode::String, a module by Gisle Aas which adds Unicode supports
85 to non\-utf8\-savvy perl did support UTF\-7, the UTF\-7 support was added
86 so Encode can supersede Unicode::String 100%.
87 .SH "In Practice"
88 .IX Header "In Practice"
89 When you want to encode Unicode for mails and web pages, however, do
90 not use UTF\-7 unless you are sure your recipients and readers can
91 handle it. Very few MUAs and WWW Browsers support these days (only
92 Mozilla seems to support one). For general cases, use UTF\-8 for
93 message body and MIME\-Header for header instead.
94 .SH "SEE ALSO"
95 .IX Header "SEE ALSO"
96 Encode, Encode::Unicode, Unicode::String
97 .PP
98 RFC 2781 <http://www.ietf.org/rfc/rfc2152.txt>