better docs for hide

1 files changed, 11 insertions, 6 deletions

diff --git a/lib/circular/require.pm b/lib/circular/require.pm
index f398743..eb1f21d 100644
--- a/lib/circular/require.pm
+++ b/lib/circular/require.pm
@@ -21,12 +21,6 @@ or
 
   perl -M-circular::require foo.pl
 
-or to hide loaders such as base.pm or parent.pm Any package name(s) can be
-used.
-
-  no circular::require hide => [ qw/base parent/ ];
-
-
 =head1 DESCRIPTION
 
 Perl by default just ignores cycles in require statements - if Foo.pm does
@@ -41,6 +35,17 @@ load time (C<make_immutable> in L<Moose> classes, for example). This module
 generates a warning whenever a module is skipped due to being loaded, if that
 module has not finished executing.
 
+In some situations, other modules might be handling the module loading for
+you - C<use base> and C<Class::Load::load_class>, for instance. To avoid these
+modules showing up as the source of cycles, you can use the C<hide> parameter
+when using this module. For example:
+
+  no circular::require hide => [qw(base parent Class::Load)];
+
+or
+
+  perl -M'-circular::require hide => [qw(base parent Class::Load)];' foo.pl
+
 =cut
 
 my %seen;