Browse files

Tweaks to usage docs

  • Loading branch information...
1 parent 27af674 commit 09d66bcabfe0daddd3e733b33c922d97e99bb348 @timbunce timbunce committed Dec 5, 2011
Showing with 11 additions and 1 deletion.
  1. +11 −1 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
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.
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

0 comments on commit 09d66bc

Please sign in to comment.