X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=x2p%2Fa2p.pod;h=4b66771b36173e616dfb16d44f09925b6e597819;hb=cd22a09c8c81e5e4c639c15ad19704a0d1e0c842;hp=3976abab67e6bba0520ec0e7354edb83f67d0e4a;hpb=53282e287735a6e6bbd7d90f4eb790c61d232d6e;p=p5sagit%2Fp5-mst-13.2.git

diff --git a/x2p/a2p.pod b/x2p/a2p.pod
index 3976aba..4b66771 100644
--- a/x2p/a2p.pod
+++ b/x2p/a2p.pod
@@ -4,7 +4,7 @@ a2p - Awk to Perl translator
 
 =head1 SYNOPSIS
 
-B<a2p [options] filename>
+B<a2p> [I<options>] [I<filename>]
 
 =head1 DESCRIPTION
 
@@ -12,7 +12,7 @@ I<A2p> takes an awk script specified on the command line (or from
 standard input) and produces a comparable I<perl> script on the
 standard output.
 
-=head2 Options
+=head2 OPTIONS
 
 Options include:
 
@@ -41,6 +41,29 @@ Any delimiter can be used to separate the field names.
 
 causes a2p to assume that input will always have that many fields.
 
+=item B<-o>
+
+tells a2p to use old awk behavior.  The only current differences are:
+
+=over 5
+
+=item *
+
+Old awk always has a line loop, even if there are no line
+actions, whereas new awk does not.
+
+=item *
+
+In old awk, sprintf is extremely greedy about its arguments.
+For example, given the statement
+
+	print sprintf(some_args), extra_args;
+
+old awk considers I<extra_args> to be arguments to C<sprintf>; new awk
+considers them arguments to C<print>.
+
+=back
+
 =back
 
 =head2 "Considerations"
@@ -82,13 +105,13 @@ block to bypass the block under such circumstances can be simplified
 by removing the conditional in the END block and just exiting directly
 from the perl script.
 
-Perl has two kinds of array, numerically-indexed and associative.  Awk
-arrays are usually translated to associative arrays, but if you happen
-to know that the index is always going to be numeric you could change
-the {...} to [...].  Iteration over an associative array is done using
-the keys() function, but iteration over a numeric array is NOT.  You
-might need to modify any loop that is iterating over the array in
-question.
+Perl has two kinds of array, numerically-indexed and associative.
+Perl associative arrays are called "hashes".  Awk arrays are usually
+translated to hashes, but if you happen to know that the index is
+always going to be numeric you could change the {...} to [...].
+Iteration over a hash is done using the keys() function, but iteration
+over an array is NOT.  You might need to modify any loop that iterates
+over such an array.
 
 Awk starts by assuming OFMT has the value %.6g.  Perl starts by
 assuming its equivalent, $#, to have the value %.20g.  You'll want to
@@ -134,7 +157,7 @@ A2p uses no environment variables.
 
 =head1 AUTHOR
 
-Larry Wall E<lt>F<lwall@jpl-devvax.Jpl.Nasa.Gov>E<gt>
+Larry Wall E<lt>F<larry@wall.org>E<gt>
 
 =head1 FILES