#!/usr/bin/perl
#
# dpkg-source
#
# Copyright © 1996 Ian Jackson <ijackson@chiark.greenend.org.uk>
# Copyright © 1997 Klee Dienes <klee@debian.org>
# Copyright © 1999-2003 Wichert Akkerman <wakkerma@debian.org>
# Copyright © 1999 Ben Collins <bcollins@debian.org>
# Copyright © 2000-2003 Adam Heath <doogie@debian.org>
# Copyright © 2005 Brendan O'Dea <bod@debian.org>
# Copyright © 2006-2008 Frank Lichtenheld <djpig@debian.org>
# Copyright © 2006-2009,2012 Guillem Jover <guillem@debian.org>
# Copyright © 2008-2011 Raphaël Hertzog <hertzog@debian.org>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <https://www.gnu.org/licenses/>.

use v5.36;

use List::Util qw(any none);
use Cwd;
use File::Basename;
use File::Spec;

use Dpkg ();
use Dpkg::Gettext;
use Dpkg::ErrorHandling;
use Dpkg::Arch qw(:operators);
use Dpkg::BuildProfiles qw(
    parse_build_profiles
);
use Dpkg::Deps;
use Dpkg::Compression;
use Dpkg::Conf;
use Dpkg::Control::Info;
use Dpkg::Control::Tests;
use Dpkg::Control::Fields;
use Dpkg::Substvars;
use Dpkg::Version;
use Dpkg::Package;
use Dpkg::Changelog::Parse;
use Dpkg::Source::Format;
use Dpkg::Source::Package qw(get_default_diff_ignore_regex
                             set_default_diff_ignore_regex
                             get_default_tar_ignore_pattern);
use Dpkg::Vendor qw(run_vendor_hook);

textdomain('dpkg-dev');

my $controlfile;
my $changelogformat;

my $build_format;
my %options = (
    # Ignore files.
    tar_ignore => [],
    diff_ignore_regex => '',
    # Misc options.
    copy_orig_tarballs => 1,
    no_check => 0,
    no_overwrite_dir => 1,
    use_vendor_certs => 1,
    require_valid_signature => 0,
    require_strong_checksums => 0,
    certs => [],
);

# Fields to remove/override.
my %remove;
my %override;

my $substvars = Dpkg::Substvars->new();
my $tar_ignore_default_pattern_done;
my $diff_ignore_regex = get_default_diff_ignore_regex();

my @options;
my @cmdline_options;
while (@ARGV && $ARGV[0] =~ m/^-/) {
    my $arg = shift @ARGV;

    if ($arg eq '-b' or $arg eq '--build') {
        setopmode('build');
    } elsif ($arg eq '-x' or $arg eq '--extract') {
        setopmode('extract');
    } elsif ($arg eq '--before-build') {
        setopmode('before-build');
    } elsif ($arg eq '--after-build') {
        setopmode('after-build');
    } elsif ($arg eq '--commit') {
        setopmode('commit');
    } elsif ($arg eq '--print-format') {
        setopmode('print-format');
        # Avoid clutter on stdout.
        report_options(info_fh => \*STDERR);
    } else {
        push @options, $arg;
    }
}

my $dir;
my $basedir = '.';
if (defined($options{opmode}) &&
    $options{opmode} =~ /^(build|print-format|(before|after)-build|commit)$/) {
    if (not scalar(@ARGV)) {
        usageerr(g_('--%s needs a directory'), $options{opmode})
            unless $1 eq 'commit';
        $dir = '.';
    } else {
        $dir = File::Spec->catdir(shift(@ARGV));
    }
    stat($dir) or syserr(g_('cannot stat directory %s'), $dir);
    if (not -d $dir) {
        error(g_('directory argument %s is not a directory'), $dir);
    }
    my $curdir = getcwd();
    if ($dir eq '.' || Cwd::realpath($dir) eq $curdir) {
        # «.» is never correct, adjust automatically.
        $dir = $curdir;
        $basedir = File::Spec->updir();
    }
    # --format options are not allowed, they would take precedence
    # over real command line options, debian/source/format should be used
    # instead.
    # --unapply-patches is only allowed in local-options as it is a matter
    # of personal taste and the default should be to keep patches applied.
    my $forbidden_opts_regex = {
        'options' => qr/^--(?:format=|unapply-patches$|abort-on-upstream-changes$)/,
        'local-options' => qr/^--format=/,
    };
    foreach my $filename ('local-options', 'options') {
        my $conf = Dpkg::Conf->new();
        my $optfile = File::Spec->catfile($dir, 'debian', 'source', $filename);
        next unless -f $optfile;
        $conf->load($optfile);
        $conf->filter(
            remove => sub { $_[0] =~ $forbidden_opts_regex->{$filename} },
        );
        if (@$conf) {
            info(g_('using options from %s: %s'), $optfile, join(' ', @$conf))
                unless $options{opmode} eq 'print-format';
            unshift @options, @$conf;
        }
    }
}

while (@options) {
    $_ = shift(@options);
    if (m/^--format=(.*)$/) {
        $build_format //= $1;
    } elsif (m/^-(?:Z|-compression=)(.*)$/) {
        my $compression = $1;
        $options{compression} = $compression;
        usageerr(g_('%s is not a supported compression'), $compression)
            unless compression_is_supported($compression);
        compression_set_default($compression);
    } elsif (m/^-(?:z|-compression-level=)(.*)$/) {
        my $comp_level = $1;
        $options{comp_level} = $comp_level;
        usageerr(g_('%s is not a compression level'), $comp_level)
            unless compression_is_valid_level($comp_level);
        compression_set_default_level($comp_level);
    } elsif (m/^--threads-max=(.*)$/) {
        my $threads = $1;
        $options{comp_threads} = $threads;
        compression_set_threads($threads);
    } elsif (m/^-c(.*)$/) {
        $controlfile = $1;
    } elsif (m/^-l(.*)$/) {
        $options{changelog_file} = $1;
    } elsif (m/^-F([0-9a-z]+)$/) {
        $changelogformat = $1;
    } elsif (m/^-D([^\=:]+)[=:](.*)$/s) {
        $override{$1} = $2;
    } elsif (m/^-U([^\=:]+)$/) {
        $remove{$1} = 1;
    } elsif (m/^--diff-ignore$/) {
        $options{diff_ignore_regex} = $diff_ignore_regex;
    } elsif (m/^-(?:i|-diff-ignore=)(.*)$/) {
        $options{diff_ignore_regex} = $1 ? $1 : $diff_ignore_regex;
    } elsif (m/^--extend-diff-ignore=(.+)$/) {
        $diff_ignore_regex .= "|$1";
        if ($options{diff_ignore_regex}) {
            $options{diff_ignore_regex} .= "|$1";
        }
        set_default_diff_ignore_regex($diff_ignore_regex);
    } elsif (m/^-(?:I|-tar-ignore=)(.+)$/) {
        push @{$options{tar_ignore}}, $1;
    } elsif (m/^-(?:I|-tar-ignore)$/) {
        unless ($tar_ignore_default_pattern_done) {
            push @{$options{tar_ignore}}, get_default_tar_ignore_pattern();
            # Prevent adding multiple times.
            $tar_ignore_default_pattern_done = 1;
        }
    } elsif (m/^--no-copy$/) {
        $options{copy_orig_tarballs} = 0;
    } elsif (m/^--no-check$/) {
        $options{no_check} = 1;
    } elsif (m/^--no-overwrite-dir$/) {
        $options{no_overwrite_dir} = 1;
    } elsif (m/^--no-vendor-certs$/) {
        $options{use_vendor_certs} = 0;
    } elsif (m/^--signer-certs=(.*)$/) {
        push @{$options{certs}}, $1;
    } elsif (m/^--require-valid-signature$/) {
        $options{require_valid_signature} = 1;
    } elsif (m/^--require-strong-checksums$/) {
        $options{require_strong_checksums} = 1;
    } elsif (m/^-V(\w[-:0-9A-Za-z]*)[=:](.*)$/s) {
        $substvars->set($1, $2);
    } elsif (m/^-T(.*)$/) {
        $substvars->load($1) if -e $1;
    } elsif (m/^-(?:\?|-help)$/) {
        usage();
        exit(0);
    } elsif (m/^--version$/) {
        version();
        exit(0);
    } elsif (m/^-[EW]$/) {
        # Deprecated option.
        warning(g_('-E and -W are deprecated, they are without effect'));
    } elsif (m/^-q$/) {
        report_options(quiet_warnings => 1);
        $options{quiet} = 1;
    } elsif (m/^--$/) {
        last;
    } else {
        push @cmdline_options, $_;
    }
}

unless (defined($options{opmode})) {
    usageerr(g_('need an action option'));
}

if ($options{opmode} =~ /^(build|print-format|(before|after)-build|commit)$/) {
    $options{ARGV} = \@ARGV;
    $options{changelog_file} ||= "$dir/debian/changelog";
    $controlfile ||= "$dir/debian/control";

    my %ch_options = (
        filename => $options{changelog_file},
    );
    $ch_options{changelogformat} = $changelogformat if $changelogformat;
    my $changelog = changelog_parse(%ch_options);
    my $control = Dpkg::Control::Info->new($controlfile);

    # <https://reproducible-builds.org/specs/source-date-epoch/>
    $ENV{SOURCE_DATE_EPOCH} ||= $changelog->{timestamp} || time;

    # Select the format to use.
    if (not defined $build_format) {
        my $format_file = "$dir/debian/source/format";
        if (-e $format_file) {
            my $format = Dpkg::Source::Format->new(filename => $format_file);
            $build_format = $format->get();
        } else {
            warning(g_('no source format specified in %s, ' .
                       'see dpkg-source(1)'), 'debian/source/format')
                if $options{opmode} eq 'build';
            $build_format = '1.0';
        }
    }

    my $srcpkg = Dpkg::Source::Package->new(
        format => $build_format,
        basedir => $basedir,
        options => \%options,
    );
    my $fields = $srcpkg->{fields};

    $srcpkg->parse_cmdline_options(@cmdline_options);

    my @sourcearch;
    my %archadded;
    my @binarypackages;

    # Scan control info of source package.
    my $src_fields = $control->get_source();
    error(g_('%s does not contain any information about the source package'),
          $controlfile) unless defined $src_fields;
    foreach my $f (keys %{$src_fields}) {
        my $v = $src_fields->{$f};

        if ($f eq 'Source') {
            set_source_name($v);
            $fields->{$f} = $v;
        } elsif ($f eq 'Uploaders') {
            # Merge in a single-line.
            ($fields->{$f} = $v) =~ s/\s*[\r\n]\s*/ /g;
        } elsif (any { $f eq $_ } field_list_src_dep()) {
            my $dep;
            my $type = field_get_dep_type($f);
            $dep = deps_parse($v,
                build_dep => 1,
                union => $type eq 'union',
            );
            error(g_('cannot parse %s field'), $f) unless defined $dep;
            my $facts = Dpkg::Deps::KnownFacts->new();
            $dep->simplify_deps($facts);
            $dep->sort() if $type eq 'union';
            $fields->{$f} = $dep->output();
        } else {
            field_transfer_single($src_fields, $fields, $f);
        }
    }

    # Scan control info of binary packages.
    my @pkglist;
    foreach my $pkg ($control->get_packages()) {
        my $p = $pkg->{'Package'};

        my %pkg_prop;
        foreach my $f (qw(Section Priority)) {
            $pkg_prop{lc $f} = $pkg->{$f} || $src_fields->{$f} ||
                               field_get_default_value($f);
        }
        $pkg_prop{type} = $pkg->{'Package-Type'} ||
            $pkg->get_custom_field('Package-Type') || 'deb';

        $pkg_prop{arch} = join ',', split ' ', $pkg->{'Architecture'};

        my $profiles = $pkg->{'Build-Profiles'};
        if (defined $profiles) {
            my @restrictions = parse_build_profiles($profiles);

            # Restriction formulas are in disjunctive formal form:
            #   (foo AND bar) OR (blub AND bla)

            # Generate the _deprecated_ version 0 property:
            #   Join lists with a plus (OR).
            #   Join their elements with a comma (AND).
            # TODO: Remove once no known users are around.
            $pkg_prop{profile} = join '+', map {
                join ',', $_->@*
            } @restrictions;

            # Generate the version 1 property:
            #   Join lists with a pipe (OR).
            #   Join their elements with an ampersand (AND).
            $pkg_prop{'profile:v1'} = join '|', map {
                join '&', $_->@*
            } @restrictions;
        }

        # Handle optional boolean fields.
        foreach my $f (qw(Protected Essential)) {
            if (defined $pkg->{$f} and $pkg->{$f} eq 'yes') {
                $pkg_prop{lc $f} = 'yes';
            }
        }

        # Generate the package list properties.
        my $pkg_summary = join ' ', $p, @pkg_prop{qw(type section priority)};
        foreach my $prop (qw(arch profile profile:v1 protected essential)) {
            next unless exists $pkg_prop{$prop};
            $pkg_summary .= " $prop=$pkg_prop{$prop}";
        }
        push @pkglist, $pkg_summary;

        push @binarypackages, $p;
        foreach my $f (keys %{$pkg}) {
            my $v = $pkg->{$f};

            if ($f eq 'Architecture') {
                # Gather all binary architectures in one set. 'any' and 'all'
                # are special-cased as they need to be the only ones in the
                # current stanza if present.
                if (debarch_eq($v, 'any') || debarch_eq($v, 'all')) {
                    push(@sourcearch, $v) unless $archadded{$v}++;
                } else {
                    for my $a (split(/\s+/, $v)) {
                        error(g_("'%s' is not a valid architecture string " .
                                 "in package '%s'"), $a, $p)
                            if debarch_is_invalid($a);
                        error(g_('architecture %s only allowed on its ' .
                                 "own (list for package %s is '%s')"),
                              $a, $p, $a)
                            if $a eq 'any' or $a eq 'all';
                        push(@sourcearch, $a) unless $archadded{$a}++;
                    }
                }
            } elsif (any { $f eq $_ } qw(Homepage Description)) {
                # Do not overwrite the same field from the source entry.
            } else {
                field_transfer_single($pkg, $fields, $f);
            }
        }
    }
    unless (scalar(@pkglist)) {
        error(g_('%s does not list any binary package'), $controlfile);
    }
    if (any { $_ eq 'any' } @sourcearch) {
        # If we encounter one 'any' then the other arches become insignificant
        # except for 'all' that must also be kept.
        if (any { $_ eq 'all' } @sourcearch) {
            @sourcearch = qw(any all);
        } else {
            @sourcearch = qw(any);
        }
    } else {
        # Minimize arch list, by removing arches already covered by wildcards.
        my @arch_wildcards = grep { debarch_is_wildcard($_) } @sourcearch;
        my @mini_sourcearch = @arch_wildcards;
        foreach my $arch (@sourcearch) {
            if (none { debarch_is($arch, $_) } @arch_wildcards) {
                push @mini_sourcearch, $arch;
            }
        }
        @sourcearch = @mini_sourcearch;
    }
    $fields->{'Architecture'} = join(' ', @sourcearch);
    $fields->{'Package-List'} = "\n" . join("\n", sort @pkglist);

    # Check if we have a testsuite, and handle manual and automatic values.
    set_testsuite_fields($fields, @binarypackages);

    # Scan fields of dpkg-parsechangelog.
    foreach my $f (keys %{$changelog}) {
        my $v = $changelog->{$f};

        if ($f eq 'Source') {
            set_source_name($v);
            $fields->{$f} = $v;
        } elsif ($f eq 'Version') {
            my ($ok, $error) = version_check($v);
            error($error) unless $ok;
            $fields->{$f} = $v;
        } elsif ($f eq 'Binary-Only') {
            error(g_('building source for a binary-only release'))
                if $v eq 'yes' and $options{opmode} eq 'build';
        } elsif ($f eq 'Maintainer') {
            # Do not replace the field coming from the source entry.
        } else {
            field_transfer_single($changelog, $fields, $f);
        }
    }

    my $maint;
    if (length $fields->{'Maintainer'}) {
        $maint = field_parse_maintainer($fields);
        $fields->{'Maintainer'} = $maint->as_string();
    }

    if (length $fields->{'Uploaders'}) {
        my $uploaders = field_parse_uploaders($fields);
        $fields->{'Uploaders'} = $uploaders->as_string();

        if (defined $maint && $uploaders->contains($maint)) {
            warning(g_('%s field contains the maintainer address'), 'Uploaders');
        }
    }

    $fields->{'Binary'} = join(', ', @binarypackages);
    # Avoid overly long line by splitting over multiple lines.
    if (length($fields->{'Binary'}) > 980) {
        $fields->{'Binary'} =~ s/(.{0,980}), ?/$1,\n/g;
    }

    if ($options{opmode} eq 'print-format') {
        print $fields->{'Format'} . "\n";
        exit(0);
    } elsif ($options{opmode} eq 'before-build') {
        $srcpkg->before_build($dir);
        exit(0);
    } elsif ($options{opmode} eq 'after-build') {
        $srcpkg->after_build($dir);
        exit(0);
    } elsif ($options{opmode} eq 'commit') {
        $srcpkg->commit($dir);
        exit(0);
    }

    # Verify pre-requisites are met.
    my ($res, $msg) = $srcpkg->can_build($dir);
    error(g_("cannot build with source format '%s': %s"), $build_format, $msg)
        unless $res;

    # Only -b left.
    info(g_("using source format '%s'"), $fields->{'Format'});
    run_vendor_hook('before-source-build', $srcpkg);
    # Build the files (.tar.gz, .diff.gz, etc).
    $srcpkg->build($dir);

    # Write the .dsc.
    my $dscname = File::Spec->catfile($basedir, $srcpkg->get_basename(1) . '.dsc');
    info(g_('building %s in %s'), get_source_name(), $dscname);
    $srcpkg->write_dsc(
        filename => $dscname,
        remove => \%remove,
        override => \%override,
        substvars => $substvars,
    );
    exit(0);
} elsif ($options{opmode} eq 'extract') {
    # Check command line.
    unless (scalar(@ARGV)) {
        usageerr(g_('--%s needs at least one argument, the .dsc'),
                 $options{opmode});
    }
    if (scalar(@ARGV) > 2) {
        usageerr(g_('--%s takes no more than two arguments'), $options{opmode});
    }
    my $dsc = shift(@ARGV);
    if (-d $dsc) {
        usageerr(g_('--%s needs the .dsc file as first argument, not a directory'),
                 $options{opmode});
    }

    # Create the object that does everything.
    my $srcpkg = Dpkg::Source::Package->new(
        filename => $dsc,
        options => \%options,
    );

    # Parse command line options.
    $srcpkg->parse_cmdline_options(@cmdline_options);

    # Decide where to unpack.
    my $newdirectory = $srcpkg->get_basedirname();
    if (@ARGV) {
        $newdirectory = File::Spec->catdir(shift(@ARGV));
        if (-e $newdirectory) {
            error(g_('unpack target exists: %s'), $newdirectory);
        }
    }

    # Various checks before unpacking.
    unless ($options{no_check}) {
        if ($srcpkg->is_signed()) {
            $srcpkg->check_signature();
        } elsif ($options{require_valid_signature}) {
            error(g_('%s does not contain a valid OpenPGP signature'), $dsc);
        } else {
            warning(g_('extracting unsigned source package (%s)'), $dsc);
        }
        $srcpkg->check_checksums();
    }

    # Unpack the source package (delegated to Dpkg::Source::Package::*).
    info(g_('extracting %s in %s'), $srcpkg->{fields}{'Source'}, $newdirectory);
    $srcpkg->extract($newdirectory);

    exit(0);
}

sub set_testsuite_fields
{
    my ($fields, @binarypackages) = @_;

    my $testsuite_field = $fields->{'Testsuite'} // '';
    my %testsuite = map { $_ => 1 } split /\s*,\s*/, $testsuite_field;
    if (-e "$dir/debian/tests/control") {
        error(g_('test control %s is not a regular file'),
              'debian/tests/control') unless -f _;
        $testsuite{autopkgtest} = 1;

        my $tests = Dpkg::Control::Tests->new();
        $tests->load("$dir/debian/tests/control");

        set_testsuite_triggers_field($tests, $fields, @binarypackages);
    } elsif ($testsuite{autopkgtest}) {
        warning(g_("%s field contains value '%s', but no tests control file %s"),
                'Testsuite', 'autopkgtest', 'debian/tests/control');
        delete $testsuite{autopkgtest};
    }
    $fields->{'Testsuite'} = join ', ', sort keys %testsuite;
}

sub set_testsuite_triggers_field
{
    my ($tests, $fields, @binarypackages) = @_;
    my %testdeps;

    # Never overwrite a manually defined field.
    return if $fields->{'Testsuite-Triggers'};

    foreach my $test ($tests->get()) {
        if (not exists $test->{Tests} and not exists $test->{'Test-Command'}) {
            error(g_('test control %s is missing %s or %s field'),
                  'debian/tests/control', 'Tests', 'Test-Command');
        }

        next unless $test->{Depends};

        my $deps = deps_parse($test->{Depends},
            use_arch => 0,
            tests_dep => 1,
        );
        deps_iterate($deps, sub { $testdeps{$_[0]->{package}} = 1 });
    }

    # Remove our own binaries and its meta-depends variant.
    foreach my $pkg (@binarypackages, qw(@)) {
        delete $testdeps{$pkg};
    }
    $fields->{'Testsuite-Triggers'} = join ', ', sort keys %testdeps;
}

sub setopmode {
    my $opmode = shift;

    if (defined($options{opmode})) {
        usageerr(g_('two commands specified: --%s and --%s'),
                 $options{opmode}, $opmode);
    }
    $options{opmode} = $opmode;
}

sub print_option {
    my $opt = shift;

    my $help = gettext($opt->{help});
    if (length $opt->{name} > 25) {
        return sprintf "  %-25s\n%s%s.\n", $opt->{name}, ' ' x 27, $help;
    } else {
        return sprintf "  %-25s%s.\n", $opt->{name}, $help;
    }
}

sub get_format_help {
    $build_format //= '1.0';

    my $srcpkg = Dpkg::Source::Package->new(format => $build_format);

    my @cmdline = $srcpkg->describe_cmdline_options();
    return '' unless @cmdline;

    my $help_build = my $help_extract = '';
    my $help;

    foreach my $opt (@cmdline) {
        $help_build .= print_option($opt) if $opt->{when} eq 'build';
        $help_extract .= print_option($opt) if $opt->{when} eq 'extract';
    }

    if ($help_build) {
        $help .= "\n";
        $help .= "Build format $build_format options:\n";
        $help .= $help_build || C_('source options', '<none>');
    }
    if ($help_extract) {
        $help .= "\n";
        $help .= "Extract format $build_format options:\n";
        $help .= $help_extract || C_('source options', '<none>');
    }

    return $help;
}

sub version {
    printf g_("Debian %s version %s.\n"), $Dpkg::PROGNAME, $Dpkg::PROGVERSION;

    print g_('
This is free software; see the GNU General Public License version 2 or
later for copying conditions. There is NO warranty.
');
}

sub usage {
    printf g_(
'Usage: %s [<option>...] <command>')
    . "\n\n" . g_(
'Commands:
  -x, --extract <filename>.dsc [<output-dir>]
                           extract source package.
  -b, --build <dir>        build source package.
      --print-format <dir> print the format to be used for the source package.
      --before-build <dir> run the corresponding source package format hook.
      --after-build <dir>  run the corresponding source package format hook.
      --commit [<dir> [<patch-name>]]
                           store upstream changes in a new patch.')
    . "\n\n" . g_(
"Build options:
  -c<control-file>         get control info from this file.
  -l<changelog-file>       get per-version info from this file.
  -F<changelog-format>     force changelog format.
  --format=<source-format> set the format to be used for the source package.
  -V<name>=<value>         set a substitution variable.
  -T<substvars-file>       read variables here.
  -D<field>=<value>        override or add a .dsc field and value.
  -U<field>                remove a field.
  -i, --diff-ignore[=<regex>]
                           filter out files to ignore diffs of
                             (defaults to: '%s').
  -I, --tar-ignore[=<pattern>]
                           filter out files when building tarballs
                             (defaults to: %s).
  -Z, --compression=<compression>
                           select compression to use (defaults to '%s',
                             supported are: %s).
  -z, --compression-level=<level>
                           compression level to use (defaults to '%d',
                             supported are: '1'-'9', 'best', 'fast')")
    . "\n\n" . g_(
'Extract options:
  --no-copy                do not copy .orig tarballs
  --no-check               do not check signature and checksums on extraction
  --no-overwrite-dir       do not overwrite directory on extraction
  --no-vendor-certs        do not use vendor specific certificate keyrings
  --signer-certs=<keyring> use a signer certificates keyring
  --require-valid-signature
                           abort if the package does not have a valid signature
  --require-strong-checksums
                           abort if the package contains no strong checksums
  --ignore-bad-version     allow bad source package versions.')
    . "\n" .
    get_format_help()
    . "\n" . g_(
'General options:
      --threads-max=<threads>
                           use at most <threads> with compressor.
  -q                       quiet mode.
  -?, --help               show this help message.
      --version            show the version.')
    . "\n\n" . g_(
'Source format specific build and extract options are available;
use --format with --help to see them.') . "\n",
    $Dpkg::PROGNAME,
    get_default_diff_ignore_regex(),
    join(' ', map { "-I$_" } get_default_tar_ignore_pattern()),
    compression_get_default(),
    join(' ', compression_get_list()),
    compression_get_default_level();
}
