module::build.3

视频监控网络部分的协议ddns,的模块的实现代码,请大家大胆指正.

Creates a \*(L"distribution directory\*(R" named \f(CW\*(C`$dist_name\-$dist_version\*(C'\fR
(if that directory already exists, it will be removed first), then
copies all the files listed in the \fI\s-1MANIFEST\s0\fR file to that directory.
This directory is what the distribution tarball is created from.
.IP "distmeta" 4
.IX Item "distmeta"
[version 0.21]
.Sp
Creates the \fI\s-1META\s0.yml\fR file that describes the distribution.
.Sp
\&\fI\s-1META\s0.yml\fR is a file containing various bits of \*(L"metadata\*(R" about the
distribution.  The metadata includes the distribution name, version,
abstract, prerequisites, license, and various other data about the
distribution.  This file is created as \fI\s-1META\s0.yml\fR in \s-1YAML\s0 format.
It is recommended that the \f(CW\*(C`YAML\*(C'\fR module be installed to create it.
If the \f(CW\*(C`YAML\*(C'\fR module is not installed, an internal module supplied
with Module::Build will be used to write the \s-1META\s0.yml file, and this
will most likely be fine.
.Sp
\&\fI\s-1META\s0.yml\fR file must also be listed in \fI\s-1MANIFEST\s0\fR \- if it's not, a
warning will be issued.
.Sp
The current version of the \fI\s-1META\s0.yml\fR specification can be found at
<http://module\-build.sourceforge.net/META\-spec\-current.html>
.IP "distsign" 4
.IX Item "distsign"
[version 0.16]
.Sp
Uses \f(CW\*(C`Module::Signature\*(C'\fR to create a \s-1SIGNATURE\s0 file for your
distribution, and adds the \s-1SIGNATURE\s0 file to the distribution's
\&\s-1MANIFEST\s0.
.IP "disttest" 4
.IX Item "disttest"
[version 0.05]
.Sp
Performs the 'distdir' action, then switches into that directory and
runs a \f(CW\*(C`perl Build.PL\*(C'\fR, followed by the 'build' and 'test' actions in
that directory.
.IP "docs" 4
.IX Item "docs"
[version 0.20]
.Sp
This will generate documentation (e.g. Unix man pages and html
documents) for any installable items under \fBblib/\fR that
contain \s-1POD\s0.  If there are no \f(CW\*(C`bindoc\*(C'\fR or \f(CW\*(C`libdoc\*(C'\fR installation
targets defined (as will be the case on systems that don't support
Unix manpages) no action is taken for manpages.  If there are no
\&\f(CW\*(C`binhtml\*(C'\fR or \f(CW\*(C`libhtml\*(C'\fR installation targets defined no action is
taken for html documents.
.IP "fakeinstall" 4
.IX Item "fakeinstall"
[version 0.02]
.Sp
This is just like the \f(CW\*(C`install\*(C'\fR action, but it won't actually do
anything, it will just report what it \fIwould\fR have done if you had
actually run the \f(CW\*(C`install\*(C'\fR action.
.IP "help" 4
.IX Item "help"
[version 0.03]
.Sp
This action will simply print out a message that is meant to help you
use the build process.  It will show you a list of available build
actions too.
.Sp
With an optional argument specifying an action name (e.g. \f(CW\*(C`Build help
test\*(C'\fR), the 'help' action will show you any \s-1POD\s0 documentation it can
find for that action.
.IP "html" 4
.IX Item "html"
[version 0.26]
.Sp
This will generate \s-1HTML\s0 documentation for any binary or library files
under \fBblib/\fR that contain \s-1POD\s0.  The \s-1HTML\s0 documentation will only be
installed if the install paths can be determined from values in
\&\f(CW\*(C`Config.pm\*(C'\fR.  You can also supply or override install paths on the
command line by specifying \f(CW\*(C`install_path\*(C'\fR values for the \f(CW\*(C`binhtml\*(C'\fR
and/or \f(CW\*(C`libhtml\*(C'\fR installation targets.
.IP "install" 4
.IX Item "install"
[version 0.01]
.Sp
This action will use \f(CW\*(C`ExtUtils::Install\*(C'\fR to install the files from
\&\f(CW\*(C`blib/\*(C'\fR into the system.  See \*(L"\s-1INSTALL\s0 \s-1PATHS\s0\*(R"
for details about how Module::Build determines where to install
things, and how to influence this process.
.Sp
If you want the installation process to look around in \f(CW@INC\fR for
other versions of the stuff you're installing and try to delete it,
you can use the \f(CW\*(C`uninst\*(C'\fR parameter, which tells \f(CW\*(C`ExtUtils::Install\*(C'\fR to
do so:
.Sp
.Vb 1
\&  ./Build install uninst=1
.Ve
.Sp
This can be a good idea, as it helps prevent multiple versions of a
module from being present on your system, which can be a confusing
situation indeed.
.IP "manifest" 4
.IX Item "manifest"
[version 0.05]
.Sp
This is an action intended for use by module authors, not people
installing modules.  It will bring the \fI\s-1MANIFEST\s0\fR up to date with the
files currently present in the distribution.  You may use a
\&\fI\s-1MANIFEST\s0.SKIP\fR file to exclude certain files or directories from
inclusion in the \fI\s-1MANIFEST\s0\fR.  \fI\s-1MANIFEST\s0.SKIP\fR should contain a bunch
of regular expressions, one per line.  If a file in the distribution
directory matches any of the regular expressions, it won't be included
in the \fI\s-1MANIFEST\s0\fR.
.Sp
The following is a reasonable \fI\s-1MANIFEST\s0.SKIP\fR starting point, you can
add your own stuff to it:
.Sp
.Vb 7
\&  ^_build
\&  ^Build$
\&  ^blib
\&  ~$
\&  \e.bak$
\&  ^MANIFEST\e.SKIP$
\&  CVS
.Ve
.Sp
See the distcheck and skipcheck actions if you want to find out
what the \f(CW\*(C`manifest\*(C'\fR action would do, without actually doing anything.
.IP "manpages" 4
.IX Item "manpages"
[version 0.28]
.Sp
This will generate man pages for any binary or library files under
\&\fBblib/\fR that contain \s-1POD\s0.  The man pages will only be installed if the
install paths can be determined from values in \f(CW\*(C`Config.pm\*(C'\fR.  You can
also supply or override install paths by specifying there values on
the command line with the \f(CW\*(C`bindoc\*(C'\fR and \f(CW\*(C`libdoc\*(C'\fR installation
targets.
.IP "pardist" 4
.IX Item "pardist"
[version 0.2806]
.Sp
Generates a \s-1PAR\s0 binary distribution for use with \s-1PAR\s0 or PAR::Dist.
.Sp
It requires that the PAR::Dist module (version 0.17 and up) is
installed on your system.
.IP "ppd" 4
.IX Item "ppd"
[version 0.20]
.Sp
Build a \s-1PPD\s0 file for your distribution.
.Sp
This action takes an optional argument \f(CW\*(C`codebase\*(C'\fR which is used in
the generated ppd file to specify the (usually relative) \s-1URL\s0 of the
distribution.  By default, this value is the distribution name without
any path information.
.Sp
Example:
.Sp
.Vb 1
\&  ./Build ppd \-\-codebase "MSWin32\-x86\-multi\-thread/Module\-Build\-0.21.tar.gz"
.Ve
.IP "ppmdist" 4
.IX Item "ppmdist"
[version 0.23]
.Sp
Generates a \s-1PPM\s0 binary distribution and a \s-1PPD\s0 description file.  This
action also invokes the 'ppd' action, so it can accept the same
\&\f(CW\*(C`codebase\*(C'\fR argument described under that action.
.Sp
This uses the same mechanism as the \f(CW\*(C`dist\*(C'\fR action to tar & zip its
output, so you can supply \f(CW\*(C`tar\*(C'\fR and/or \f(CW\*(C`gzip\*(C'\fR parameters to affect
the result.
.IP "prereq_report" 4
.IX Item "prereq_report"
[version 0.28]
.Sp
This action prints out a list of all prerequisites, the versions required, and
the versions actually installed.  This can be useful for reviewing the
configuration of your system prior to a build, or when compiling data to send
for a bug report.
.IP "pure_install" 4
.IX Item "pure_install"
[version 0.28]
.Sp
This action is identical to the \f(CW\*(C`install\*(C'\fR action.  In the future,
though, when \f(CW\*(C`install\*(C'\fR starts writing to the file 
\&\fI$(\s-1INSTALLARCHLIB\s0)/perllocal.pod\fR, \f(CW\*(C`pure_install\*(C'\fR won't, and that
will be the only difference between them.
.IP "realclean" 4
.IX Item "realclean"
[version 0.01]
.Sp
This action is just like the \f(CW\*(C`clean\*(C'\fR action, but also removes the
\&\f(CW\*(C`_build\*(C'\fR directory and the \f(CW\*(C`Build\*(C'\fR script.  If you run the
\&\f(CW\*(C`realclean\*(C'\fR action, you are essentially starting over, so you will
have to re-create the \f(CW\*(C`Build\*(C'\fR script again.
.IP "retest" 4
.IX Item "retest"
[version 0.2806]
.Sp
This is just like the \f(CW\*(C`test\*(C'\fR action, but doesn't actually build the
distribution first, and doesn't add \fIblib/\fR to the load path, and
therefore will test against a \fIpreviously\fR installed version of the
distribution.  This can be used to verify that a certain installed
distribution still works, or to see whether newer versions of a
distribution still pass the old regression tests, and so on.
.IP "skipcheck" 4
.IX Item "skipcheck"
[version 0.05]
.Sp
Reports which files are skipped due to the entries in the
\&\fI\s-1MANIFEST\s0.SKIP\fR file (See manifest for details)
.IP "test" 4
.IX Item "test"
[version 0.01]
.Sp
This will use \f(CW\*(C`Test::Harness\*(C'\fR to run any regression tests and report
their results.  Tests can be defined in the standard places: a file
called \f(CW\*(C`test.pl\*(C'\fR in the top-level directory, or several files ending
with \f(CW\*(C`.t\*(C'\fR in a \f(CW\*(C`t/\*(C'\fR directory.
.Sp
If you want tests to be 'verbose', i.e. show details of test execution
rather than just summary information, pass the argument \f(CW\*(C`verbose=1\*(C'\fR.
.Sp
If you want to run tests under the perl debugger, pass the argument
\&\f(CW\*(C`debugger=1\*(C'\fR.
.Sp
In addition, if a file called \f(CW\*(C`visual.pl\*(C'\fR exists in the top-level
directory, this file will be executed as a Perl script and its output
will be shown to the user.  This is a good place to put speed tests or
other tests that don't use the \f(CW\*(C`Test::Harness\*(C'\fR format for output.
.Sp
To override the choice of tests to run, you may pass a \f(CW\*(C`test_files\*(C'\fR
argument whose value is a whitespace-separated list of test scripts to
run.  This is especially useful in development, when you only want to
run a single test to see whether you've squashed a certain bug yet:
.Sp
.Vb 1
\&  ./Build test \-\-test_files t/something_failing.t
.Ve
.Sp
You may also pass several \f(CW\*(C`test_files\*(C'\fR arguments separately:
.Sp
.Vb 1
\&  ./Build test \-\-test_files t/one.t \-\-test_files t/two.t
.Ve
.Sp
or use a \f(CW\*(C`glob()\*(C'\fR\-style pattern:
.Sp
.Vb 1
\&  ./Build test \-\-test_files \*(Aqt/01\-*.t\*(Aq
.Ve
.IP "testall" 4
.IX Item "testall"
[verion 0.2807]
.Sp
[Note: the 'testall' action and the code snippets below are currently
in alpha stage, see
\&\*(L"/www.nntp.perl.org/group/perl.module.build/2007/03/msg584.html\*(R"\*(L" in \*(R"http: ]
.Sp
Runs the \f(CW\*(C`test\*(C'\fR action plus each of the \f(CW\*(C`test$type\*(C'\fR actions defined by
the keys of the \f(CW\*(C`test_types\*(C'\fR parameter.
.Sp
Currently, you need to define the ACTION_test$type method yourself and
enumerate them in the test_types parameter.
.Sp
.Vb 12
\&  my $mb = Module::Build\->subclass(
\&    code => q(
\&      sub ACTION_testspecial { shift\->generic_test(type => \*(Aqspecial\*(Aq); }
\&      sub ACTION_testauthor  { shift\->generic_test(type => \*(Aqauthor\*(Aq); }
\&    )
\&  )\->new(
\&    ...
\&    test_types  => {
\&      special => \*(Aq.st\*(Aq,
\&      author  => \*(Aq.at\*(Aq,
\&    },
\&    ...
.Ve
.IP "testcover" 4
.IX Item "testcover"
[version 0.26]
.Sp
Runs the \f(CW\*(C`test\*(C'\fR action using \f(CW\*(C`Devel::Cover\*(C'\fR, generating a
code-coverage report showing which parts of the code were actually
exercised during the tests.
.Sp
To pass options to \f(CW\*(C`Devel::Cover\*(C'\fR, set the \f(CW$DEVEL_COVER_OPTIONS\fR
environment variable:
.Sp
.Vb 1
\&  DEVEL_COVER_OPTIONS=\-ignore,Build ./Build testcover
.Ve
.IP "testdb" 4
.IX Item "testdb"
[version 0.05]
.Sp
This is a synonym for the 'test' action with the \f(CW\*(C`debugger=1\*(C'\fR
argument.
.IP "testpod" 4
.IX Item "testpod"
[version 0.25]
.Sp
This checks all the files described in the \f(CW\*(C`docs\*(C'\fR action and 
produces \f(CW\*(C`Test::Harness\*(C'\fR\-style output.  If you are a module author,
this is useful to run before creating a new release.
.IP "testpodcoverage" 4
.IX Item "testpodcoverage"
[version 0.28]
.Sp
This checks the pod coverage of the distribution and 
produces \f(CW\*(C`Test::Harness\*(C'\fR\-style output. If you are a module author,
this is useful to run before creating a new release.
.IP "versioninstall" 4
.IX Item "versioninstall"
[version 0.16]
.Sp
** Note: since \f(CW\*(C`only.pm\*(C'\fR is so new, and since we just recently added
support for it here too, this feature is to be considered
experimental. **
.Sp
If you have the \f(CW\*(C`only.pm\*(C'\fR module installed on your system, you can
use this action to install a module into the version-specific library
trees.  This means that you can have several versions of the same
module installed and \f(CW\*(C`use\*(C'\fR a specific one like this:
.Sp
.Vb 1
\&  use only MyModule => 0.55;
.Ve
.Sp
To override the default installation libraries in \f(CW\*(C`only::config\*(C'\fR,
specify the \f(CW\*(C`versionlib\*(C'\fR parameter when you run the \f(CW\*(C`Build.PL\*(C'\fR script:
.Sp
.Vb 1
\&  perl Build.PL \-\-versionlib /my/version/place/
.Ve
.Sp
To override which version the module is installed as, specify the
\&\f(CW\*(C`versionlib\*(C'\fR parameter when you run the \f(CW\*(C`Build.PL\*(C'\fR script:
.Sp
.Vb 1
\&  perl Build.PL \-\-version 0.50
.Ve
.Sp
See the \f(CW\*(C`only.pm\*(C'\fR documentation for more information on
version-specific installs.
.SH "OPTIONS"
.IX Header "OPTIONS"