=head1 NAME

svndelta - Manage and summarize the differences between a Subversion project and
local files.

=head1 SYNOPSIS

B<svndelta> [options] [file ...]

=head1 DESCRIPTION

Manages and summarizes the differences between a Subversion project and local
files, showing the changes of the files themselves and of their contents. Added,
changed, and deleted files are denoted with `+', `*', and `-' respectively. The
number of lines are displayed.

=head1 OPTIONS

=over 4

=item B<--banner>, B<--no-banner>

Whether to show the banner, i.e., the header and footer of the output table. By
default, the banner is displayed.

=item B<-e>, B<--execute>

Execute the associated Subversion commands ("add" and "remove") for the added and
deleted files.

=item B<-h>, B<--help>

Display a help message.

=item B<-i>, B<--confirm>

Interactively confirm deleted files with the user before removing them from Subversion.
The default is simply to execute the remove command for relevant files. This
option is valid only with the --execute option.

=item B<-q>, B<--quiet>

Run with minimum output. In quiet mode, the progress meter is not displayed.

=item B<--prune>

Skip directories that are not in Subversion. The default behavior is to process
all subdirectories.

=item B<-v>, B<--version>

Display the version and exit.

=item B<-V>, B<--verbose>

Run with maximum output, which is written to standard error.

=back

=head1 ARGUMENTS

Arguments may be either files or directories. If no argument is given, the
current directory is assumed.

=over 4

=item B<File>

If a file is provided, it is compared against the equivalent in Subversion, if
any.

=item B<Directory>

Directories are processed recursively for files that are not filtered out by
.svnignore files.

=back

=head1 EXAMPLES

    % svndelta

List the changed files.

    % svndelta --execute

List the changed files, and execute the associated add and remove commands.

    % svndelta --confirm

Add and remove the appropriate files, but get confirmation from the user before
removing any files.

=head1 ENVIRONMENT

=over 4

=item $HOME/.svndeltarc, .../project/.svndeltarc

Resource files containing name/value pairs, separated by either ':' or '='. The
valid fields of a .svndeltarc file are as follows, with their default values:

    quiet:    false
    verbose:  false
    execute:  false
    prune:    false
    banner:   true

"yes" and "on" are synonymnous with "true". "no" and "off" signify "false".

The values in the project .svndeltarc file will override those in the user's
.svndeltarc file. The project .svndeltarc is assumed to be at the topmost
directory in the local file hierarchy.

=item SVNDELTAOPTS

A string of whitespace-delimited options, the same as listed above. These values
override those of the resource files.

=back

=head1 NOTES

If a file exists in the Subversion project but not locally, it is assumed that
the file has been deleted, not that it may have been recently added by another
user. The --confirm option can be used to deal with this situation.

=head1 AUTHOR

Jeff Pace <jpace@incava.org>

=head1 COPYRIGHT

Copyright (c) 2006, Jeff Pace.

All Rights Reserved. This module is free software. It may be used, redistributed
and/or modified under the terms of the Lesser GNU Public License. See
http://www.gnu.org/licenses/lgpl.html for more information.

=cut