NAME

p4delta - Summarize the differences between a Perforce project and local files.


SYNOPSIS

p4delta [options] [file ...]


DESCRIPTION

Summarizes the differences between a Perforce 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.


OPTIONS

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

-e, --execute
Execute the associated Perforce commands (``add'', ``edit'', and ``remove'') for the added, edited and deleted files.

-h, --help
Display a help message.

-q, --quiet
Run with minimum output.

-v, --version
Display the version and exit.

-V, --verbose
Run with maximum output.


ARGUMENTS

Arguments may be either files or directories.

File
If a file is provided, it is compared against the equivalent in CVS, if any. The .cvsignore files are applied, so that although the file was explicitly provided, it may be ignored.

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

File
If a file is provided, it is compared against the equivalent in Perforce, if any. .p4ignore files are applied, so that although the file was explicitly provided, it may be ignored.

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


EXAMPLES

    % p4delta

Lists the changed files.

    % p4delta --execute

Lists the changed files, and executes the associated add and remove commands.


FILES

Files may be filtered by .p4ignore files, locate both in the user's home directory and locally, in each directory. For example:

    *.bak
    *.class
    *.o
    *.out
    *~
    .libs
    core

See http://www.loria.fr/~molli/cvs/doc/cvs_18.html#SEC170 for how this is used in CVS, from which this idea was taken.


NOTES

If a file exists in the Perforce 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.


AUTHOR

Jeff Pace <jpace@incava.org>


COPYRIGHT

Copyright (c) 2002, 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.