vsav

NAME

SYNOPSIS

vsav file...

vsav -l file

vsav -a [ select ]

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

vsav -p file -v version

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

vls file

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.

OPTIONS

-h

usage message.

-i

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

-u

uninstall the 'v(sav|ls) 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.

-a [ select ]

list all saved files with the most recent version. With select the FILE column is 'fgrep-ed' by select.

-c

cat a saved version of a given file.

-d

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

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

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

ENVIRONMENT

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

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.