=head1 Name
sqitch-bundle - Bundle a Sqitch project for distribution
=head1 Synopsis
sqitch [options] bundle project
sqitch [options] bundle --dest-dir widgets-1.0.0
=head1 Description
This command bundles up a sqitch project for distribution. At its simplest, it
copies the project configuration file, the plan file, and all of the change
scripts to a directory. This directory can then be packaged up for
distribution (as a tarball, RPM, etc.). Options allow for the list of changes
to be bundled to be a subset of the plan.
=head1 Options
=over
=item C<--dest-dir>
The name of the directory in which to bundle the project. The configuration
file will be created in this directory, and the top, deploy, revert, and verify
directories will be created relative to it. Defaults to F<bundle>.
=item C<--from>
The change from which to start bundling. If you need to bundle up only a subset
of your plan, specify a change (using a supported L<change specification|sqitchchanges>
from which to start the bundling via this option.
=item C<--to>
The change to which to end bundling. If you need to bundle up only a subset
of your plan, specify a change (using a supported L<change specification|sqitchchanges>
that should be the last change to be included in the bundle.
=back
=head1 Configuration Variables
=over
=item C<bundle.dest_dir>
The name of the directory in which to bundle the project.
=back
=head1 Examples
Bundle a Sqitch project into F<BUILDROOT/MyProj>:
sqitch bundle --dest-dir BUILDROOT/MyProj
Bundle a project including changes C<adduser> through C<@v1.0>:
sqitch bundle --from adduser --to @v1.0
=head1 Sqitch
Part of the L<sqitch> suite.