Move module docu to work for NaturalDocs.

lib/Advisor.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # Advisor package $Revision: 6830 $
 # ###########################################################################
-
+{
 # Package: Advisor
 # Advisor loads, checks, and runs rules for the various mk-*-advisor tools.
-{
 package Advisor;
 
 use strict;

lib/AdvisorRules.pm

@@ -17,11 +17,10 @@
 # ###########################################################################
 # AdvisorRules package $Revision: 6813 $
 # ###########################################################################
-
+{
 # Package: AdvisorRules
 # AdvisorRules is a parent class for advisor rule modules like
 # <QueryAdivsorRules>.
-{
 package AdvisorRules;
 
 use strict;

lib/BinaryLogParser.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # BinaryLogParser package $Revision: 7522 $
 # ###########################################################################
-
+{
 # Package: BinaryLogParser
 # BinaryLogParser parses binary log files converted to text by mysqlbinlog.
-{
 package BinaryLogParser;
 
 use strict;

lib/ChangeHandler.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # ChangeHandler package $Revision: 6785 $
 # ###########################################################################
-
+{
 # Package: ChangeHandler
 # ChangeHandler creates SQL statements for changing rows in a table.
-{
 package ChangeHandler;
 
 use strict;

lib/CompareQueryTimes.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # CompareQueryTimes package $Revision: 6785 $
 # ###########################################################################
-
+{
 # Package: CompareQueryTimes
 # CompareQueryTimes compares query execution times.
-{
 package CompareQueryTimes;
 
 use strict;

lib/CompareResults.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # CompareResults package $Revision: 7096 $
 # ###########################################################################
-
+{
 # Package: CompareResults
 # CompareResults compares the query result sets.
-{
 package CompareResults;
 
 use strict;

lib/CompareTableStructs.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # CompareTableStructs package $Revision: 6785 $
 # ###########################################################################
-
+{
 # Package: CompareTableStructs
 # CompareTableStructs compares CREATE TABLE defs.
-{
 package CompareTableStructs;
 
 use strict;

lib/CompareWarnings.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # CompareWarnings package $Revision: 7096 $
 # ###########################################################################
-
+{
 # Package: CompareWarnings
 # CompareWarnings compares query warnings.
-{
 package CompareWarnings;
 
 use strict;

lib/CopyRowsInsertSelect.pm

@@ -17,11 +17,10 @@
 # ###########################################################################
 # CopyRowsInsertSelect package $Revision: 7464 $
 # ###########################################################################
-
+{
 # Package: CopyRowsInsertSelect
 # CopyRowsInsertSelect implements the copy rows phase of an online schema
 # change.
-{
 package CopyRowsInsertSelect;
 
 use strict;

lib/DSNParser.pm

@@ -18,11 +18,10 @@
 # ###########################################################################
 # DSNParser package $Revision: 7388 $
 # ###########################################################################
-
+{
 # Package: DSNParser
 # DSNParser parses DSNs and creates connections to MySQL using DBI and
 # DBD::mysql.
-{
 package DSNParser;
 
 use strict;

lib/Daemon.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # Daemon package $Revision: 6255 $
 # ###########################################################################
-
+{
 # Package: Daemon
 # Daemon daemonizes the caller and handles daemon-related tasks like PID files.
-{
 package Daemon;
 
 use strict;

lib/DuplicateKeyFinder.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # DuplicateKeyFinder package $Revision: 7565 $
 # ###########################################################################
-
+{
 # Package: DuplicateKeyFinder
 # DuplicateKeyFinder finds duplicate indexes (keys).
-{
 package DuplicateKeyFinder;
 
 use strict;

lib/EventAggregator.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # EventAggregator package $Revision: 7272 $
 # ###########################################################################
-
+{
 # Package: EventAggregator
 # EventAggregator aggregates event values and calculates basic statistics.
-{
 package EventAggregator;
 
 use strict;

lib/EventTimeline.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # EventTimeline package $Revision: 6590 $
 # ###########################################################################
-
-# Package: EventTimeLine
-# EventTimeLine aggregates events that are adjacent to each other.
 {
+# Package: EventTimeline
+# EventTimeline aggregates events that are adjacent to each other.
 package EventTimeline;
 
 use strict;

lib/ExecutionThrottler.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # ExecutionThrottler package $Revision: 5266 $
 # ###########################################################################
-
+{
 # Package: ExecutionThrottler
 # ExecutionThrottle slows program execution if a threshold is exceeded.
-{
 package ExecutionThrottler;
 
 use strict;

lib/ExplainAnalyzer.pm

@@ -17,13 +17,12 @@
 # ###########################################################################
 # ExplainAnalyzer package $Revision: 7096 $
 # ###########################################################################
-
+{
 # Package: ExplainAnalyzer
 # ExplainAnalyzer contains utility methods for getting and manipulating
 # EXPLAIN data.  It also has methods to save and retrieve information,
 # so it actually has state itself if used in this way -- it is not a data-less
 # collection of methods.
-{
 package ExplainAnalyzer;
 
 use strict;

lib/FileIterator.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # FileIterator package $Revision: 7096 $
 # ###########################################################################
-
+{
 # Package: FileIterator
 # FileIterator make iterators that return filenames.
-{
 package FileIterator;
 
 use strict;

lib/ForeignKeyIterator.pm

@@ -17,7 +17,7 @@
 # ###########################################################################
 # ForeignKeyIterator package $Revision: 7552 $
 # ###########################################################################
-
+{
 # Package: ForeignKeyIterator
 # ForeignKeyIterator iterates from or to a table by its foreign key constraints.
 # This is a special type of <SchemaIterator> with the same interface, so it
@@ -25,7 +25,6 @@
 # very differently.  Whereas a <SchemaIterator> is a real iterator that only
 # gets the next schema object when called, a ForeignKeyIterator slurps the
 # given <SchemaIterator> so it can discover foreign key constraints.
-{
 package ForeignKeyIterator;
 
 use strict;

lib/GeneralLogParser.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # GeneralLogParser package $Revision: 7522 $
 # ###########################################################################
-
+{
 # Package: GeneralLogParser
 # GeneralLogParser parses MySQL general logs.
-{
 package GeneralLogParser;
 
 use strict;

lib/HTTPProtocolParser.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # HTTPProtocolParser package $Revision: 5811 $
 # ###########################################################################
-
+{
 # Package: HTTPProtocolParser
 # HTTPProtocolParser parses HTTP traffic from tcpdump files.
-{
 package HTTPProtocolParser;
 use base 'ProtocolParser';
 

lib/IndexUsage.pm

@@ -17,7 +17,7 @@
 # ###########################################################################
 # IndexUsage package $Revision: 7096 $
 # ###########################################################################
-
+{
 # Package: IndexUsage
 # IndexUsage tracks index and tables usage of queries.  It can then show which
 # indexes are not used.  You use it by telling it about all the tables and
@@ -26,7 +26,6 @@
 #
 # If the object is created with a dbh and db, then results (the indexes,
 # tables, queries and index usages) are saved in tables.
-{
 package IndexUsage;
 
 use strict;

lib/InnoDBStatusParser.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # InnoDBStatusParser package $Revision: 7096 $
 # ###########################################################################
-
+{
 # Package: InnoDBStatusParser
 # InnoDBStatusParser parses SHOW INNODB STATUS.
-{
 package InnoDBStatusParser;
 
 use strict;

lib/KeySize.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # KeySize package $Revision: 7096 $
 # ###########################################################################
-
+{
 # Package: KeySize
 # KeySize calculates the size of MySQL indexes (keys).
-{
 package KeySize;
 
 use strict;

lib/LogSplitter.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # LogSplitter package $Revision: 7177 $
 # ###########################################################################
-
+{
 # Package: LogSplitter
 # LogSplitter splits MySQL query logs by sessions.
-{
 package LogSplitter;
 
 use strict;

lib/MaatkitTest.pm

@@ -17,7 +17,7 @@
 # ###########################################################################
 # MaatkitTest package $Revision: 7096 $
 # ###########################################################################
-
+{
 # Package: MaatkitTest
 # MaatkitTest is a collection of helper-subs for the Maatkit tests.
 # Any file arguments (like no_diff() $expected_output) are relative to
@@ -26,7 +26,6 @@
 # this terminates the *entire* test process; die instead.  All
 # subs are exported by default, so is the variable $trunk, so there's
 # no need to import() in the test scripts.
-{
 package MaatkitTest;
 
 use strict;

lib/MasterSlave.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # MasterSlave package $Revision: 7525 $
 # ###########################################################################
-
+{
 # Package: MasterSlave
 # MasterSlave handles common tasks related to master-slave setups.
-{
 package MasterSlave;
 
 use strict;

lib/MemcachedEvent.pm

@@ -17,7 +17,7 @@
 # ###########################################################################
 # MemcachedEvent package $Revision: 7096 $
 # ###########################################################################
-
+{
 # Package: MemcachedEvent
 # MemcachedEvent creates events from <MemcachedProtocolParser> data.
 # Since memcached is not strictly MySQL stuff, we have to
@@ -25,7 +25,6 @@
 # 
 # See http://code.sixapart.com/svn/memcached/trunk/server/doc/protocol.txt
 # for information about the memcached protocol.
-{
 package MemcachedEvent;
 
 use strict;

lib/MemcachedProtocolParser.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # MemcachedProtocolParser package $Revision: 7521 $
 # ###########################################################################
-
+{
 # Package: MemcachedProtocolParser
 # MemcachedProtocolParser parses memcached events from tcpdump files.
-{
 package MemcachedProtocolParser;
 
 use strict;

lib/MockSth.pm

@@ -16,9 +16,9 @@
 # this program; if not, write to the Free Software Foundation, Inc., 59 Temple
 # Place, Suite 330, Boston, MA  02111-1307  USA.
 
+{
 # Package: MockSth
 # MockSth simulates a DBI statement handle without a database connection.
-{
 package MockSth;
 
 use strict;

lib/MockSync.pm

@@ -1,4 +1,3 @@
-# This program is copyright 2011 Percona Inc.
 # This program is copyright 2007-2010 Baron Schwartz.
 # Feedback and improvements are welcome.
 #
@@ -16,9 +15,9 @@
 # this program; if not, write to the Free Software Foundation, Inc., 59 Temple
 # Place, Suite 330, Boston, MA  02111-1307  USA.
 
+{
 # Package: MockSync
 # MockSync simulates a table syncer module.  It's used by RowDiff.t.
-{
 package MockSync;
 
 use strict;

lib/MockSyncStream.pm

@@ -15,6 +15,7 @@
 # this program; if not, write to the Free Software Foundation, Inc., 59 Temple
 # Place, Suite 330, Boston, MA  02111-1307  USA.
 
+{
 # Package: MockSyncStream
 # MockSyncStream simulates a <TableSyncStream> module.
 # It's used by mk-upgrade to quickly compare result sets for any differences.
@@ -22,7 +23,6 @@
 # This causes RowDiff::compare_sets() to terminate early.  So we don't actually
 # sync anything.  Unlike TableSyncStream, we're not working with a table but an
 # arbitrary query executed on two servers.
-{
 package MockSyncStream;
 
 use strict;

lib/MySQLConfig.pm

@@ -17,7 +17,7 @@
 # ###########################################################################
 # MySQLConfig package $Revision: 7403 $
 # ###########################################################################
-
+{
 # Package: MySQLConfig
 # MySQLConfig parses and encapsulates system variables and values from
 # SHOW VARIABLES, option files, mysqld --help --verbose or my_print_defaults.
@@ -33,7 +33,6 @@
 #
 # Only variables present in the input are saved in the MySQLConfig object.
 # So if <has()> returns false, then the variable did not appear in the input.
-{
 package MySQLConfig;
 
 use strict;

lib/MySQLConfigComparer.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # MySQLConfigComparer package $Revision: 7403 $
 # ###########################################################################
-
+{
 # Package: MySQLConfigComparer
 # MySQLConfigComparer compares and diffs C<MySQLConfig> objects. 
-{
 package MySQLConfigComparer;
 
 use strict;

lib/MySQLDump.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # MySQLDump package $Revision: 6345 $
 # ###########################################################################
-
+{
 # Package: MySQLDump
 # MySQLDump gets CREATE TABLE defs from MySQL.
-{
 package MySQLDump;
 
 use strict;

lib/MySQLProtocolParser.pm

@@ -17,7 +17,7 @@
 # ###########################################################################
 # MySQLProtocolParser package $Revision: 7522 $
 # ###########################################################################
-
+{
 # Package: MySQLProtocolParser
 # MySQLProtocolParser parses MySQL events from tcpdump files.
 # The packets come from TcpdumpParser.  MySQLProtocolParse::parse_packet()
@@ -34,7 +34,6 @@
 # At times MySQLProtocolParser::parse_packet() will not return an event
 # because it usually takes a few packets to create one event.  In such
 # cases, TcpdumpParser::parse_event() will not call the other callbacks.
-{
 package MySQLProtocolParser;
 
 use strict;

lib/OSCCaptureSync.pm

@@ -17,11 +17,10 @@
 # ###########################################################################
 # OSCCaptureSync package $Revision: 7463 $
 # ###########################################################################
-
+{
 # Package: OSCCaptureSync
 # OSCCaptureSync implements the capture and sync phases of an online schema
 # change.
-{
 package OSCCaptureSync;
 
 use strict;

lib/OptionParser.pm

@@ -18,7 +18,7 @@
 # ###########################################################################
 # OptionParser package $Revision: 7102 $
 # ###########################################################################
-
+{
 # Package: OptionParser
 # OptionParser parses command line options from a tool's POD.  By default
 # it parses a description and usage from the POD's SYNOPSIS section and
@@ -58,7 +58,6 @@
 # The option's full name is given as the "=item".  The next, optional para
 # is the option's attributes.  And the next, required para is the option's
 # description (the first period-terminated sentence).
-{
 package OptionParser;
 
 use strict;

lib/Outfile.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # Outfile package $Revision: 5266 $
 # ###########################################################################
-
+{
 # Package: Outfile
 # Outfile writes rows to a file in SELECT INTO OUTFILE format.
-{
 package Outfile;
 
 use strict;

lib/PgLogParser.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # PgLogParser package $Revision: 5835 $
 # ###########################################################################
-
+{
 # Package: PgLogParser
 # PgLogParser parses Postgres logs.
-{
 package PgLogParser;
 
 use strict;

lib/Pipeline.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # Pipeline package $Revision: 7509 $
 # ###########################################################################
-
+{
 # Package: Pipeline
 # Pipeline executes and controls a list of pipeline processes.
-{
 package Pipeline;
 
 use strict;

lib/PodParser.pm

@@ -17,13 +17,12 @@
 # ###########################################################################
 # PodParser package $Revision: 7053 $
 # ###########################################################################
-
+{
 # Package: PodParser
 # PodParser parses sections of a POD.
 # This package wants to subclasses Pod::Parser but because some people
 # still run ancient systems on which even "core" modules are missing,
 # we have to roll our own pod parser.
-{
 package PodParser;
 
 use strict;

lib/Processlist.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # Processlist package $Revision: 7289 $
 # ###########################################################################
-
+{
 # Package: Processlist
 # Processlist makes events when used to poll SHOW FULL PROCESSLIST.
-{
 package Processlist;
 
 use strict;

lib/ProcesslistAggregator.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # ProcesslistAggregator package $Revision: 6590 $
 # ###########################################################################
-
+{
 # Package: ProcesslistAggregator
 # ProcesslistAggregator aggregates PROCESSLIST entires.
-{
 package ProcesslistAggregator;
 
 use strict;

lib/Progress.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # Progress package $Revision: 7096 $
 # ###########################################################################
-
+{
 # Package: Progress
 # Progress encapsulates a progress report.
-{
 package Progress;
 
 use strict;

lib/ProtocolParser.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # ProtocolParser package $Revision: 7522 $
 # ###########################################################################
-
+{
 # Package: ProtocolParser
 # ProtocolParser is a parent class for protocol-specific parsers.
-{
 package ProtocolParser;
 
 use strict;

lib/QueryAdvisorRules.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # QueryAdvisorRules package $Revision: 7473 $
 # ###########################################################################
-
+{
 # Package: QueryAdvisorRules
 # QueryAdvisorRules encapsulates rules for checking queries.
-{
 package QueryAdvisorRules;
 use base 'AdvisorRules';
 

lib/QueryParser.pm

@@ -17,13 +17,12 @@
 # ###########################################################################
 # QueryParser package $Revision: 7452 $
 # ###########################################################################
-
+{
 # Package: QueryParser
 # QueryParser extracts parts of SQL statements, like table lists and subqueries.
 # This package differs from SQLParser because it only extracts from a query
 # what is needed and only when that can be accomplished rather simply.  By
 # contrast, SQLParser parses the entire SQL statement no matter the complexity.
-{
 package QueryParser;
 
 use strict;

lib/QueryReportFormatter.pm

@@ -17,7 +17,7 @@
 # ###########################################################################
 # QueryReportFormatter package $Revision: 7274 $
 # ###########################################################################
-
+{
 # Package: QueryReportFormatter
 # QueryReportFormatter is used primarily by mk-query-digest to print reports.
 # The main sub is print_reports() which prints the various reports for
@@ -27,7 +27,6 @@
 # fully aggregated and $ea->calculate_statistical_metrics() already called.
 # Subreports "profile" and "prepared" require the ReportFormatter module,
 # which is also in mk-query-digest.
-{
 package QueryReportFormatter;
 
 use strict;

lib/QueryReview.pm

@@ -17,13 +17,12 @@
 # ###########################################################################
 # QueryReview package $Revision: 7342 $
 # ###########################################################################
-
+{
 # Package: QueryReview
 # QueryReview is an API to a query review table.
 # This module is an interface to a "query review table" in which certain
 # historical information about classes of queries is stored.  See the docs on
 # mk-query-digest for context.
-{
 package QueryReview;
 
 use strict;

lib/QueryRewriter.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # QueryRewriter package $Revision: 7473 $
 # ###########################################################################
-
+{
 # Package: QueryRewriter
 # QueryRewriter rewrites and transforms queries.
-{
 package QueryRewriter;
 
 use strict;

lib/Quoter.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # Quoter package $Revision: 6850 $
 # ###########################################################################
-
+{
 # Package: Quoter
 # Quoter handles value quoting, unquoting, escaping, etc.
-{
 package Quoter;
 
 use strict;

lib/ReportFormatter.pm

@@ -17,7 +17,7 @@
 # ###########################################################################
 # ReportFormatter package $Revision: 7473 $
 # ###########################################################################
-
+{
 # Package: ReportFormatter
 # ReportFormatter makes columnized reports given variable-width data lines.
 # It does the hard work of automatically sizing columns and truncating data
@@ -54,7 +54,6 @@
 # After these adjustments, get_report() calls _truncate_headers() and
 # _truncate_line_values().  These truncate output to the columns' final,
 # calculated widths.
-{
 package ReportFormatter;
 
 use strict;

lib/Retry.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # Retry package $Revision: 7473 $
 # ###########################################################################
-
+{
 # Package: Retry
 # Retry retries code until a condition succeeds.
-{
 package Retry;
 
 use strict;

lib/RowDiff.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # RowDiff package $Revision: 5697 $
 # ###########################################################################
-
+{
 # Package: RowDiff
 # RowDiff compares two sets of rows to find ones that are different.
-{
 package RowDiff;
 
 use strict;

lib/Runtime.pm

@@ -17,7 +17,7 @@
 # ###########################################################################
 # Runtime package $Revision: 7221 $
 # ###########################################################################
-
+{
 # Package: Runtime
 # Runtime keeps track of time to control how long a tool's main loop runs.
 # This package was created to handle mk-query-digest --run-time-mode event.
@@ -25,7 +25,6 @@
 # now() comes from a clock, a log timestamp, or wherever.  The creator of
 # Runtime object determines how, or from where, time is gotten so that the
 # caller of the object can simply ask, "What time is it?".
-{
 package Runtime;
 
 use strict;

lib/SQLParser.pm

@@ -17,7 +17,7 @@
 # ###########################################################################
 # SQLParser package $Revision: 7565 $
 # ###########################################################################
-
+{
 # Package: SQLParser
 # SQLParser parses common MySQL SQL statements into data structures.
 # This parser is MySQL-specific and intentionally meant to handle only
@@ -36,7 +36,6 @@
 # This package differs from QueryParser because here we parse the entire SQL
 # statement (thus giving access to all its parts), whereas QueryParser extracts
 # just needed parts (and ignores all the rest).
-{
 package SQLParser;
 
 use strict;

lib/Sandbox.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # Sandbox package $Revision: 7140 $
 # ###########################################################################
-
+{
 # Package: Sandbox
 # Sandbox is an API for the test suite to access and control sandbox servers.
-{
 package Sandbox;
 
 BEGIN {

lib/Schema.pm

@@ -17,7 +17,7 @@
 # ###########################################################################
 # Schema package $Revision: 7565 $
 # ###########################################################################
-
+{
 # Package: Schema
 # Schema encapsulates a data structure representing databases and tables.
 # Although in MySQL "schema" is technically equivalent to "databae", we
@@ -49,7 +49,6 @@
 #
 # Schema objects are usually added by a <SchemaIterator>, but you can add
 # them manually if needed; see <add_schema_object()>.
-{
 package Schema;
 
 use strict;

lib/SchemaIterator.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # SchemaIterator package $Revision: 7547 $
 # ###########################################################################
-
+{
 # Package: SchemaIterator
 # SchemaIterator iterates schema objects.
-{
 package SchemaIterator;
 
 use strict;

lib/SimpleTCPDumpParser.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # SimpleTCPDumpParser package $Revision: 7515 $
 # ###########################################################################
-
-# Package: SimpleTCPDumperParser
-# SimpleTCPDumpParser parses simple tcpdump output.
 {
+# Package: SimpleTCPDumpParser
+# SimpleTCPDumpParser parses simple tcpdump output.
 package SimpleTCPDumpParser;
 
 use strict;

lib/SlowLogParser.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # SlowLogParser package $Revision: 7522 $
 # ###########################################################################
-
+{
 # Package: SlowLogParser
 # SlowLogParser parses MySQL slow logs.
-{
 package SlowLogParser;
 
 use strict;

lib/SlowLogWriter.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # SlowLogWriter package $Revision: 6590 $
 # ###########################################################################
-
+{
 # Package: SlowLogWriter
 # SlowLogWriter writes events to a file in MySQL slow log format.
-{
 package SlowLogWriter;
 
 use strict;

lib/SysLogParser.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # SysLogParser package $Revision: 5831 $
 # ###########################################################################
-
+{
 # Package: SysLogParser
 # SysLogParser parses events from syslogs.
-{
 package SysLogParser;
 
 use strict;

lib/TCPRequestAggregator.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # TCPRequestAggregator package $Revision: 7515 $
 # ###########################################################################
-
+{
 # Package: TCPRequestAggregator
 # TCPRequestAggregator aggregates TCP requests from tcpdump files.
-{
 package TCPRequestAggregator;
 
 use strict;

lib/TableChecksum.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # TableChecksum package $Revision: 7080 $
 # ###########################################################################
-
+{
 # Package: TableChecksum
 # TableChecksum checksums tables.
-{
 package TableChecksum;
 
 use strict;

lib/TableChunker.pm

@@ -18,7 +18,7 @@
 # ###########################################################################
 # TableChunker package $Revision: 7169 $
 # ###########################################################################
-
+{
 # Package: TableChunker
 # TableChunker helps determine how to "chunk" a table.  Chunk are
 # pre-determined ranges of rows defined by boundary values (sometimes also
@@ -42,7 +42,6 @@
 # distribution of values on the chunk colun can skew chunking.  If, for
 # example, col has values 0, 100, 101, ... then the zero value skews chunking.
 # The zero_chunk arg handles this.
-{
 package TableChunker;
 
 use strict;

lib/TableNibbler.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # TableNibbler package $Revision: 5266 $
 # ###########################################################################
-
+{
 # Package: TableNibbler
 # TableNibbler determines how to nibble a table by chunks of rows.
-{
 package TableNibbler;
 
 use strict;

lib/TableParser.pm

@@ -18,7 +18,7 @@
 # ###########################################################################
 # TableParser package $Revision: 7550 $
 # ###########################################################################
-
+{
 # Package: TableParser
 # TableParser parses SHOW CREATE TABLE.
 #
@@ -33,7 +33,6 @@
 # $opts->{mysql_version} is typically used, which is the return value from
 # VersionParser::parser() (which returns a zero-padded MySQL version,
 # e.g. 004001000 for 4.1.0).
-{
 package TableParser;
 
 use strict;

lib/TableSyncChunk.pm

@@ -18,7 +18,7 @@
 # ###########################################################################
 # TableSyncChunk package $Revision: 6389 $
 # ###########################################################################
-
+{
 # Package: TableSyncChunk
 # TableSyncChunk is a table sync algo that uses discrete chunks.
 # This package implements a simple sync algorithm:
@@ -28,7 +28,6 @@
 # * Checksum them (state 2)
 # * If a row differs, it must be synced
 # See TableSyncStream for the TableSync interface this conforms to.
-{
 package TableSyncChunk;
 
 use strict;

lib/TableSyncGroupBy.pm

@@ -18,13 +18,12 @@
 # ###########################################################################
 # TableSyncGroupBy package $Revision: 5697 $
 # ###########################################################################
-
+{
 # Package: TableSyncGroupBy
 # TableSyncGroupBy is a table sync algo that uses GROUP BY.
 # This package syncs tables without primary keys by doing an all-columns GROUP
 # BY with a count, and then streaming through the results to see how many of
 # each group exist.
-{
 package TableSyncGroupBy;
 
 use strict;

lib/TableSyncNibble.pm

@@ -18,7 +18,7 @@
 # ###########################################################################
 # TableSyncNibble package $Revision: 6511 $
 # ###########################################################################
-
+{
 # Package: TableSyncNibble
 # TableSyncNibble is a table sync algo that uses <TableNibbler>.
 # This package implements a moderately complex sync algorithm:
@@ -29,7 +29,6 @@
 # * Checksum them (state 2)
 # * If a row differs, it must be synced
 # See TableSyncStream for the TableSync interface this conforms to.
-{
 package TableSyncNibble;
 
 use strict;

lib/TableSyncStream.pm

@@ -18,12 +18,11 @@
 # ###########################################################################
 # TableSyncStream package $Revision: 5697 $
 # ###########################################################################
-
+{
 # Package: TableSyncStream
 # TableSyncStream is a table sync algo that selects all rows.
 # This package implements the simplest possible table-sync algorithm:
 # read every row from the tables and compare them.
-{
 package TableSyncStream;
 
 use strict;

lib/TableSyncer.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # TableSyncer package $Revision: 7528 $
 # ###########################################################################
-
+{
 # Package: TableSyncer
 # TableSyncer helps sync tables with various table sync algo modules.
-{ 
 package TableSyncer;
 
 use strict;

lib/TableUsage.pm

@@ -17,7 +17,7 @@
 # ###########################################################################
 # TableUsage package $Revision: 7498 $
 # ###########################################################################
-
+{
 # Package: TableUsage
 # TableUsage determines how tables in a query are used.
 #
@@ -28,7 +28,6 @@
 # This package uses both QueryParser and SQLParser.  The former is used for
 # simple queries, and the latter is used for more complex queries where table
 # usage may be hidden in who-knows-which clause of the SQL statement.
-{
 package TableUsage;
 
 use strict;

lib/TcpdumpParser.pm

@@ -18,14 +18,13 @@
 # ###########################################################################
 # TcpdumpParser package $Revision: 7505 $
 # ###########################################################################
-
+{
 # Package: TcpdumpParser
 # TcpdumpParser parses TCP packets from tcpdump files.
 # It expects the output to be formatted a certain way.
 # See the t/samples/tcpdumpxxx.txt files for examples.
 # Here's a sample command on Ubuntu to produce the right formatted output:
 # tcpdump -i lo port 3306 -s 1500 -x -n -q -tttt
-{
 package TcpdumpParser;
 
 use strict;

lib/TextResultSetParser.pm

@@ -17,7 +17,7 @@
 # ###########################################################################
 # TextResultSetParser package $Revision: 6898 $
 # ###########################################################################
-
+{
 # Package: TextResultSetParser
 # TextResultSetParser converts a text result set to a data struct like
 # DBI::selectall_arrayref().  Text result sets are like what SHOW PROCESSLIST
@@ -39,7 +39,6 @@
 #   ]
 # (end code)
 # Both horizontal and vertical (\G) text outputs are supported.
-{
 package TextResultSetParser;
 
 use strict;

lib/TimeSeriesTrender.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # TimeSeriesTrender package $Revision: 7096 $
 # ###########################################################################
-
+{
 # Package: TimeSeriesTrender
 # TimeSeriesTrender calculates trends in time.
-{
 package TimeSeriesTrender;
 
 use strict;

lib/Transformers.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # Transformers package $Revision: 7226 $
 # ###########################################################################
-
+{
 # Package: Transformers
 # Transformers exports subroutines that convert and beautify values.
-{
 package Transformers;
 
 use strict;

lib/UpgradeReportFormatter.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # UpgradeReportFormatter package $Revision: 7193 $
 # ###########################################################################
-
+{
 # Package: UpgradeReportFormatter
 # UpgradeReportFormatter formats the output of pt-upgrade.
-{
 package UpgradeReportFormatter;
 
 use strict;

lib/VariableAdvisorRules.pm

@@ -17,10 +17,9 @@
 # ###########################################################################
 # VariableAdvisorRules package $Revision: 6821 $
 # ###########################################################################
-
+{
 # Package: VariableAdvisorRules
 # VariableAdvisorRules specifies rules for checking MySQL variables.
-{
 package VariableAdvisorRules;
 use base 'AdvisorRules';
 

lib/VersionParser.pm

@@ -18,10 +18,9 @@
 # ###########################################################################
 # VersionParser package $Revision: 6667 $
 # ###########################################################################
-
+{
 # Package: VersionParser
 # VersionParser parses a MySQL version string.
-{
 package VersionParser;
 
 use strict;