Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

core-cpan-diff: Make Options Display Consistently in Usage Output #21409

Merged
merged 1 commit into from
Sep 6, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
38 changes: 19 additions & 19 deletions Porting/core-cpan-diff
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ use Archive::Tar;
use Cwd qw[cwd chdir];
use IPC::Open3;
use IO::Select;
local $Archive::Tar::WARN=0;
local $Archive::Tar::WARN = 0;

# where, under the cache dir, to download tarballs to
use constant SRC_DIR => 'tarballs';
Expand All @@ -45,34 +45,34 @@ sub usage {
print STDERR <<HERE;
Usage: $0 [opts] [ -d | -v | -x ] [ -a | module ... ]

-a/--all Scan all dual-life modules.
-a/--all Scan all dual-life modules.

-c/--cachedir Where to save downloaded CPAN tarball files
(defaults to /tmp/something/ with deletion after each run).
-c/--cachedir Where to save downloaded CPAN tarball files
(defaults to /tmp/something/ with deletion after each run).

-d/--diff Display file differences using diff(1), rather than just
listing which files have changed.
-d/--diff Display file differences using diff(1), rather than just
listing which files have changed.

--diffopts Options to pass to the diff command. Defaults to '-u --text'
(except on *BSD, where it's just '-u').
--diffopts Options to pass to the diff command. Defaults to '-u --text'
(except on *BSD, where it's just '-u').

-f|force Force download from CPAN of new 02packages.details.txt file
(with --crosscheck only).
-f/--force Force download from CPAN of new 02packages.details.txt file
jkeenan marked this conversation as resolved.
Show resolved Hide resolved
(with --crosscheck only).

-m|mirror Preferred CPAN mirror URI (http:// or file:///)
(Local mirror must be a complete mirror, not minicpan)
-m/--mirror Preferred CPAN mirror URI (http:// or file:///)
(Local mirror must be a complete mirror, not minicpan)

-o/--output File name to write output to (defaults to STDOUT).
-o/--output File name to write output to (defaults to STDOUT).

-r/--reverse Reverses the diff (perl to CPAN).
-r/--reverse Reverses the diff (perl to CPAN).

-u/--upstream only print modules with the given upstream (defaults to all)
-u/--upstream Only print modules with the given upstream (defaults to all)

-v/--verbose List the fate of *all* files in the tarball, not just those
that differ or are missing.
-v/--verbose List the fate of *all* files in the tarball, not just those
that differ or are missing.

-x|crosscheck List the distributions whose current CPAN version differs from
that in blead (i.e. the DISTRIBUTION field in Maintainers.pl).
-x/--crosscheck List the distributions whose current CPAN version differs from
that in blead (i.e. the DISTRIBUTION field in Maintainers.pl).

By default (i.e. without the --crosscheck option), for each listed module
(or with -a, all CPAN modules listed in Maintainers.pl), grab the tarball
Expand Down