Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Tweaks to usage docs

  • Loading branch information...
commit 09d66bcabfe0daddd3e733b33c922d97e99bb348 1 parent 27af674
@timbunce timbunce authored
Showing with 11 additions and 1 deletion.
  1. +11 −1 bin/dist_surveyor
View
12 bin/dist_surveyor
@@ -72,7 +72,7 @@ Some additional files are written into a dist_surveyor subdirectory:
This file lists one unique 'token package' per distribution. It's very useful
to speed up re-running a full install after some distributions have failed.
-=head1 USAGE
+=head1 SURVEY USAGE
Run a survey and create a mini-CPAN repository containing the distributions:
@@ -83,6 +83,8 @@ It's important to give the correct perl lib directory path.
It's important to check the results related to any modules that generated
warnings during the run.
+=head1 INSTALLATION USAGE
+
Then, to install those distributions into a new library:
cpanm --mirror file:$PWD/my_cpan --mirror-only [-l new_lib] < installed_dists.txt
@@ -101,6 +103,14 @@ with cpanm:
cpanm --mirror file:$PWD/my_cpan --mirror-only [-l new_lib] < my_cpan/dist_surveyor/token_packages.txt
+When a distro fails tests I use the cpanm C<--look> option to investigate:
+
+ cpanm --mirror file:$PWD/my_cpan --mirror-only --look Some::Package
+
+I'll often end up building, testing and installing the distro from within that
+cpanm look shell. Once installed I'll rerun cpanm using the full C<token_packages.txt>
+file again. If there are more failures I'll repeat that sequence till they're all resolved.
+
=head1 BUGS
Probably.
Please sign in to comment.
Something went wrong with that request. Please try again.