diff --git a/bin/pt-align b/bin/pt-align
index a17ca7b5..e6d8985f 100755
--- a/bin/pt-align
+++ b/bin/pt-align
@@ -75,6 +75,72 @@ how wide each column should be, and then prints them out.
This is useful for things like aligning the output of vmstat or iostat so it
is easier to read.
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
+
+ wget percona.com/latest/percona-toolkit/PKG
+
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
+
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
+
+=head1 ENVIRONMENT
+
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
+
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
+
+=head1 SYSTEM REQUIREMENTS
+
+You need Perl, DBI, DBD::mysql, and some core packages that ought to be
+installed in any reasonably new version of Perl.
+
+=head1 BUGS
+
+For a list of known bugs, see L.
+
+Please report bugs at L.
+Include the following information in your bug report:
+
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
+=head1 AUTHORS
+
+Baron Schwartz
+
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
+
=head1 COPYRIGHT, LICENSE, AND WARRANTY
This program is copyright 2010 Baron Schwartz, 2011 Percona Inc.
@@ -94,22 +160,8 @@ You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-=head1 AUTHORS
-
-Baron Schwartz
-
-=head1 ABOUT PERCONA TOOLKIT
-
-This tool is part of Percona Toolkit, a collection of advanced command-line
-tools used by Percona for MySQL support and consulting. Percona Toolkit
-was forked from two projects in June, 2011: Maatkit and Aspersa. Those
-projects were created by Baron Schwartz and developed primarily by him and
-Daniel Nichter, both of whom are employed by Percona. Financial support for
-Percona Toolkit development is provided by Percona and its clients. Visit
-L for more projects developed by Percona.
-
=head1 VERSION
-This manual page documents Ver @VERSION@ Distrib @DISTRIB@ $Revision: 7531 $.
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-archiver b/bin/pt-archiver
index 425e2948..976b40ae 100755
--- a/bin/pt-archiver
+++ b/bin/pt-archiver
@@ -5702,27 +5702,29 @@ A sample module might look like this:
1;
-=head1 DOWNLOADING
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
-You can download Maatkit from Google Code at
-L, or you can get any of the tools
-easily with a command like the following:
+ wget percona.com/latest/percona-toolkit/PKG
- wget http://www.maatkit.org/get/toolname
- or
- wget http://www.maatkit.org/trunk/toolname
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
-Where C can be replaced with the name (or fragment of a name) of any
-of the Maatkit tools. Once downloaded, they're ready to run; no installation is
-needed. The first URL gets the latest released version of the tool, and the
-second gets the latest trunk code from Subversion.
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
=head1 ENVIRONMENT
-The environment variable C enables verbose debugging output in all of
-the Maatkit tools:
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
- MKDEBUG=1 mk-....
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
=head1 SYSTEM REQUIREMENTS
@@ -5731,26 +5733,48 @@ installed in any reasonably new version of Perl.
=head1 BUGS
-For a list of known bugs see L.
+For a list of known bugs, see L.
-Please use Google Code Issues and Groups to report bugs or request support:
-L. You can also join #maatkit on Freenode to
-discuss Maatkit.
+Please report bugs at L.
+Include the following information in your bug report:
-Please include the complete command-line used to reproduce the problem you are
-seeing, the version of all MySQL servers involved, the complete output of the
-tool when run with L<"--version">, and if possible, debugging output produced by
-running with the C environment variable.
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
+=head1 AUTHORS
+
+Baron Schwartz
=head1 ACKNOWLEDGMENTS
-Thanks to the following people, and apologies to anyone I've omitted:
+Andrew O'Brien
-Andrew O'Brien,
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
=head1 COPYRIGHT, LICENSE, AND WARRANTY
-This program is copyright 2007-@CURRENTYEAR@ Baron Schwartz.
+This program is copyright 2007-2011 Baron Schwartz, 2011 Percona Inc.
Feedback and improvements are welcome.
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
@@ -5767,19 +5791,8 @@ You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-=head1 AUTHORS
-
-Baron Schwartz
-
-=head1 ABOUT MAATKIT
-
-This tool is part of Maatkit, a toolkit for power users of MySQL. Maatkit
-was created by Baron Schwartz; Baron and Daniel Nichter are the primary
-code contributors. Both are employed by Percona. Financial support for
-Maatkit development is primarily provided by Percona and its clients.
-
=head1 VERSION
-This manual page documents Ver @VERSION@ Distrib @DISTRIB@ $Revision: 7531 $.
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-checksum-filter b/bin/pt-checksum-filter
index 58d096be..cb6f2bae 100755
--- a/bin/pt-checksum-filter
+++ b/bin/pt-checksum-filter
@@ -1301,49 +1301,75 @@ Show version and exit.
=back
-=head1 DOWNLOADING
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
-You can download Maatkit from Google Code at
-L, or you can get any of the tools
-easily with a command like the following:
+ wget percona.com/latest/percona-toolkit/PKG
- wget http://www.maatkit.org/get/toolname
- or
- wget http://www.maatkit.org/trunk/toolname
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
-Where C can be replaced with the name (or fragment of a name) of any
-of the Maatkit tools. Once downloaded, they're ready to run; no installation is
-needed. The first URL gets the latest released version of the tool, and the
-second gets the latest trunk code from Subversion.
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
=head1 ENVIRONMENT
-The environment variable C enables verbose debugging output in all of
-the Maatkit tools:
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
- MKDEBUG=1 mk-....
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
=head1 SYSTEM REQUIREMENTS
-You need Perl and some core packages that ought to be installed in any
-reasonably new version of Perl.
+You need Perl, DBI, DBD::mysql, and some core packages that ought to be
+installed in any reasonably new version of Perl.
=head1 BUGS
-For a list of known bugs see L.
+For a list of known bugs, see L.
-Please use Google Code Issues and Groups to report bugs or request support:
-L. You can also join #maatkit on Freenode to
-discuss Maatkit.
+Please report bugs at L.
+Include the following information in your bug report:
-Please include the complete command-line used to reproduce the problem you are
-seeing, the version of all MySQL servers involved, the complete output of the
-tool when run with L<"--version">, and if possible, debugging output produced by
-running with the C environment variable.
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
+=head1 AUTHORS
+
+Baron Schwartz
+
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
=head1 COPYRIGHT, LICENSE, AND WARRANTY
-This program is copyright 2007-@CURRENTYEAR@ Baron Schwartz.
+This program is copyright 2007-2011 Baron Schwartz, 2011 Percona Inc.
Feedback and improvements are welcome.
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
@@ -1360,19 +1386,8 @@ You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-=head1 AUTHORS
-
-Baron "Xaprb" Schwartz
-
-=head1 ABOUT MAATKIT
-
-This tool is part of Maatkit, a toolkit for power users of MySQL. Maatkit
-was created by Baron Schwartz; Baron and Daniel Nichter are the primary
-code contributors. Both are employed by Percona. Financial support for
-Maatkit development is primarily provided by Percona and its clients.
-
=head1 VERSION
-This manual page documents Ver @VERSION@ Distrib @DISTRIB@ $Revision: 7477 $.
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-collect b/bin/pt-collect
index 69449f23..c9de138b 100755
--- a/bin/pt-collect
+++ b/bin/pt-collect
@@ -298,10 +298,71 @@ Usage: pt-collect [OPTION...]
pt-collect focuses on gathering diagnostic data during a MySQL performance
problem. It is typically executed by C.
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
+
+ wget percona.com/latest/percona-toolkit/PKG
+
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
+
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
+
+=head1 ENVIRONMENT
+
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
+
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
+
+=head1 SYSTEM REQUIREMENTS
+
+You need Bash.
+
+=head1 BUGS
+
+For a list of known bugs, see L.
+
+Please report bugs at L.
+Include the following information in your bug report:
+
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
=head1 AUTHORS
Baron Schwartz
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
+
=head1 COPYRIGHT, LICENSE, AND WARRANTY
This program is copyright 2010-2011 Baron Schwartz, 2011 Percona Inc.
@@ -320,9 +381,11 @@ licenses.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-legal.pod (END)
+
+=head1 VERSION
+
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
DOCUMENTATION
-
diff --git a/bin/pt-config-diff b/bin/pt-config-diff
index 7f10440c..02683cbb 100755
--- a/bin/pt-config-diff
+++ b/bin/pt-config-diff
@@ -3174,48 +3174,75 @@ User for login if not current user.
=back
-=head1 DOWNLOADING
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
-You can download Maatkit from Google Code at
-L, or you can get any of the tools
-easily with a command like the following:
+ wget percona.com/latest/percona-toolkit/PKG
- wget http://www.maatkit.org/get/toolname
- or
- wget http://www.maatkit.org/trunk/toolname
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
-Where C can be replaced with the name (or fragment of a name) of any
-of the Maatkit tools. Once downloaded, they're ready to run; no installation is
-needed. The first URL gets the latest released version of the tool, and the
-second gets the latest trunk code from Subversion.
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
=head1 ENVIRONMENT
-The environment variable C enables verbose debugging output in all of
-the Maatkit tools:
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
- MKDEBUG=1 mk-....
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
=head1 SYSTEM REQUIREMENTS
-You need the following Perl modules: DBI and DBD::mysql.
+You need Perl, DBI, DBD::mysql, and some core packages that ought to be
+installed in any reasonably new version of Perl.
=head1 BUGS
-For a list of known bugs see L.
+For a list of known bugs, see L.
-Please use Google Code Issues and Groups to report bugs or request support:
-L. You can also join #maatkit on Freenode to
-discuss Maatkit.
+Please report bugs at L.
+Include the following information in your bug report:
-Please include the complete command-line used to reproduce the problem you are
-seeing, the version of all MySQL servers involved, the complete output of the
-tool when run with L<"--version">, and if possible, debugging output produced by
-running with the C environment variable.
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
+=head1 AUTHORS
+
+Baron Schwartz and Daniel Nichter
+
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
=head1 COPYRIGHT, LICENSE, AND WARRANTY
-This program is copyright 2009-@CURRENTYEAR@ Percona Inc.
+This program is copyright 2011 Percona Inc.
Feedback and improvements are welcome.
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
@@ -3232,19 +3259,8 @@ You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-=head1 AUTHORS
-
-Baron Schwartz and Daniel Nichter
-
-=head1 ABOUT MAATKIT
-
-This tool is part of Maatkit, a toolkit for power users of MySQL. Maatkit
-was created by Baron Schwartz; Baron and Daniel Nichter are the primary
-code contributors. Both are employed by Percona. Financial support for
-Maatkit development is primarily provided by Percona and its clients.
-
=head1 VERSION
-This manual page documents Ver @VERSION@ Distrib @DISTRIB@ $Revision: 7477 $.
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-deadlock-logger b/bin/pt-deadlock-logger
index 5a207f6b..0a787241 100755
--- a/bin/pt-deadlock-logger
+++ b/bin/pt-deadlock-logger
@@ -2645,27 +2645,29 @@ User for login if not current user.
=back
-=head1 DOWNLOADING
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
-You can download Maatkit from Google Code at
-L, or you can get any of the tools
-easily with a command like the following:
+ wget percona.com/latest/percona-toolkit/PKG
- wget http://www.maatkit.org/get/toolname
- or
- wget http://www.maatkit.org/trunk/toolname
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
-Where C can be replaced with the name (or fragment of a name) of any
-of the Maatkit tools. Once downloaded, they're ready to run; no installation is
-needed. The first URL gets the latest released version of the tool, and the
-second gets the latest trunk code from Subversion.
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
=head1 ENVIRONMENT
-The environment variable C enables verbose debugging output in all of
-the Maatkit tools:
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
- MKDEBUG=1 mk-....
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
=head1 SYSTEM REQUIREMENTS
@@ -2674,20 +2676,44 @@ installed in any reasonably new version of Perl.
=head1 BUGS
-For a list of known bugs see L.
+For a list of known bugs, see L.
-Please use Google Code Issues and Groups to report bugs or request support:
-L. You can also join #maatkit on Freenode to
-discuss Maatkit.
+Please report bugs at L.
+Include the following information in your bug report:
-Please include the complete command-line used to reproduce the problem you are
-seeing, the version of all MySQL servers involved, the complete output of the
-tool when run with L<"--version">, and if possible, debugging output produced by
-running with the C environment variable.
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
+=head1 AUTHORS
+
+Baron Schwartz
+
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
=head1 COPYRIGHT, LICENSE, AND WARRANTY
-This program is copyright 2007-@CURRENTYEAR@ Baron Schwartz.
+This program is copyright 2007-2011 Baron Schwartz, 2011 Percona Inc.
Feedback and improvements are welcome.
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
@@ -2704,19 +2730,8 @@ You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-=head1 AUTHORS
-
-Baron Schwartz
-
-=head1 ABOUT MAATKIT
-
-This tool is part of Maatkit, a toolkit for power users of MySQL. Maatkit
-was created by Baron Schwartz; Baron and Daniel Nichter are the primary
-code contributors. Both are employed by Percona. Financial support for
-Maatkit development is primarily provided by Percona and its clients.
-
=head1 VERSION
-This manual page documents Ver @VERSION@ Distrib @DISTRIB@ $Revision: 7477 $.
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-diskstats b/bin/pt-diskstats
index 86cff32a..afab6a09 100755
--- a/bin/pt-diskstats
+++ b/bin/pt-diskstats
@@ -656,10 +656,72 @@ The file read should look like this:
... et cetera
TS <-- must end with a TS line.
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
+
+ wget percona.com/latest/percona-toolkit/PKG
+
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
+
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
+
+=head1 ENVIRONMENT
+
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
+
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
+
+=head1 SYSTEM REQUIREMENTS
+
+You need Perl, DBI, DBD::mysql, and some core packages that ought to be
+installed in any reasonably new version of Perl.
+
+=head1 BUGS
+
+For a list of known bugs, see L.
+
+Please report bugs at L.
+Include the following information in your bug report:
+
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
=head1 AUTHORS
Baron Schwartz
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
+
=head1 COPYRIGHT, LICENSE, AND WARRANTY
This program is copyright 2010-2011 Baron Schwartz, 2011 Percona Inc.
@@ -678,7 +740,10 @@ licenses.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-legal.pod (END)
+
+=head1 VERSION
+
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-duplicate-key-checker b/bin/pt-duplicate-key-checker
index 22b14405..5f166e9d 100755
--- a/bin/pt-duplicate-key-checker
+++ b/bin/pt-duplicate-key-checker
@@ -4168,48 +4168,75 @@ User for login if not current user.
=back
-=head1 DOWNLOADING
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
-You can download Maatkit from Google Code at
-L, or you can get any of the tools
-easily with a command like the following:
+ wget percona.com/latest/percona-toolkit/PKG
- wget http://www.maatkit.org/get/toolname
- or
- wget http://www.maatkit.org/trunk/toolname
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
-Where C can be replaced with the name (or fragment of a name) of any
-of the Maatkit tools. Once downloaded, they're ready to run; no installation is
-needed. The first URL gets the latest released version of the tool, and the
-second gets the latest trunk code from Subversion.
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
=head1 ENVIRONMENT
-The environment variable C enables verbose debugging output in all of
-the Maatkit tools:
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
- MKDEBUG=1 mk-....
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
=head1 SYSTEM REQUIREMENTS
-You need the following Perl modules: DBI and DBD::mysql.
+You need Perl, DBI, DBD::mysql, and some core packages that ought to be
+installed in any reasonably new version of Perl.
=head1 BUGS
-For a list of known bugs see L.
+For a list of known bugs, see L.
-Please use Google Code Issues and Groups to report bugs or request support:
-L. You can also join #maatkit on Freenode to
-discuss Maatkit.
+Please report bugs at L.
+Include the following information in your bug report:
-Please include the complete command-line used to reproduce the problem you are
-seeing, the version of all MySQL servers involved, the complete output of the
-tool when run with L<"--version">, and if possible, debugging output produced by
-running with the C environment variable.
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
+=head1 AUTHORS
+
+Baron Schwartz and Daniel Nichter
+
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
=head1 COPYRIGHT, LICENSE, AND WARRANTY
-This program is copyright 2007-@CURRENTYEAR@ Baron Schwartz.
+This program is copyright 2007-2011 Baron Schwartz, 2011 Percona Inc.
Feedback and improvements are welcome.
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
@@ -4226,19 +4253,8 @@ You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-=head1 AUTHORS
-
-Baron Schwartz and Daniel Nichter
-
-=head1 ABOUT MAATKIT
-
-This tool is part of Maatkit, a toolkit for power users of MySQL. Maatkit
-was created by Baron Schwartz; Baron and Daniel Nichter are the primary
-code contributors. Both are employed by Percona. Financial support for
-Maatkit development is primarily provided by Percona and its clients.
-
=head1 VERSION
-This manual page documents Ver @VERSION@ Distrib @DISTRIB@ $Revision: 7477 $.
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-fifo-split b/bin/pt-fifo-split
index 2e8d0112..e9e9638d 100755
--- a/bin/pt-fifo-split
+++ b/bin/pt-fifo-split
@@ -1449,27 +1449,29 @@ Show version and exit.
=back
-=head1 DOWNLOADING
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
-You can download Maatkit from Google Code at
-L, or you can get any of the tools
-easily with a command like the following:
+ wget percona.com/latest/percona-toolkit/PKG
- wget http://www.maatkit.org/get/toolname
- or
- wget http://www.maatkit.org/trunk/toolname
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
-Where C can be replaced with the name (or fragment of a name) of any
-of the Maatkit tools. Once downloaded, they're ready to run; no installation is
-needed. The first URL gets the latest released version of the tool, and the
-second gets the latest trunk code from Subversion.
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
=head1 ENVIRONMENT
-The environment variable C enables verbose debugging output in all of
-the Maatkit tools:
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
- MKDEBUG=1 mk-....
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
=head1 SYSTEM REQUIREMENTS
@@ -1478,20 +1480,44 @@ installed in any reasonably new version of Perl.
=head1 BUGS
-For a list of known bugs see L.
+For a list of known bugs, see L.
-Please use Google Code Issues and Groups to report bugs or request support:
-L. You can also join #maatkit on Freenode to
-discuss Maatkit.
+Please report bugs at L.
+Include the following information in your bug report:
-Please include the complete command-line used to reproduce the problem you are
-seeing, the version of all MySQL servers involved, the complete output of the
-tool when run with L<"--version">, and if possible, debugging output produced by
-running with the C environment variable.
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
+=head1 AUTHORS
+
+Baron Schwartz
+
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
=head1 COPYRIGHT, LICENSE, AND WARRANTY
-This program is copyright 2007-@CURRENTYEAR@ Baron Schwartz.
+This program is copyright 2007-2011 Baron Schwartz, 2011 Percona Inc.
Feedback and improvements are welcome.
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
@@ -1508,19 +1534,8 @@ You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-=head1 AUTHORS
-
-Baron Schwartz
-
-=head1 ABOUT MAATKIT
-
-This tool is part of Maatkit, a toolkit for power users of MySQL. Maatkit
-was created by Baron Schwartz; Baron and Daniel Nichter are the primary
-code contributors. Both are employed by Percona. Financial support for
-Maatkit development is primarily provided by Percona and its clients.
-
=head1 VERSION
-This manual page documents Ver @VERSION@ Distrib @DISTRIB@ $Revision: 7477 $.
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-find b/bin/pt-find
index c6974ba9..b7386464 100755
--- a/bin/pt-find
+++ b/bin/pt-find
@@ -3722,49 +3722,76 @@ User for login if not current user.
=back
-=head1 DOWNLOADING
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
-You can download Maatkit from Google Code at
-L, or you can get any of the tools
-easily with a command like the following:
+ wget percona.com/latest/percona-toolkit/PKG
- wget http://www.maatkit.org/get/toolname
- or
- wget http://www.maatkit.org/trunk/toolname
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
-Where C can be replaced with the name (or fragment of a name) of any
-of the Maatkit tools. Once downloaded, they're ready to run; no installation is
-needed. The first URL gets the latest released version of the tool, and the
-second gets the latest trunk code from Subversion.
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
=head1 ENVIRONMENT
-The environment variable C enables verbose debugging output in all of
-the Maatkit tools:
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
- MKDEBUG=1 mk-....
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
=head1 SYSTEM REQUIREMENTS
-You need the following Perl modules: DBI and DBD::mysql.
+You need Perl, DBI, DBD::mysql, and some core packages that ought to be
+installed in any reasonably new version of Perl.
=head1 BUGS
-For a list of known bugs see L.
+For a list of known bugs, see L.
-Please use Google Code Issues and Groups to report bugs or request support:
-L. You can also join #maatkit on Freenode to
-discuss Maatkit.
+Please report bugs at L.
+Include the following information in your bug report:
-Please include the complete command-line used to reproduce the problem you are
-seeing, the version of all MySQL servers involved, the complete output of the
-tool when run with L<"--version">, and if possible, debugging output produced by
-running with the C environment variable.
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
+=head1 AUTHORS
+
+Baron Schwartz
+
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
=head1 COPYRIGHT, LICENSE, AND WARRANTY
-This program is copyright 2007-@CURRENTYEAR@ Baron Schwartz.
-Feedback and improvements are welcome (see L<"BUGS">).
+This program is copyright 2007-2011 Baron Schwartz, 2011 Percona Inc.
+Feedback and improvements are welcome.
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
@@ -3780,19 +3807,8 @@ You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-=head1 AUTHORS
-
-Baron Schwartz
-
-=head1 ABOUT MAATKIT
-
-This tool is part of Maatkit, a toolkit for power users of MySQL. Maatkit
-was created by Baron Schwartz; Baron and Daniel Nichter are the primary
-code contributors. Both are employed by Percona. Financial support for
-Maatkit development is primarily provided by Percona and its clients.
-
=head1 VERSION
-This manual page documents Ver @VERSION@ Distrib @DISTRIB@ $Revision: 7477 $.
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-fk-error-logger b/bin/pt-fk-error-logger
index 18d5d1f8..e7186e8e 100755
--- a/bin/pt-fk-error-logger
+++ b/bin/pt-fk-error-logger
@@ -2333,27 +2333,29 @@ User for login if not current user.
=back
-=head1 DOWNLOADING
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
-You can download Maatkit from Google Code at
-L, or you can get any of the tools
-easily with a command like the following:
+ wget percona.com/latest/percona-toolkit/PKG
- wget http://www.maatkit.org/get/toolname
- or
- wget http://www.maatkit.org/trunk/toolname
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
-Where C can be replaced with the name (or fragment of a name) of any
-of the Maatkit tools. Once downloaded, they're ready to run; no installation is
-needed. The first URL gets the latest released version of the tool, and the
-second gets the latest trunk code from Subversion.
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
=head1 ENVIRONMENT
-The environment variable C enables verbose debugging output in all of
-the Maatkit tools:
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
- MKDEBUG=1 mk-....
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
=head1 SYSTEM REQUIREMENTS
@@ -2362,20 +2364,44 @@ installed in any reasonably new version of Perl.
=head1 BUGS
-For a list of known bugs see L.
+For a list of known bugs, see L.
-Please use Google Code Issues and Groups to report bugs or request support:
-L. You can also join #maatkit on Freenode to
-discuss Maatkit.
+Please report bugs at L.
+Include the following information in your bug report:
-Please include the complete command-line used to reproduce the problem you are
-seeing, the version of all MySQL servers involved, the complete output of the
-tool when run with L<"--version">, and if possible, debugging output produced by
-running with the C environment variable.
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
+=head1 AUTHORS
+
+Daniel Nichter
+
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
=head1 COPYRIGHT, LICENSE, AND WARRANTY
-This program is copyright 2009-@CURRENTYEAR@ Percona Inc.
+This program is copyright 2011 Percona Inc.
Feedback and improvements are welcome.
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
@@ -2392,19 +2418,8 @@ You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-=head1 AUTHORS
-
-Daniel Nichter
-
-=head1 ABOUT MAATKIT
-
-This tool is part of Maatkit, a toolkit for power users of MySQL. Maatkit
-was created by Baron Schwartz; Baron and Daniel Nichter are the primary
-code contributors. Both are employed by Percona. Financial support for
-Maatkit development is primarily provided by Percona and its clients.
-
=head1 VERSION
-This manual page documents Ver @VERSION@ Distrib @DISTRIB@ $Revision: 4247 $.
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-heartbeat b/bin/pt-heartbeat
index 789ff884..9db384c6 100755
--- a/bin/pt-heartbeat
+++ b/bin/pt-heartbeat
@@ -4370,27 +4370,29 @@ User for login if not current user.
=back
-=head1 DOWNLOADING
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
-You can download Maatkit from Google Code at
-L, or you can get any of the tools
-easily with a command like the following:
+ wget percona.com/latest/percona-toolkit/PKG
- wget http://www.maatkit.org/get/toolname
- or
- wget http://www.maatkit.org/trunk/toolname
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
-Where C can be replaced with the name (or fragment of a name) of any
-of the Maatkit tools. Once downloaded, they're ready to run; no installation is
-needed. The first URL gets the latest released version of the tool, and the
-second gets the latest trunk code from Subversion.
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
=head1 ENVIRONMENT
-The environment variable C enables verbose debugging output in all of the
-Maatkit tools:
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
- MKDEBUG=1 mk-....
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
=head1 SYSTEM REQUIREMENTS
@@ -4399,21 +4401,47 @@ installed in any reasonably new version of Perl.
=head1 BUGS
-For a list of known bugs see L.
+For a list of known bugs, see L.
-Please use Google Code Issues and Groups to report bugs or request support:
-L. You can also join #maatkit on Freenode to
-discuss Maatkit.
+Please report bugs at L.
+Include the following information in your bug report:
-Please include the complete command-line used to reproduce the problem you are
-seeing, the version of all MySQL servers involved, the complete output of the
-tool when run with L<"--version">, and if possible, debugging output produced by
-running with the C environment variable.
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
+=head1 AUTHORS
+
+Proven Scaling LLC, SixApart Ltd, Baron Schwartz, and Daniel Nichter
+
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
=head1 COPYRIGHT, LICENSE, AND WARRANTY
-This program is copyright 2007-@CURRENTYEAR@ Percona Inc.
-and copyright 2006 Proven Scaling LLC and Six Apart Ltd.
+This program is copyright 2006 Proven Scaling LLC and Six Apart Ltd,
+2007-2011 Percona Inc.
+Feedback and improvements are welcome.
+
Feedback and improvements are welcome.
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
@@ -4430,23 +4458,8 @@ You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-=head1 SEE ALSO
-
-See also L and L.
-
-=head1 AUTHORS
-
-Proven Scaling LLC, SixApart Ltd, and Baron Schwartz
-
-=head1 ABOUT MAATKIT
-
-This tool is part of Maatkit, a toolkit for power users of MySQL. Maatkit
-was created by Baron Schwartz; Baron and Daniel Nichter are the primary
-code contributors. Both are employed by Percona. Financial support for
-Maatkit development is primarily provided by Percona and its clients.
-
=head1 VERSION
-This manual page documents Ver @VERSION@ Distrib @DISTRIB@ $Revision: 7537 $.
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-index-usage b/bin/pt-index-usage
index 6be4e8e5..1309db59 100755
--- a/bin/pt-index-usage
+++ b/bin/pt-index-usage
@@ -5840,49 +5840,75 @@ User for login if not current user.
=back
-=head1 DOWNLOADING
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
-You can download Maatkit from Google Code at
-L, or you can get any of the tools
-easily with a command like the following:
+ wget percona.com/latest/percona-toolkit/PKG
- wget http://www.maatkit.org/get/toolname
- or
- wget http://www.maatkit.org/trunk/toolname
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
-Where C can be replaced with the name (or fragment of a name) of any
-of the Maatkit tools. Once downloaded, they're ready to run; no installation is
-needed. The first URL gets the latest released version of the tool, and the
-second gets the latest trunk code from Subversion.
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
=head1 ENVIRONMENT
-The environment variable C enables verbose debugging output in all of
-the Maatkit tools:
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
- MKDEBUG=1 mk-....
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
=head1 SYSTEM REQUIREMENTS
-You need Perl and some core packages that ought to be installed in any
-reasonably new version of Perl.
+You need Perl, DBI, DBD::mysql, and some core packages that ought to be
+installed in any reasonably new version of Perl.
=head1 BUGS
-For a list of known bugs see L.
+For a list of known bugs, see L.
-Please use Google Code Issues and Groups to report bugs or request support:
-L. You can also join #maatkit on Freenode to
-discuss Maatkit.
+Please report bugs at L.
+Include the following information in your bug report:
-Please include the complete command-line used to reproduce the problem you are
-seeing, the version of all MySQL servers involved, the complete output of the
-tool when run with L<"--version">, and if possible, debugging output produced by
-running with the C environment variable.
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
+=head1 AUTHORS
+
+Baron Schwartz and Daniel Nichter
+
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
=head1 COPYRIGHT, LICENSE, AND WARRANTY
-This program is copyright 2010-@CURRENTYEAR@ Baron Schwartz.
+This program is copyright 2010-2011 Baron Schwartz, 2011 Percona Inc.
Feedback and improvements are welcome.
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
@@ -5899,19 +5925,8 @@ You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-=head1 AUTHORS
-
-Baron Schwartz and Daniel Nichter
-
-=head1 ABOUT MAATKIT
-
-This tool is part of Maatkit, a toolkit for power users of MySQL. Maatkit
-was created by Baron Schwartz; Baron and Daniel Nichter are the primary
-code contributors. Both are employed by Percona. Financial support for
-Maatkit development is primarily provided by Percona and its clients.
-
=head1 VERSION
-This manual page documents Ver @VERSION@ Distrib @DISTRIB@ $Revision: 7477 $.
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-kill b/bin/pt-kill
index 67b3b9b6..42532e79 100755
--- a/bin/pt-kill
+++ b/bin/pt-kill
@@ -4751,27 +4751,29 @@ User for login if not current user.
=back
-=head1 DOWNLOADING
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
-You can download Maatkit from Google Code at
-L, or you can get any of the tools
-easily with a command like the following:
+ wget percona.com/latest/percona-toolkit/PKG
- wget http://www.maatkit.org/get/toolname
- or
- wget http://www.maatkit.org/trunk/toolname
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
-Where C can be replaced with the name (or fragment of a name) of any
-of the Maatkit tools. Once downloaded, they're ready to run; no installation is
-needed. The first URL gets the latest released version of the tool, and the
-second gets the latest trunk code from Subversion.
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
=head1 ENVIRONMENT
-The environment variable C enables verbose debugging output in all of
-the Maatkit tools:
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
- MKDEBUG=1 mk-....
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
=head1 SYSTEM REQUIREMENTS
@@ -4780,20 +4782,44 @@ installed in any reasonably new version of Perl.
=head1 BUGS
-For a list of known bugs see L.
+For a list of known bugs, see L.
-Please use Google Code Issues and Groups to report bugs or request support:
-L. You can also join #maatkit on Freenode to
-discuss Maatkit.
+Please report bugs at L.
+Include the following information in your bug report:
-Please include the complete command-line used to reproduce the problem you are
-seeing, the version of all MySQL servers involved, the complete output of the
-tool when run with L<"--version">, and if possible, debugging output produced by
-running with the C environment variable.
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
+=head1 AUTHORS
+
+Baron Schwartz and Daniel Nichter
+
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
=head1 COPYRIGHT, LICENSE, AND WARRANTY
-This program is copyright 2009-@CURRENTYEAR@ Baron Schwartz.
+This program is copyright 2009-2011 Baron Schwartz, 2011 Percona Inc.
Feedback and improvements are welcome.
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
@@ -4810,19 +4836,8 @@ You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-=head1 AUTHORS
-
-Baron Schwartz and Daniel Nichter
-
-=head1 ABOUT MAATKIT
-
-This tool is part of Maatkit, a toolkit for power users of MySQL. Maatkit
-was created by Baron Schwartz; Baron and Daniel Nichter are the primary
-code contributors. Both are employed by Percona. Financial support for
-Maatkit development is primarily provided by Percona and its clients.
-
=head1 VERSION
-This manual page documents Ver @VERSION@ Distrib @DISTRIB@ $Revision: 7531 $.
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-log-player b/bin/pt-log-player
index 1b854dfc..1d7ca9ac 100755
--- a/bin/pt-log-player
+++ b/bin/pt-log-player
@@ -3544,49 +3544,75 @@ User for login if not current user.
=back
-=head1 DOWNLOADING
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
-You can download Maatkit from Google Code at
-L, or you can get any of the tools
-easily with a command like the following:
+ wget percona.com/latest/percona-toolkit/PKG
- wget http://www.maatkit.org/get/toolname
- or
- wget http://www.maatkit.org/trunk/toolname
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
-Where C can be replaced with the name (or fragment of a name) of any
-of the Maatkit tools. Once downloaded, they're ready to run; no installation is
-needed. The first URL gets the latest released version of the tool, and the
-second gets the latest trunk code from Subversion.
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
=head1 ENVIRONMENT
-The environment variable C enables verbose debugging output in all of
-the Maatkit tools:
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
- MKDEBUG=1 mk-....
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
=head1 SYSTEM REQUIREMENTS
-You need Perl and some core packages that ought to be installed in any
-reasonably new version of Perl.
+You need Perl, DBI, DBD::mysql, and some core packages that ought to be
+installed in any reasonably new version of Perl.
=head1 BUGS
-For a list of known bugs see L.
+For a list of known bugs, see L.
-Please use Google Code Issues and Groups to report bugs or request support:
-L. You can also join #maatkit on Freenode to
-discuss Maatkit.
+Please report bugs at L.
+Include the following information in your bug report:
-Please include the complete command-line used to reproduce the problem you are
-seeing, the version of all MySQL servers involved, the complete output of the
-tool when run with L<"--version">, and if possible, debugging output produced by
-running with the C environment variable.
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
+=head1 AUTHORS
+
+Daniel Nichter
+
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
=head1 COPYRIGHT, LICENSE, AND WARRANTY
-This program is copyright 2008-@CURRENTYEAR@ Percona Inc.
+This program is copyright 2008-2011 Percona Inc.
Feedback and improvements are welcome.
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
@@ -3603,19 +3629,8 @@ You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-=head1 AUTHORS
-
-Daniel Nichter
-
-=head1 ABOUT MAATKIT
-
-This tool is part of Maatkit, a toolkit for power users of MySQL. Maatkit
-was created by Baron Schwartz; Baron and Daniel Nichter are the primary
-code contributors. Both are employed by Percona. Financial support for
-Maatkit development is primarily provided by Percona and its clients.
-
=head1 VERSION
-This manual page documents Ver @VERSION@ Distrib @DISTRIB@ $Revision: 7531 $.
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-mext b/bin/pt-mext
index 18eadc92..fb7faaa6 100755
--- a/bin/pt-mext
+++ b/bin/pt-mext
@@ -112,10 +112,71 @@ Usage: pt-mext [OPTION...]
pt-mext aggregates and summarizes mysqladmin extended output.
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
+
+ wget percona.com/latest/percona-toolkit/PKG
+
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
+
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
+
+=head1 ENVIRONMENT
+
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
+
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
+
+=head1 SYSTEM REQUIREMENTS
+
+You need Bash.
+
+=head1 BUGS
+
+For a list of known bugs, see L.
+
+Please report bugs at L.
+Include the following information in your bug report:
+
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
=head1 AUTHORS
Baron Schwartz
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
+
=head1 COPYRIGHT, LICENSE, AND WARRANTY
This program is copyright 2010 Baron Schwartz, 2011 Percona Inc.
@@ -134,7 +195,10 @@ licenses.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-legal.pod (END)
+
+=head1 VERSION
+
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-mysql-summary b/bin/pt-mysql-summary
index 49e2f6f3..44753936 100755
--- a/bin/pt-mysql-summary
+++ b/bin/pt-mysql-summary
@@ -1289,10 +1289,72 @@ you would use to connect to MySQL, such as "./mysql-summary --user=foo"
* Parse queries out of processlist and aggregate them.
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
+
+ wget percona.com/latest/percona-toolkit/PKG
+
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
+
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
+
+=head1 ENVIRONMENT
+
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
+
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
+
+=head1 SYSTEM REQUIREMENTS
+
+You need Perl, DBI, DBD::mysql, and some core packages that ought to be
+installed in any reasonably new version of Perl.
+
+=head1 BUGS
+
+For a list of known bugs, see L.
+
+Please report bugs at L.
+Include the following information in your bug report:
+
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
=head1 AUTHORS
Baron Schwartz
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
+
=head1 COPYRIGHT, LICENSE, AND WARRANTY
This program is copyright 2010-2011 Baron Schwartz, 2011 Percona Inc.
@@ -1311,7 +1373,10 @@ licenses.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-legal.pod (END)
+
+=head1 VERSION
+
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-online-schema-change b/bin/pt-online-schema-change
index 64712c87..09829216 100755
--- a/bin/pt-online-schema-change
+++ b/bin/pt-online-schema-change
@@ -5207,27 +5207,29 @@ User for login if not current user.
=back
-=head1 DOWNLOADING
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
-You can download Maatkit from Google Code at
-L, or you can get any of the tools
-easily with a command like the following:
+ wget percona.com/latest/percona-toolkit/PKG
- wget http://www.maatkit.org/get/toolname
- or
- wget http://www.maatkit.org/trunk/toolname
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
-Where C can be replaced with the name (or fragment of a name) of any
-of the Maatkit tools. Once downloaded, they're ready to run; no installation is
-needed. The first URL gets the latest released version of the tool, and the
-second gets the latest trunk code from Subversion.
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
=head1 ENVIRONMENT
-The environment variable C enables verbose debugging output in all of
-the Maatkit tools:
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
- MKDEBUG=1 mk-....
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
=head1 SYSTEM REQUIREMENTS
@@ -5236,41 +5238,33 @@ installed in any reasonably new version of Perl.
=head1 BUGS
-For a list of known bugs see L.
+For a list of known bugs, see L.
-Please use Google Code Issues and Groups to report bugs or request support:
-L. You can also join #maatkit on Freenode to
-discuss Maatkit.
+Please report bugs at L.
+Include the following information in your bug report:
-Please include the complete command-line used to reproduce the problem you are
-seeing, the version of all MySQL servers involved, the complete output of the
-tool when run with L<"--version">, and if possible, debugging output produced by
-running with the C environment variable.
+=over
-=head1 COPYRIGHT, LICENSE, AND WARRANTY
+=item * Complete command-line used to run the tool
-This program is copyright 2011-@CURRENTYEAR@ Percona Inc.
-Feedback and improvements are welcome.
+=item * Tool L<"--version">
-THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
-WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+=item * MySQL version of all servers involved
-This program is free software; you can redistribute it and/or modify it under
-the terms of the GNU General Public License as published by the Free Software
-Foundation, version 2; OR the Perl Artistic License. On UNIX and similar
-systems, you can issue `man perlgpl' or `man perlartistic' to read these
-licenses.
+=item * Output from the tool including STDERR
-You should have received a copy of the GNU General Public License along with
-this program; if not, write to the Free Software Foundation, Inc., 59 Temple
-Place, Suite 330, Boston, MA 02111-1307 USA.
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
=head1 AUTHORS
-Daniel Nichter
+Baron Schwartz
-=head1 HISTORY AND ACKNOWLEDGMENTS
+=head1 ACKNOWLEDGMENTS
The "online schema change" concept was first implemented by Shlomi Noach
in his tool C, part of
@@ -5289,15 +5283,36 @@ full-featured, tested tool with stable development and support.
This tool was made possible by a generous client of Percona Inc.
-=head1 ABOUT MAATKIT
+=head1 ABOUT PERCONA TOOLKIT
-This tool is part of Maatkit, a toolkit for power users of MySQL. Maatkit
-was created by Baron Schwartz; Baron and Daniel Nichter are the primary
-code contributors. Both are employed by Percona. Financial support for
-Maatkit development is primarily provided by Percona and its clients.
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
+
+=head1 COPYRIGHT, LICENSE, AND WARRANTY
+
+This program is copyright 2011 Percona Inc.
+Feedback and improvements are welcome.
+
+THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
+WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+
+This program is free software; you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free Software
+Foundation, version 2; OR the Perl Artistic License. On UNIX and similar
+systems, you can issue `man perlgpl' or `man perlartistic' to read these
+licenses.
+
+You should have received a copy of the GNU General Public License along with
+this program; if not, write to the Free Software Foundation, Inc., 59 Temple
+Place, Suite 330, Boston, MA 02111-1307 USA.
=head1 VERSION
-This manual page documents Ver @VERSION@ Distrib @DISTRIB@ $Revision: 7479 $.
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-pmp b/bin/pt-pmp
index 2993a873..74eef4a5 100755
--- a/bin/pt-pmp
+++ b/bin/pt-pmp
@@ -205,10 +205,72 @@ Usage: pt-pmp [OPTION...]
pt-pmp aggregates stack traces.
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
+
+ wget percona.com/latest/percona-toolkit/PKG
+
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
+
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
+
+=head1 ENVIRONMENT
+
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
+
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
+
+=head1 SYSTEM REQUIREMENTS
+
+You need Perl, DBI, DBD::mysql, and some core packages that ought to be
+installed in any reasonably new version of Perl.
+
+=head1 BUGS
+
+For a list of known bugs, see L.
+
+Please report bugs at L.
+Include the following information in your bug report:
+
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
=head1 AUTHORS
Baron Schwartz, based on a script by Domas Mituzas (L)
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
+
=head1 COPYRIGHT, LICENSE, AND WARRANTY
This program is copyright 2010-2011 Baron Schwartz, 2011 Percona Inc.
@@ -227,7 +289,10 @@ licenses.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-legal.pod (END)
+
+=head1 VERSION
+
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-profile-compact b/bin/pt-profile-compact
index 82eaf027..ccdb3ffc 100755
--- a/bin/pt-profile-compact
+++ b/bin/pt-profile-compact
@@ -1266,49 +1266,75 @@ Show version and exit.
=back
-=head1 DOWNLOADING
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
-You can download Maatkit from Google Code at
-L, or you can get any of the tools
-easily with a command like the following:
+ wget percona.com/latest/percona-toolkit/PKG
- wget http://www.maatkit.org/get/toolname
- or
- wget http://www.maatkit.org/trunk/toolname
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
-Where C can be replaced with the name (or fragment of a name) of any
-of the Maatkit tools. Once downloaded, they're ready to run; no installation is
-needed. The first URL gets the latest released version of the tool, and the
-second gets the latest trunk code from Subversion.
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
=head1 ENVIRONMENT
-The environment variable C enables verbose debugging output in all of
-the Maatkit tools:
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
- MKDEBUG=1 mk-....
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
=head1 SYSTEM REQUIREMENTS
-You need Perl and some core packages that ought to be installed in any
-reasonably new version of Perl.
+You need Perl, DBI, DBD::mysql, and some core packages that ought to be
+installed in any reasonably new version of Perl.
=head1 BUGS
-For a list of known bugs see L.
+For a list of known bugs, see L.
-Please use Google Code Issues and Groups to report bugs or request support:
-L. You can also join #maatkit on Freenode to
-discuss Maatkit.
+Please report bugs at L.
+Include the following information in your bug report:
-Please include the complete command-line used to reproduce the problem you are
-seeing, the version of all MySQL servers involved, the complete output of the
-tool when run with L<"--version">, and if possible, debugging output produced by
-running with the C environment variable.
+=over
+
+=item * Complete command-line used to run the tool
+
+=item * Tool L<"--version">
+
+=item * MySQL version of all servers involved
+
+=item * Output from the tool including STDERR
+
+=item * Input files (log/dump/config files, etc.)
+
+=back
+
+If possible, include debugging output by running the tool with C;
+see L<"ENVIRONMENT">.
+
+=head1 AUTHORS
+
+Baron Schwartz
+
+=head1 ABOUT PERCONA TOOLKIT
+
+This tool is part of Percona Toolkit, a collection of advanced command-line
+tools developed by Percona for MySQL support and consulting. Percona Toolkit
+was forked from two projects in June, 2011: Maatkit and Aspersa. Those
+projects were created by Baron Schwartz and developed primarily by him and
+Daniel Nichter, both of whom are employed by Percona. Visit
+L for more software developed by Percona.
=head1 COPYRIGHT, LICENSE, AND WARRANTY
-This program is copyright 2007-@CURRENTYEAR@ Baron Schwartz.
+This program is copyright 2007-2011 Baron Schwartz, 2011 Percona Inc.
Feedback and improvements are welcome.
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
@@ -1325,23 +1351,8 @@ You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA.
-=head1 SEE ALSO
-
-See also L.
-
-=head1 AUTHORS
-
-Baron Schwartz
-
-=head1 ABOUT MAATKIT
-
-This tool is part of Maatkit, a toolkit for power users of MySQL. Maatkit
-was created by Baron Schwartz; Baron and Daniel Nichter are the primary
-code contributors. Both are employed by Percona. Financial support for
-Maatkit development is primarily provided by Percona and its clients.
-
=head1 VERSION
-This manual page documents Ver @VERSION@ Distrib @DISTRIB@ $Revision: 7477 $.
+Percona Toolkit v1.0.0 released 2011-08-01
=cut
diff --git a/bin/pt-query-advisor b/bin/pt-query-advisor
index a3c7b0f8..15113b90 100755
--- a/bin/pt-query-advisor
+++ b/bin/pt-query-advisor
@@ -7188,48 +7188,75 @@ User for login if not current user.
=back
-=head1 DOWNLOADING
+=head1 DOWNLOADING
+
+Visit L to download the latest release of
+Percona Toolkit. Or, to get the latest release from the command line:
-You can download Maatkit from Google Code at
-L, or you can get any of the tools
-easily with a command like the following:
+ wget percona.com/latest/percona-toolkit/PKG
- wget http://www.maatkit.org/get/toolname
- or
- wget http://www.maatkit.org/trunk/toolname
+Replace C with C, C, or C to download the package in that
+format. You can also get individual tools from the latest release:
-Where C can be replaced with the name (or fragment of a name) of any
-of the Maatkit tools. Once downloaded, they're ready to run; no installation is
-needed. The first URL gets the latest released version of the tool, and the
-second gets the latest trunk code from Subversion.
+ wget percona.com/latest/percona-toolkit/TOOL
+
+Replace C with the name of any tool.
=head1 ENVIRONMENT
-The environment variable C enables verbose debugging output in all of
-the Maatkit tools:
+The environment variable C enables verbose debugging output to STDERR.
+To enable debugging and capture all output to a file, run the tool like:
- MKDEBUG=1 mk-....
+ PTDEBUG=1 $TOOL ... > FILE 2>&1
+
+Be careful: debugging output is voluminous and can generate several megabytes
+of output.
=head1 SYSTEM REQUIREMENTS
-You need the following Perl modules: DBI and DBD::mysql.
+You need Perl, DBI, DBD::mysql, and some core packages that ought to be
+installed in any reasonably new version of Perl.
=head1 BUGS
-For a list of known bugs see L.
+For a list of known bugs, see L.
-Please use Google Code Issues and Groups to report bugs or request support:
-L. You can also join #maatkit on Freenode to
-discuss Maatkit.
+Please report bugs at L.
+Include the following information in your bug report:
-Please include the complete command-line used to reproduce the problem you are
-seeing, the version of all MySQL servers involved, the complete output of the
-tool when run with L<"--version">, and if possible, debugging output produced by
-running with the C