.TH CVSQ-SWITCH 1 "May 7, 2007" "" ""
.SH NAME
cvsq-switch - switch between different ques for cvs

.SH SYNOPSIS
\fBcvsq-switch [queuename]\fR
.br

.SH DESCRIPTION
If, for some reason, not all locally stored cvs actions can be
uploaded at the same time, it can be useful to store the commits in
different queues. cvsq-switch switches to the named queue, so that all
cvsq commands will refer to this queue. The active queue is stored
under ~/.cvsq-deferred-queues/queues, so that by a new switch you can
change back to this queue. If no queue name is given, then the name
"default" is assumed. If the current was not named by a call to
cvsq-switch, its named is assumed to be "default".

.SH FILE STRUCTURE
The file ~/.cvsq-deferred-queues/current contains the name of the
current queue. If the file doesn't exist, it is generated and will
contain the string "default". The directory
~/.cvsq-deferred-queues/queues contains the deferred queues, where the
directory-name of a deferred queue is the quoted name of that queue.
It is an invariant that the directory for the queue named in current
does not exist.

Upon call of cvsq-switch with a queue name different from that of the
current queue, first the directory ~/.cvsq and the subdirectory of
queues for the new queue are generated, if they don't exist
already. Then the directory ~/.cvsq is moved to the
~/.cvsq-deferred-queues/<quoted-contents-of-current-name> and 
the directory ~/.cvsq-deferred-queues/<quoted-queue-name> is moved
is moved to ~/.cvsq; finally the queue name is stored in current.


.SH QUOTING
A simple quoting mechanism is used. All but letters (a-zA-Z) and digits (0-9) are replaced by 
an underscore, followed by the decimal code of that character followed by another underscore. 
This way of quoting is a 1-1 function. Note that, in particular, "_" is quoted as "_95_".


.SH SEE ALSO
.BR cvsq "(1)"

.SH AUTHOR
Klaus Aehlig <aehlig@linta.de>