The Perltidy Home Page

Welcome to Perltidy

Perltidy is a Perl script which indents and reformats Perl scripts to make them easier to read. If you write Perl scripts, or spend much time reading them, you will probably find it useful.

Here are a few examples of reformatted code snippets:

Some code with side comments

A loop

A hash definition list

A matrix

A complex data structure

Cleaning up code from a code generator

The formatting can be controlled with command line parameters. The default parameter settings approximately follow the suggestions in the Perl Style Guide.

Perltidy can also output html of both pod and source code. For example, the link below is an html version of the module Conf.pm from SpamAssassin.

An html example

Besides reformatting scripts, Perltidy can be a great help in tracking down errors with missing or extra braces, parentheses, and square brackets because it is very good at localizing errors.

Documentation

A Brief Perltidy Tutorial.
Perltidy Style Key will guide you in methodically selecting a set of style parameters.
The Perltidy man page explains how to precisely control the formatting details.
Change Log.
Open BUGS.
The Perl::Tidy man page discusses how to use the Perl::Tidy module.
The license is the GNU General Public License