

                                   cvsq
                                 
                                a cvs queue
                              ---------------


1. Introduction
---------------

cvsq stands for "CVS queued" and it's a tool that enables developers 
with dial-up connection to work comfortably with CVS. It accepts same 
arguments as CVS but instead of directly processing them, cvsq stores 
all requests in a queue and handles them later

This way, you can mark several files for commit and upload them
to the server later, when you're connected to the net.




2. Installation
---------------

Just do 
    su -c 'make install'
You may want to change prefix variable in Makefile (defaults to /usr/local).

If you had previous installation, don't forget to empty the queue
before upgrading!


3. Usage
--------

Same as cvs. Type
   cvsq --help
for a list of commands.

For example, you can commit files immediately after editing them, 
when being offline, so you don't forget about them:

    cvsq commit -m "change 1" file1.c
    cvsq commit -m "change 2" file2.c
    cvsq commit -m "change 3" file3.c

And then, when you go online, you simply type

    cvsq upload

and all changes will be commited into the repository. If uploading of 
a particular file fails, it won't be lost -- instead, you'll see error 
message and the file will stay in cvsq queue.

You can use cvsq even for commands that make no sense when offline -- 
in that case, the command is immediately passed to cvs and not queued.
For example, you can call `cvsq update' and it won't be put into the 
queue but executed immediately. In fact, you can start using cvsq as 
a replacement for cvs.




4. Licensing
------------

This script is in public domain. Do whatever you want with it.



Enjoy!

Vaclav Slavik <vaclav.slavik@matfyz.cz>
