Copy and format for POD docu from Aspersa User's Manual to forked Aspersa tools.

bin/pt-rel

@@ -53,7 +53,6 @@ while ( my $line = <$fh> ) {
    }
 }
 
-
 close $fh or warn "Cannot close $file: $OS_ERROR";
 exit;
 
@@ -61,14 +60,17 @@ exit;
 
 =head1 NAME
 
-rel - Make each number in a line of text relative to the previous matching line.
+pt-rel - Relativize values to previous matching lines.
 
 =head1 SYNOPSIS
 
-Given a file with some lines of text that follow a repeated pattern, including
-numbers,
+Usage: pt-rel [FILES]
 
-  rel /path/to/file.txt
+pt-rel matches lines and subtracts the value of the previous line's values
+from the current line's values.  The lines must be text with numeric values
+that repeat, varying only the values.
+
+=head1 DESCRIPTION
 
 For example, if the text is this:
 
@@ -77,30 +79,20 @@ For example, if the text is this:
   Mutex spin waits 0, rounds 99591465498, OS waits 437698122
   RW-shared spins 834352175, OS waits 20259032; RW-excl spins 1769762980
 
-The output will be
+Then the output will be:
 
   Mutex spin waits 0, rounds 99584819933, OS waits 437663963
   RW-shared spins 834337527, OS waits 20258150; RW-excl spins 1769749834
   Mutex spin waits 0, rounds 6645565, OS waits 34159
   RW-shared spins 14648, OS waits 882; RW-excl spins 13146
 
-=head1 DOWNLOADING
+The first values (line 1) for "Mutex spin waits", "rounds", and "OS waits"
+were subtracted from the second values (line 3); the same happened for values
+from lines 2 and 4.
 
-Visit L<http://www.percona.com/software/percona-toolkit/> to download the
-latest release of Percona Toolkit.  Or, get the latest release from the
-command line:
+=head1 OPTIONS
 
-   wget percona.com/get/percona-toolkit.tar.gz
-
-   wget percona.com/get/percona-toolkit.rpm
-
-   wget percona.com/get/percona-toolkit.deb
-
-You can also get individual tools from the latest release:
-
-   wget percona.com/get/TOOL
-
-Replace C<TOOL> with the name of any tool.
+This tool does not have any command-line options.
 
 =head1 ENVIRONMENT
 
@@ -114,7 +106,7 @@ of output.
 
 =head1 SYSTEM REQUIREMENTS
 
-You need Bash.
+This tool requires Perl v5.8 or newer.
 
 =head1 BUGS
 
@@ -140,6 +132,24 @@ Include the following information in your bug report:
 If possible, include debugging output by running the tool with C<PTDEBUG>;
 see L<"ENVIRONMENT">.
 
+=head1 DOWNLOADING
+
+Visit L<http://www.percona.com/software/percona-toolkit/> to download the
+latest release of Percona Toolkit.  Or, get the latest release from the
+command line:
+
+   wget percona.com/get/percona-toolkit.tar.gz
+
+   wget percona.com/get/percona-toolkit.rpm
+
+   wget percona.com/get/percona-toolkit.deb
+
+You can also get individual tools from the latest release:
+
+   wget percona.com/get/TOOL
+
+Replace C<TOOL> with the name of any tool.
+
 =head1 AUTHORS
 
 Baron Schwartz