summaryrefslogtreecommitdiffstats
path: root/upstream/debian-unstable/man3/PerlIO::via::QuotedPrint.3perl
blob: 15345e24af11c2b0f8e45d263be104c6eea50abf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "PerlIO::via::QuotedPrint 3perl"
.TH PerlIO::via::QuotedPrint 3perl 2024-05-30 "perl v5.38.2" "Perl Programmers Reference Guide"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
PerlIO::via::QuotedPrint \- PerlIO layer for quoted\-printable strings
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 1
\&    use PerlIO::via::QuotedPrint;
\&
\&    open(my $in, \*(Aq<:via(QuotedPrint)\*(Aq, \*(Aqfile.qp\*(Aq) or
\&        die "Can\*(Aqt open file.qp for reading: $!\en";
\&
\&    open(my $out, \*(Aq>:via(QuotedPrint)\*(Aq, \*(Aqfile.qp\*(Aq) or
\&        die "Can\*(Aqt open file.qp for writing: $!\en";
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This module implements a PerlIO layer that works on files encoded in the
quoted-printable format.  It will decode from quoted-printable while reading
from a handle, and it will encode as quoted-printable while writing to a handle.
.SH EXPORTS
.IX Header "EXPORTS"
\&\fINone\fR.
.SH "KNOWN BUGS"
.IX Header "KNOWN BUGS"
\&\fINone\fR.
.SH FEEDBACK
.IX Header "FEEDBACK"
Patches, bug reports, suggestions or any other feedback is welcome.
.PP
Patches can be sent as GitHub pull requests at
<https://github.com/steve\-m\-hay/PerlIO\-via\-QuotedPrint/pulls>.
.PP
Bug reports and suggestions can be made on the CPAN Request Tracker at
<https://rt.cpan.org/Public/Bug/Report.html?Queue=PerlIO\-via\-QuotedPrint>.
.PP
Currently active requests on the CPAN Request Tracker can be viewed at
<https://rt.cpan.org/Public/Dist/Display.html?Status=Active;Queue=PerlIO\-via\-QuotedPrint>.
.PP
Please test this distribution.  See CPAN Testers Reports at
<https://www.cpantesters.org/> for details of how to get involved.
.PP
Previous test results on CPAN Testers Reports can be viewed at
<https://www.cpantesters.org/distro/P/PerlIO\-via\-QuotedPrint.html>.
.PP
Please rate this distribution on CPAN Ratings at
<https://cpanratings.perl.org/rate/?distribution=PerlIO\-via\-QuotedPrint>.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
PerlIO::via,
MIME::QuotedPrint.
.SH ACKNOWLEDGEMENTS
.IX Header "ACKNOWLEDGEMENTS"
Based on an example in the standard library module MIME::QuotedPrint in Perl
(version 5.8.0).
.SH AVAILABILITY
.IX Header "AVAILABILITY"
The latest version of this module is available from CPAN (see
"CPAN" in perlmodlib for details) at
.PP
<https://metacpan.org/release/PerlIO\-via\-QuotedPrint> or
.PP
<https://www.cpan.org/authors/id/S/SH/SHAY/> or
.PP
<https://www.cpan.org/modules/by\-module/PerlIO/>.
.PP
The latest source code is available from GitHub at
<https://github.com/steve\-m\-hay/PerlIO\-via\-QuotedPrint>.
.SH INSTALLATION
.IX Header "INSTALLATION"
See the \fIINSTALL\fR file.
.SH AUTHOR
.IX Header "AUTHOR"
Elizabeth Mattijsen <liz@dijkmat.nl <mailto:liz@dijkmat.nl>>.
.PP
Steve Hay <shay@cpan.org <mailto:shay@cpan.org>> is now maintaining
PerlIO::via::QuotedPrint as of version 0.08.
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2002\-2004, 2012 Elizabeth Mattijsen.  All rights reserved.
.PP
Copyright (C) 2015, 2020 Steve Hay.  All rights reserved.
.SH LICENCE
.IX Header "LICENCE"
This module is free software; you can redistribute it and/or modify it under
the same terms as Perl itself, i.e. under the terms of either the GNU General
Public License or the Artistic License, as specified in the \fILICENCE\fR file.
.SH VERSION
.IX Header "VERSION"
Version 0.10
.SH DATE
.IX Header "DATE"
22 May 2022
.SH HISTORY
.IX Header "HISTORY"
See the \fIChanges\fR file.