File: //usr/local/ssl/local/share/man/man3/Bundle::Interchange.3
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.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
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. | will give a
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. nr % 0
. rr F
.\}
.\"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
. ds #V .8m
. ds #F .3m
. ds #[ \f1
. ds #] \fP
.\}
.if t \{\
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. ds #V .6m
. ds #F 0
. ds #[ \&
. ds #] \&
.\}
. \" simple accents for nroff and troff
.if n \{\
. ds ' \&
. ds ` \&
. ds ^ \&
. ds , \&
. ds ~ ~
. ds /
.\}
.if t \{\
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
. ds : e
. ds 8 ss
. ds o a
. ds d- d\h'-1'\(ga
. ds D- D\h'-1'\(hy
. ds th \o'bp'
. ds Th \o'LP'
. ds ae ae
. ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "Interchange 3"
.TH Interchange 3 "2010-09-12" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
Bundle::Interchange \- A bundle of the modules nice to have for Interchange 5.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\f(CW\*(C`perl \-MCPAN \-e 'install Bundle::Interchange'\*(C'\fR
.SH "CONTENTS"
.IX Header "CONTENTS"
Digest::MD5
.PP
Digest::SHA1
.PP
MIME::Base64
.PP
MIME::Lite
.PP
\&\s-1URI::URL\s0
.PP
HTML::Tagset
.PP
HTML::Entities
.PP
Bundle::LWP
.PP
Parse::RecDescent
.PP
OLE::Storage_Lite
.PP
Bundle::LWP
.PP
Term::ReadKey
.PP
Term::ReadLine::Perl
.PP
Text::Query
.PP
Image::Size
.PP
\&\s-1DBI\s0
.PP
Safe::Hole
.PP
Tie::ShadowHash
.PP
Set::Crontab
.PP
IO::Scalar
.PP
Storable
.PP
Spreadsheet::ParseExcel
.PP
Spreadsheet::WriteExcel
.PP
Net::IP::Match::Regexp
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This bundle installs the prerequisites for Interchange 5 as well as some
modules that are not strictly necessary.
.PP
(Interchange was formerly known as Minivend.)
.PP
After installing this bundle, it is recommended that you quit the current
session and then run Interchange's \f(CW\*(C`makecat\*(C'\fR program. That will give you the
benefit of line completion and history.
.PP
The core functions of Interchange \fIwill\fR run with a stock Perl, but
to use some features of Interchange (like the administrative interface)
you will need these modules.
.IP "Digest::MD5 This module is used to generate unique cache keys. If you don't have it, then keys will be computed with a checksum that has a very low but not infinitesimal chance of causing a cache conflict." 4
.IX Item "Digest::MD5 This module is used to generate unique cache keys. If you don't have it, then keys will be computed with a checksum that has a very low but not infinitesimal chance of causing a cache conflict."
.PD 0
.IP "MIME::Base64" 4
.IX Item "MIME::Base64"
.PD
Used for decoding \s-1HTTP\s0 authorization, also part of Bundle::LWP.
.IP "Bundle::LWP Business::UPS, for calculating shipping, requires this. The [get\-url ...] UserTag and most payment gateways also need \s-1LWP\s0." 4
.IX Item "Bundle::LWP Business::UPS, for calculating shipping, requires this. The [get-url ...] UserTag and most payment gateways also need LWP."
.PD 0
.IP "Storable If you have this module session save speed increases by anywhere from 25\-60%. Highly recommended for busy systems." 4
.IX Item "Storable If you have this module session save speed increases by anywhere from 25-60%. Highly recommended for busy systems."
.IP "Business::UPS Enables lookup of shipping costs directly from www.ups.com." 4
.IX Item "Business::UPS Enables lookup of shipping costs directly from www.ups.com."
.IP "HTML::Parser" 4
.IX Item "HTML::Parser"
.PD
The HTML::Entities module, which is part of this package, is used to
parse \s-1HTML\s0 entities for substitution. \s-1URI::URL\s0 and HTML::TagSet are
prerequisites.
.IP "Text::Query" 4
.IX Item "Text::Query"
Gives Altavista-style search language with \s-1AND\s0, \s-1OR\s0, \s-1NOT\s0, and \s-1NEAR\s0 and
full parentheses nesting.
.IP "Safe::Hole This helps Interchange deal with the object-creation restrictions of \fISafe.pm\fR, used to encourage security." 4
.IX Item "Safe::Hole This helps Interchange deal with the object-creation restrictions of Safe.pm, used to encourage security."
.PD 0
.IP "\s-1DBI\s0 Most people want to use \s-1SQL\s0 with Interchange, and this is a requirement. You will also need the appropriate \s-1DBD\s0 module, i.e. DBD::mysql to support \fBMySQL\fR." 4
.IX Item "DBI Most people want to use SQL with Interchange, and this is a requirement. You will also need the appropriate DBD module, i.e. DBD::mysql to support MySQL."
.IP "Spreadsheet::ParseExcel" 4
.IX Item "Spreadsheet::ParseExcel"
.PD
Allows upload of \s-1XLS\s0 spreadsheets in \s-1UI\s0. IO::Scalar and OLE::Storage_Lite
are prerequisites.
.IP "Spreadsheet::WriteExcel" 4
.IX Item "Spreadsheet::WriteExcel"
Allows creation of \s-1XLS\s0 spreadsheets for download in \s-1UI\s0.
.IP "Term::ReadLine::Perl" 4
.IX Item "Term::ReadLine::Perl"
Gives you filename completion and command history in the makecat program.
Not used otherwise.
.IP "Term::ReadKey" 4
.IX Item "Term::ReadKey"
Helps Term::ReadLine::Perl generate completions and editing in makecat.
Not used otherwise.
.SH "AUTHOR"
.IX Header "AUTHOR"
Mike Heins, <mikeh@perusion.net>