view release on metacpan or  search on metacpan

lib/CPANPLUS/Dist/Debora.pm  view on Meta::CPAN

The Debian package epochs are read from F</var/lib/dpkg/available>.

=head2 Environment variables

=head3 BUILD

The build number that is added to packages as a Debian revision or RPM
release.  Defaults to 1.

As packages may be built recursively, setting this variable is mainly useful
when all packages are rebuilt after Perl has been upgraded.

=head3 EPOCH

On RPM-based systems, you might have to set the package epoch manually as
there is no standardized database that can be queried for epochs.  On
Debian-based systems, it is generally not necessary to set epochs manually.
Defaults to no package epoch.

=head3 DEBFULLNAME, NAME, GITLAB_USER_NAME

The packager's name.

=head3 DEBEMAIL, EMAIL, GITLAB_USER_EMAIL

The packager's email address.

If the packager's name is unavailable and if the email address has got the
format "name <address>", the name is taken from the email address.

If the packager's name cannot be extracted from the environment, the name is
taken from the gecos field in the password database.

=head3 INSTALLDIRS

The installation location.  Can be "vendor" or "site".  Defaults to "vendor".

=head3 SOURCE_DATE_EPOCH

Clamps timestamps to the specified Unix time.  If not set, the last
modification time of the source is used.

=head1 DEPENDENCIES

Requires Perl 5.16 and the modules L<CPANPLUS>, L<CPANPLUS::Dist::Build>,
L<Module::Pluggable>, L<Software::License> and L<Text::Template> from CPAN.
L<IPC::Run> and L<Term::ReadLine::Gnu> are recommended.

On Debian-based systems, install the packages "perl", "build-essential",
"debhelper", "fakeroot" and "sudo".  The minimum supported debhelper version
is 12.

On RPM-based systems, install the packages "perl", "rpm-build", "gcc", "make",
"sudo" and, if available, "perl-devel" and "perl-generators".

=head1 INCOMPATIBILITIES

None.

=head1 BUGS AND LIMITATIONS

You have to install the appropriate development packages yourself if you would
like to build Perl distributions that require C libraries.  For example,
install the package "libssl-dev" or "openssl-devel" if the distribution uses
the OpenSSL libraries.

Enable C<verbose> mode (see above) if you would like to get feedback while
CPANPLUS downloads the list of Perl distributions from the Comprehensive Perl
Archive Network (CPAN).  Use L<CPAN::Mini> or a repository manager to mirror
the CPAN locally.

Some Perl distributions fail to show interactive prompts if the C<verbose>
option is not set.

L<Software::LicenseUtils> recognizes a lot of common licenses but isn't
perfect.

=head1 SEE ALSO

cpanp(1), cpan2dist(1), sudo(8)

=head1 AUTHOR

Andreas Vögele E<lt>voegelas@cpan.orgE<gt>

=head1 LICENSE AND COPYRIGHT

Copyright (C) 2025 Andreas Vögele

This module is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.

=cut