summaryrefslogtreecommitdiff
path: root/Master/tlpkg/tlperl/lib/MIME
diff options
context:
space:
mode:
authorSiep Kroonenberg <siepo@cybercomm.nl>2011-02-17 12:20:49 +0000
committerSiep Kroonenberg <siepo@cybercomm.nl>2011-02-17 12:20:49 +0000
commit316ee97c621496b0fe3267f57cce81bee44ca1e6 (patch)
treecb2cab1192b4f58a7971af19b213e980bceda4b4 /Master/tlpkg/tlperl/lib/MIME
parentcd0f87b5d39480d85ad9bd4ee37f520f75bed560 (diff)
Moving old tlperl prior to committing new one
git-svn-id: svn://tug.org/texlive/trunk@21422 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/tlpkg/tlperl/lib/MIME')
-rwxr-xr-xMaster/tlpkg/tlperl/lib/MIME/Base64.pm175
-rwxr-xr-xMaster/tlpkg/tlperl/lib/MIME/QuotedPrint.pm114
2 files changed, 0 insertions, 289 deletions
diff --git a/Master/tlpkg/tlperl/lib/MIME/Base64.pm b/Master/tlpkg/tlperl/lib/MIME/Base64.pm
deleted file mode 100755
index 2bcd5857795..00000000000
--- a/Master/tlpkg/tlperl/lib/MIME/Base64.pm
+++ /dev/null
@@ -1,175 +0,0 @@
-package MIME::Base64;
-
-use strict;
-use vars qw(@ISA @EXPORT $VERSION);
-
-require Exporter;
-@ISA = qw(Exporter);
-@EXPORT = qw(encode_base64 decode_base64);
-
-$VERSION = '3.09';
-
-require XSLoader;
-XSLoader::load('MIME::Base64', $VERSION);
-
-*encode = \&encode_base64;
-*decode = \&decode_base64;
-
-1;
-
-__END__
-
-=head1 NAME
-
-MIME::Base64 - Encoding and decoding of base64 strings
-
-=head1 SYNOPSIS
-
- use MIME::Base64;
-
- $encoded = encode_base64('Aladdin:open sesame');
- $decoded = decode_base64($encoded);
-
-=head1 DESCRIPTION
-
-This module provides functions to encode and decode strings into and from the
-base64 encoding specified in RFC 2045 - I<MIME (Multipurpose Internet
-Mail Extensions)>. The base64 encoding is designed to represent
-arbitrary sequences of octets in a form that need not be humanly
-readable. A 65-character subset ([A-Za-z0-9+/=]) of US-ASCII is used,
-enabling 6 bits to be represented per printable character.
-
-The following functions are provided:
-
-=over 4
-
-=item encode_base64($str)
-
-=item encode_base64($str, $eol);
-
-Encode data by calling the encode_base64() function. The first
-argument is the string to encode. The second argument is the
-line-ending sequence to use. It is optional and defaults to "\n". The
-returned encoded string is broken into lines of no more than 76
-characters each and it will end with $eol unless it is empty. Pass an
-empty string as second argument if you do not want the encoded string
-to be broken into lines.
-
-=item decode_base64($str)
-
-Decode a base64 string by calling the decode_base64() function. This
-function takes a single argument which is the string to decode and
-returns the decoded data.
-
-Any character not part of the 65-character base64 subset is
-silently ignored. Characters occurring after a '=' padding character
-are never decoded.
-
-If the length of the string to decode, after ignoring
-non-base64 chars, is not a multiple of 4 or if padding occurs too early,
-then a warning is generated if perl is running under C<-w>.
-
-=back
-
-If you prefer not to import these routines into your namespace, you can
-call them as:
-
- use MIME::Base64 ();
- $encoded = MIME::Base64::encode($decoded);
- $decoded = MIME::Base64::decode($encoded);
-
-=head1 DIAGNOSTICS
-
-The following warnings can be generated if perl is invoked with the
-C<-w> switch:
-
-=over 4
-
-=item Premature end of base64 data
-
-The number of characters to decode is not a multiple of 4. Legal
-base64 data should be padded with one or two "=" characters to make
-its length a multiple of 4. The decoded result will be the same
-whether the padding is present or not.
-
-=item Premature padding of base64 data
-
-The '=' padding character occurs as the first or second character
-in a base64 quartet.
-
-=back
-
-The following exception can be raised:
-
-=over 4
-
-=item Wide character in subroutine entry
-
-The string passed to encode_base64() contains characters with code
-above 255. The base64 encoding is only defined for single-byte
-characters. Use the Encode module to select the byte encoding you
-want.
-
-=back
-
-=head1 EXAMPLES
-
-If you want to encode a large file, you should encode it in chunks
-that are a multiple of 57 bytes. This ensures that the base64 lines
-line up and that you do not end up with padding in the middle. 57
-bytes of data fills one complete base64 line (76 == 57*4/3):
-
- use MIME::Base64 qw(encode_base64);
-
- open(FILE, "/var/log/wtmp") or die "$!";
- while (read(FILE, $buf, 60*57)) {
- print encode_base64($buf);
- }
-
-or if you know you have enough memory
-
- use MIME::Base64 qw(encode_base64);
- local($/) = undef; # slurp
- print encode_base64(<STDIN>);
-
-The same approach as a command line:
-
- perl -MMIME::Base64 -0777 -ne 'print encode_base64($_)' <file
-
-Decoding does not need slurp mode if every line contains a multiple
-of four base64 chars:
-
- perl -MMIME::Base64 -ne 'print decode_base64($_)' <file
-
-Perl v5.8 and better allow extended Unicode characters in strings.
-Such strings cannot be encoded directly, as the base64
-encoding is only defined for single-byte characters. The solution is
-to use the Encode module to select the byte encoding you want. For
-example:
-
- use MIME::Base64 qw(encode_base64);
- use Encode qw(encode);
-
- $encoded = encode_base64(encode("UTF-8", "\x{FFFF}\n"));
- print $encoded;
-
-=head1 COPYRIGHT
-
-Copyright 1995-1999, 2001-2004 Gisle Aas.
-
-This library is free software; you can redistribute it and/or
-modify it under the same terms as Perl itself.
-
-Distantly based on LWP::Base64 written by Martijn Koster
-<m.koster@nexor.co.uk> and Joerg Reichelt <j.reichelt@nexor.co.uk> and
-code posted to comp.lang.perl <3pd2lp$6gf@wsinti07.win.tue.nl> by Hans
-Mulder <hansm@wsinti07.win.tue.nl>
-
-The XS implementation uses code from metamail. Copyright 1991 Bell
-Communications Research, Inc. (Bellcore)
-
-=head1 SEE ALSO
-
-L<MIME::QuotedPrint>
-
-=cut
diff --git a/Master/tlpkg/tlperl/lib/MIME/QuotedPrint.pm b/Master/tlpkg/tlperl/lib/MIME/QuotedPrint.pm
deleted file mode 100755
index ca3a042edb3..00000000000
--- a/Master/tlpkg/tlperl/lib/MIME/QuotedPrint.pm
+++ /dev/null
@@ -1,114 +0,0 @@
-package MIME::QuotedPrint;
-
-use strict;
-use vars qw(@ISA @EXPORT $VERSION);
-
-require Exporter;
-@ISA = qw(Exporter);
-@EXPORT = qw(encode_qp decode_qp);
-
-$VERSION = "3.09";
-
-use MIME::Base64; # will load XS version of {en,de}code_qp()
-
-*encode = \&encode_qp;
-*decode = \&decode_qp;
-
-1;
-
-__END__
-
-=head1 NAME
-
-MIME::QuotedPrint - Encoding and decoding of quoted-printable strings
-
-=head1 SYNOPSIS
-
- use MIME::QuotedPrint;
-
- $encoded = encode_qp($decoded);
- $decoded = decode_qp($encoded);
-
-=head1 DESCRIPTION
-
-This module provides functions to encode and decode strings into and from the
-quoted-printable encoding specified in RFC 2045 - I<MIME (Multipurpose
-Internet Mail Extensions)>. The quoted-printable encoding is intended
-to represent data that largely consists of bytes that correspond to
-printable characters in the ASCII character set. Each non-printable
-character (as defined by English Americans) is represented by a
-triplet consisting of the character "=" followed by two hexadecimal
-digits.
-
-The following functions are provided:
-
-=over 4
-
-=item encode_qp($str)
-
-=item encode_qp($str, $eol)
-
-=item encode_qp($str, $eol, $binmode)
-
-This function returns an encoded version of the string ($str) given as
-argument.
-
-The second argument ($eol) is the line-ending sequence to use. It is
-optional and defaults to "\n". Every occurrence of "\n" is replaced
-with this string, and it is also used for additional "soft line
-breaks" to ensure that no line end up longer than 76 characters. Pass
-it as "\015\012" to produce data suitable for external consumption.
-The string "\r\n" produces the same result on many platforms, but not
-all.
-
-The third argument ($binmode) will select binary mode if passed as a
-TRUE value. In binary mode "\n" will be encoded in the same way as
-any other non-printable character. This ensures that a decoder will
-end up with exactly the same string whatever line ending sequence it
-uses. In general it is preferable to use the base64 encoding for
-binary data; see L<MIME::Base64>.
-
-An $eol of "" (the empty string) is special. In this case, no "soft
-line breaks" are introduced and binary mode is effectively enabled so
-that any "\n" in the original data is encoded as well.
-
-=item decode_qp($str);
-
-This function returns the plain text version of the string given
-as argument. The lines of the result are "\n" terminated, even if
-the $str argument contains "\r\n" terminated lines.
-
-=back
-
-
-If you prefer not to import these routines into your namespace, you can
-call them as:
-
- use MIME::QuotedPrint ();
- $encoded = MIME::QuotedPrint::encode($decoded);
- $decoded = MIME::QuotedPrint::decode($encoded);
-
-Perl v5.8 and better allow extended Unicode characters in strings.
-Such strings cannot be encoded directly, as the quoted-printable
-encoding is only defined for single-byte characters. The solution is
-to use the Encode module to select the byte encoding you want. For
-example:
-
- use MIME::QuotedPrint qw(encode_qp);
- use Encode qw(encode);
-
- $encoded = encode_qp(encode("UTF-8", "\x{FFFF}\n"));
- print $encoded;
-
-=head1 COPYRIGHT
-
-Copyright 1995-1997,2002-2004 Gisle Aas.
-
-This library is free software; you can redistribute it and/or
-modify it under the same terms as Perl itself.
-
-=head1 SEE ALSO
-
-L<MIME::Base64>
-
-=cut