better assertion support

Message-ID: <20050613154719.29295.qmail@lists.develooper.com>

p4raw-id: //depot/perl@24832

1 files changed, 11 insertions, 5 deletions

diff --git a/pod/perlrun.pod b/pod/perlrun.pod
index 71af29ceb1..a5260a976d 100644
--- a/pod/perlrun.pod
+++ b/pod/perlrun.pod
@@ -9,7 +9,7 @@ B<perl>	S<[ B<-sTtuUWX> ]>
 	S<[ B<-cw> ] [ B<-d>[B<t>][:I<debugger>] ] [ B<-D>[I<number/list>] ]>
 	S<[ B<-pna> ] [ B<-F>I<pattern> ] [ B<-l>[I<octal>] ] [ B<-0>[I<octal/hexadecimal>] ]>
 	S<[ B<-I>I<dir> ] [ B<-m>[B<->]I<module> ] [ B<-M>[B<->]I<'module...'> ]>
-	S<[ B<-A [I<assertions>] >]>
+	S<[ B<-A>[I<module>][=I<assertions>] ]>
 	S<[ B<-C [I<number/list>] >]>
 	S<[ B<-P> ]>
 	S<[ B<-S> ]>
@@ -256,11 +256,17 @@ format: C<-0xHHH...>, where the C<H> are valid hexadecimal digits.
 (This means that you cannot use the C<-x> with a directory name that
 consists of hexadecimal digits.)
 
-=item B<-A [I<assertions>]>
+=item B<-A[I<module>][=I<assertions>]>
 
-Activates the assertions given after the switch as a comma-separated
-list of assertion names. If no assertion name is given, activates all
-assertions. See L<assertions>.
+Activates the assertions given after the equal sign as a comma-separated
+list of assertion names or regular expressions. If no assertion name
+is given, activates all assertions.
+
+The module L<assertions::activate> is used by default to activate the
+selected assertions. An alternate module may be specified including
+its name between the switch and the equal sign.
+
+See L<assertions> and L<assertions::activate>.
 
 =item B<-a>