CVSQ-SWITCH(1)

✨ NAME ✨

okay so bestie, welcome to CVSQ-SWITCH(1), the manual page for cvsq-switch — and its whole gig is literally switch between different ques for cvs. (Yes, “ques” is the original spelling and we’re keeping it, no cap. 💅) It’s giving “queue era” and honestly? iconic. 🦋

🎀 SYNOPSIS 🎀

cvsq-switch [queuename]

That’s the whole call: cvsq-switch plus an optional queuename, periodt. ✨

💖 DESCRIPTION 💖

So picture this: 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 queue was not named by a call to cvsq-switch, its name is assumed to be "default". 💖

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

🚨 invariant alert: 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 ~/.cvsq-deferred-queues/<quoted-contents-of-current-name> and the directory ~/.cvsq-deferred-queues/<quoted-queue-name> gets moved (the manpage literally says “is moved is moved” — we love a typo moment 💀) to ~/.cvsq; finally the queue name is stored in current. 🫶

🔤 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_". 🔥

👀 SEE ALSO 👀

• cvsq(1) — the related manual page, go read it bestie. 💖

👑 AUTHOR 👑

the legend behind this page: Klaus Aehlig <aehlig@linta.de> 💌

---

mwah 💋 — page date: May 7, 2007; manual/version tag: CVSQ-SWITCH(1). bye bestie, go switch those ques! 🫶