vsav, vcat, vdiff, vsdiff, vgdiff, vls, vrm

NAME

SYNOPSIS

vsav file...

vsav -l file

vsav -e file...

vsav (-a | -A) [ select ]

vsav (-d | -s | -g | -c | -r) file [ -v version ]

vsav -p file -v version

---

WA2LWinTools/bin/vls [ -h | -i | -u | -V ]

vls file

---

WA2LWinTools/lib/[shell/]vrm [ -h | -i | -u | -V ]

vrm file...

---

WA2LWinTools/lib/[shell/]vcat [ -h | -V ]

vcat file [ -v version ]

---

WA2LWinTools/lib/[shell/]vdiff [ -h | -V ]

vdiff file [ -v version ]

---

WA2LWinTools/lib/[shell/]vsdiff [ -h | -V ]

vsdiff file [ -v version ]

---

WA2LWinTools/lib/[shell/]vgdiff [ -h | -V ]

vgdiff file [ -v version

AVAILABILITY

DESCRIPTION

When saving a file, a new version is stored (compressed using gzip(1)), if the most recent saved file is not identical to the current file.

When restoring a file, automatically the file to be overwritten is saved.

When erasing/removing a file, automatically the file to be removed is saved.

OPTIONS

-h

usage message.

-i

install the 'v(sav|ls|rm) file...' command to the 'SendTo' Windows™ explorer context menu.

-u

uninstall the 'v(sav|ls|rm) file...' command from the 'SendTo' Windows™ explorer context menu.

-V

print program version.

-l

list saved versions of a given file.

This is equal to the 'vls file' command.

-e

erase/remove the given file(s). Ahead of removing a file it saved. This is equal to the 'vrm file...' command.

-a [ select ]

list all saved files with the most recent version.

With select the FILE column is 'fgrep-ed' by select.

To select the files of the current working directory use 'vsav -a %cd%'.

To select a path and ensure the selection is done from the beginning and not anywhere, use 'vsav -a "^\tmp\"' or specify a drive name 'vsav -a d:\tmp\'.

-A [ select ]

as -a option, but print a plain list of all saved files.

-c

cat a saved version of a given file.

This is equal to the 'vcat file' command.

-d

diff a saved version of a given file to the current file.

This is equal to the 'vdiff file' command.

-s

diff a saved version of a given file to the current file in side-by-side output.

The output width is adjusted to the terminal width (%COLUMNS%).

This is equal to the 'vsdiff file' command.

-g

diff a saved version of a given file to the current file in the compareit(1) GUI application.

This is equal to the 'vgdiff file' command.

To make CompareIt handle the gzip-ed saved file versions the GZip file converter in CompareIt -> Tools -> Converter -> [Add] needs to be specified as follows:

  Name:      GZIP file
  Mask:      *.gz
  Command:   H:\bin\WA2LWinTools\lib\wincmp\cnv\gzipcnv.cmd
  Arguments: {$Source_File} {$Converted_File}

The directory H:\bin\ is the install directory of the WA2L/WinTools package and needs to be initially set as in your installation.

-r

restore given file with the specified saved version.

When restoring a file, automatically the file to be overwritten is saved.

To restore a saved version of a file to a different location or filename, use the 'vsav -c myfile.txt -v 5 > mynewfile.txt' command.

The timestamp of the file to be restored is set to the timestamp of the version of the saved file.

-p

purge saved versions of a given file up to the specified version.

If version is set to 0 all saved versions are purged.

file

file to be saved, printed, restored, compared, purged or listed.

When giving a file including path, a slash (/) can be used interchangeably with a backslash (\). E.g. dat/dir/notes.txt is equal to dat\dir\notes.txt.

-v version

version of saved file to be restored, printed, purged or compared.

If no version is specified on optional usage, the most recent saved version of the file is chosen.

vls file

list saved versions of a given file.

This is equal to the 'vsav -l file' command.

vrm file...

erase/remove the given file(s). Ahead of removing a file it saved.

This is equal to the 'vsav -e file...' command.

vcat file

cat the saved version of the given file.

This is equal to the 'vsav -c file' command.

vdiff file

diff the saved version of the given file to the current file.

This is equal to the 'vsav -d file' command.

vsdiff file

diff the saved version of the given file to the current file in side-by-side output.

The output width is adjusted to the terminal width (%COLUMNS%).

This is equal to the 'vsav -s file' command.

vgdiff file

diff the saved version of the given file to the current file in CompareIt GUI.

This is equal to the 'vsav -g file' command.

ENVIRONMENT

%COLUMNS%

terminal width for the vsav -s or vsdiff command.

To quickly update the %COLUMNS% variable on terminals lacking automatic update on resize, the tty(1) command can be used.

EXIT STATUS

0

no error.

1

error.

4

usage printed.

5

version printed.

FILES

var/cache/vsav/

location where the saved versions of the files are stored.

var/cache/vsav/<md5sum(\path\file)>-<version>.gz

saved version of file.

var/cache/vsav/.index

index file that informs which \path\file resulted in <md5sum(\path\file).

lib/wincmp/cnv/gzipcnv.cmd

converter for CompareIt to handle to compair gzip-ed files.

EXAMPLES

SEE ALSO

NOTES

BUGS

AUTHOR

COPYRIGHT

This is free software; see WA2LWinTools/man/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.