The CPAN module recognizes a bundle as a Perl module in the
namespace Bundle:: that does not define any functions or methods and
usually contains only pod documentation. It starts like a Perl
module with a package declaration and a $VERSION
variable. After that, the pod
section looks like any other pod except that it contains a special
section that begins with:
=head1 CONTENTS
This section consists of lines such as:
Module_Name
[Version_String
] [-optional text
]
in which Module_Name
is the name of
a module (for example, Term::ReadLine), not the name of a
distribution file, and the version and text are optional. If there
is text, it is preceded by a -
.
The distribution of a bundle should follow the same convention as
other distributions.
Bundles are treated specially in the CPAN package. When you
tell CPAN to install a bundle, it installs all the modules in the
CONTENTS section of the pod. You can install your own bundles
locally by placing a conforming bundle file somewhere in your
@INC
path. The autobundle
command available in the shell
interface does that for you by including all currently installed
modules in a snapshot bundle file (see Chapter 2).
3.142.133.54