.\" Automatically generated by Pod::Man v1.34, Pod::Parser v1.13 .\" .\" Standard preamble: .\" ======================================================================== .de Sh \" Subsection heading .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. | will give a .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' .\" expand to `' in nroff, nothing in troff, for use with C<>. .tr \(*W-|\(bv\*(Tr .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .\" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .hy 0 .if n .na .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "CVSDELTA 1" .TH CVSDELTA 1 "2004-04-08" "cvsdelta 1.7.0" "cvsdelta 1.7.0" .SH "NAME" cvsdelta \- Manage and summarize the differences between a CVS project and local files. .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBcvsdelta\fR [options] [file ...] .SH "DESCRIPTION" .IX Header "DESCRIPTION" Manages and summarizes the differences between a \s-1CVS\s0 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. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-a\fR, \fB\-\-adds\fR" 4 .IX Item "-a, --adds" Display the files that were added. This is done by default. .IP "\fB\-A\fR, \fB\-\-no\-adds\fR" 4 .IX Item "-A, --no-adds" Do not display the files that were added. The default is to show the added files. .IP "\fB\-\-banner\fR, \fB\-\-no\-banner\fR" 4 .IX Item "--banner, --no-banner" Whether to show the banner, i.e., the header and footer of the output table. By default, the banner is displayed. .IP "\fB\-c\fR, \fB\-\-changes\fR" 4 .IX Item "-c, --changes" Display the files that were changed. This is done by default. .IP "\fB\-C\fR, \fB\-\-no\-changes\fR, \fB\-\-nodiff\fR" 4 .IX Item "-C, --no-changes, --nodiff" Do not compare files that exist locally and in \s-1CVS\s0. This executes significantly faster, and is useful for when one only wants to add and remove files, without getting the summary of the changes. It is also helpful for dealing with situations where \s-1CVS\s0 seems to hang after producing diff output, although changing the compression level can help with this. The default is to show the changed files. .IP "\fB\-d\fR, \fB\-\-deletes\fR" 4 .IX Item "-d, --deletes" Display the files that were deleted. This is done by default. .IP "\fB\-D\fR, \fB\-\-no\-deletes\fR" 4 .IX Item "-D, --no-deletes" Do not display the files that were deleted. The default is to show the files that were deleted. .IP "\fB\-e\fR, \fB\-\-execute\fR" 4 .IX Item "-e, --execute" Execute the associated \s-1CVS\s0 commands (\*(L"add\*(R" and \*(L"remove\*(R") for the added and deleted files. .IP "\fB\-f \s-1DATE\s0\fR, \fB\-\-from\-date \s-1DATE\s0\fR" 4 .IX Item "-f DATE, --from-date DATE" Compare the files to their version as of the given date, rather than their current version in \s-1CVS\s0. The date is expected to be in \s-1CVS\s0 format, for example, 2002/12/31. .IP "\fB\-F \s-1REVISION\s0\fR, \fB\-\-from\-revision \s-1REVISION\s0\fR" 4 .IX Item "-F REVISION, --from-revision REVISION" Compare the files to their version as of the given revision, rather than their current version in \s-1CVS\s0. .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" Display a help message. .IP "\fB\-i\fR, \fB\-\-confirm\fR" 4 .IX Item "-i, --confirm" Interactively confirm deleted files with the user before removing them from \s-1CVS\s0. The default is simply to execute the remove command for relevant files. This option is valid only with the \-\-execute option. .IP "\fB\-\-progress\fR, \fB\-\-no\-progress\fR" 4 .IX Item "--progress, --no-progress" Whether to show the progress meter as the program is working with \s-1CVS\s0. By default, this is not shown. .IP "\fB\-q\fR, \fB\-\-quiet\fR" 4 .IX Item "-q, --quiet" Run with minimum output. In quiet mode, the progress meter is not displayed. .IP "\fB\-s\fR, \fB\-\-skip\-unknown\-directories\fR" 4 .IX Item "-s, --skip-unknown-directories" Skip directories that are not in \s-1CVS\s0. The default behavior is to process all subdirectories. .IP "\fB\-t \s-1DATE\s0\fR, \fB\-\-to\-date \s-1DATE\s0\fR" 4 .IX Item "-t DATE, --to-date DATE" Compare the files to their version as of the given date, rather than to the local files. The date is expected to be in \s-1CVS\s0 format, for example, 2001/08/21. This option is valid only with the \-\-from\-date or \-\-from\-revision options. .IP "\fB\-T \s-1REVISION\s0\fR, \fB\-\-to\-revision \s-1REVISION\s0\fR" 4 .IX Item "-T REVISION, --to-revision REVISION" Compare the files to their version as of the given revision, rather than to the local files. This is valid only with the \-\-from\-date or \-\-from\-revision options. .IP "\fB\-v\fR, \fB\-\-version\fR" 4 .IX Item "-v, --version" Display the version and exit. .IP "\fB\-V\fR, \fB\-\-verbose\fR" 4 .IX Item "-V, --verbose" Run with maximum output, which is written to standard error. .IP "\fB\-z [\s-1LEVEL\s0]\fR, \-\fB\-\-compression [\s-1LEVEL\s0]\fR" 4 .IX Item "-z [LEVEL], ---compression [LEVEL]" Set the compression to the given level for net traffic. This can be useful if the \s-1CVS\s0 server seems to hang. The default level is 3; 0 and 9 work well. .SH "ARGUMENTS" .IX Header "ARGUMENTS" Arguments may be either files or directories. .IP "\fBFile\fR" 4 .IX Item "File" If a file is provided, it is compared against the equivalent in \s-1CVS\s0, if any. The \&.cvsignore files are applied, so that although the file was explicitly provided, it may be ignored. .IP "\fBDirectory\fR" 4 .IX Item "Directory" Directories are processed recursively for files that are not filtered out by \&.cvsignore files. .SH "EXAMPLES" .IX Header "EXAMPLES" .Vb 1 \& % cvsdelta .Ve .PP Lists the changed files. .PP .Vb 1 \& % cvsdelta --execute .Ve .PP Lists the changed files, and executes the associated add and remove commands. .PP .Vb 1 \& % cvsdelta --compression 9 --execute --confirm --no-changes .Ve .PP Run with the maximum compression level. Add and remove the appropriate files, but get confirmation from the user before removing any files. Do not compare files that exist both locally and in \s-1CVS\s0. .SH "ENVIRONMENT" .IX Header "ENVIRONMENT" .IP "$HOME/.cvsdeltarc, .../project/.cvsdeltarc" 4 .IX Item "$HOME/.cvsdeltarc, .../project/.cvsdeltarc" Resource files containing name/value pairs, separated by either ':' or '='. The valid fields of a .cvsdeltarc file are as follows, with their default values: .Sp .Vb 11 \& quiet: false \& verbose: false \& execute: false \& confirm: false \& diff: true \& compression: 3 \& adds: true \& changes: true \& deletes: true \& skip-unknown-directories: false \& banner: true .Ve .Sp \&\*(L"yes\*(R" and \*(L"on\*(R" are synonymnous with \*(L"true\*(R". \*(L"no\*(R" and \*(L"off\*(R" signify \*(L"false\*(R". .Sp The values in the project .cvsdeltarc file will override those in the user's \&.cvsdeltarc file. The project .cvsdeltarc is assumed to be at the topmost directory in the local file hierarchy. .IP "\s-1CVSDELTAOPTS\s0" 4 .IX Item "CVSDELTAOPTS" A string of whitespace-delimited options, the same as listed above. These values override those of the resource files. .SH "NOTES" .IX Header "NOTES" If a file exists in the \s-1CVS\s0 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. .SH "AUTHOR" .IX Header "AUTHOR" Jeff Pace .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (c) 2002, Jeff Pace. .PP All Rights Reserved. This module is free software. It may be used, redistributed and/or modified under the terms of the Lesser \s-1GNU\s0 Public License. See http://www.gnu.org/licenses/lgpl.html for more information.