CVSDELTA(1)

πŸ’– CVSDELTA(1) πŸ’–

okay bestie, sit down, hydrate, and let me tell you about cvsdelta β€” she's version 1.7.0 and she is the girl for figuring out what's different between your CVS project and the files chillin' on your actual disk. πŸ¦‹


✨ NAME ✨

cvsdelta β€” manage and summarize the differences between a CVS project and local files. πŸ’…


πŸŽ€ SYNOPSIS πŸŽ€

cvsdelta [options] [file ...]

🌸 DESCRIPTION 🌸

So basically: cvsdelta manages and summarizes the differences between a CVS project and your local files. Not just which files changed, but the changes of the files themselves and of their contents. She's thorough, she's detail-oriented, she's giving main character energy. πŸ‘‘

Added, changed, and deleted files get denoted with +, *, and - respectively, and the number of lines is displayed. No cap. ✨


πŸ’… OPTIONS πŸ’…

  • -a, --adds β€” show the files that were added. This is what happens by default, so she's already doing it. πŸ’–
  • -A, --no-adds β€” do not show the files that were added. (The default is to show the added files, so this is you being contrarian and we respect it.)
  • --banner, --no-banner β€” whether to show the banner, i.e. the header and footer of the output table. By default, the banner is displayed. πŸŽ€
  • -c, --changes β€” show the files that were changed. Done by default, bestie.
  • -C, --no-changes, --nodiff β€” do not compare files that exist locally and in CVS. This executes significantly faster, and it's useful when you only wanna add and remove files without getting the summary of the changes. It's also helpful for dealing with situations where CVS seems to hang after producing diff output β€” although changing the compression level can help with that too. The default is to show the changed files.
  • -d, --deletes β€” show the files that were deleted. Also default, she's got you. 🫢
  • -D, --no-deletes β€” do not display the files that were deleted. (The default is to show the files that were deleted.)
  • -e, --execute β€” execute the associated CVS commands ("add" and "remove") for the added and deleted files. She's not just telling you anymore, she's doing. πŸ”₯
  • -f DATE, --from-date DATE β€” compare the files to their version as of the given date, rather than their current version in CVS. The date is expected to be in CVS format, for example, 2002/12/31.
  • -F REVISION, --from-revision REVISION β€” compare the files to their version as of the given revision, rather than their current version in CVS.
  • -h, --help β€” display a help message. 🌈
  • -i, --confirm β€” interactively confirm deleted files with the user before removing them from CVS. The default is simply to execute the remove command for relevant files. This option is valid only with the --execute option. ⚠️
  • --progress, --no-progress β€” whether to show the progress meter while the program is working with CVS. By default, this is not shown.
  • -q, --quiet β€” run with minimum output. In quiet mode, the progress meter is not displayed. 🀫
  • -s, --skip-unknown-directories β€” skip directories that are not in CVS. The default behavior is to process all subdirectories.
  • -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 CVS format, for example, 2001/08/21. This option is valid only with the --from-date or --from-revision options.
  • -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.
  • -v, --version β€” display the version and exit. πŸ’«
  • -V, --verbose β€” run with maximum output, which is written to standard error.
  • -z [LEVEL], ---compression [LEVEL] β€” set the compression to the given level for net traffic. This can be useful if the CVS server seems to hang. The default level is 3; 0 and 9 work well. πŸ‘€
bestie, yes, that really is three dashes on ---compression. She's quirky like that. Don't "fix" it. πŸ™ˆ

🧚 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. Rude, but that's the rules. πŸ’€

πŸ“ Directory

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


⭐ EXAMPLES ⭐

% cvsdelta

Lists the changed files.

% cvsdelta --execute

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

% cvsdelta --compression 9 --execute --confirm --no-changes

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 CVS.


🌈 ENVIRONMENT 🌈

$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:

quiet:                    false
verbose:                  false
execute:                  false
confirm:                  false
diff:                     true
compression:              3
adds:                     true
changes:                  true
deletes:                  true
skip-unknown-directories: false
banner:                   true

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

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. πŸ‘‘

CVSDELTAOPTS

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


πŸ”₯ NOTES πŸ”₯

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

so like, heads up: someone else's fresh cvs add can look exactly like a delete from where you're standing. --confirm is your bestie here.

πŸ’œ AUTHOR πŸ’œ

Jeff Pace <jpace@incava.org>


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.


and that's the whole thing, babe 🫢 β€” this was cvsdelta version 1.7.0, dated 2004-04-08, and honestly? iconic. go diff something. periodt. πŸ’–βœ¨πŸŽ€