UI-AUTO-UVC(1)

💖 NAME 💖

ui-auto-uvc — a tool from the ui-auto tool box. 🌈

(and hey bestie, welcome to the UI-AUTO-UVC(1) page from the General Commands Manual — that's literally the whole vibe up top, we move 💅)

---

🦋 DESCRIPTION 🦋

okay so first things first: the real, full documentation lives inside the usage output you get from ui-auto-uvc -H. this page? it's just a copy for convenience, no cap. 🫶

the actual one-liner, and I quote:

Unified version control tool for ui-auto tasks.

now the tea ☕:

• this tool autodetects the versioning control system you're using and unifies a selection of common tasks that ui-auto tools need. but listen — this is not a full featured version control tool. it does its lil' jobs and it does them cute, don't ask it for more. 🙈

---

🌸 VC paths: the syntax 🌸

VC paths all share one common syntax: LOCATION/TAG. and yes, TAG is whatever sits after the last literal /, and it must not contain a / itself. periodt.

that same string gets interpreted differently depending on which VC system you're in:

• LOCAL(meta): LOCALPATH — will just cp -a locally. Example: /home/user/src/myproject/.
• CVS: CVSROOT;MODULE/TAG — TAG is an CVS tag. Empty or TAG=HEAD is the same. ; is separator and must not be used elsewhere. Example: cvs.myhost.org:/my/repo/path/repo;myproject/MYPROJECT_1_2_3.
• SVN: SVNURL/TAG — TAG just adds to the svn path (a svnpath alone is unique). Example: svn://svn.myhost.org/my/repo/path/tags/myproject/MYPROJECT_1_2_3
• GIT: GITURL/TAG — TAG is a git branch. If empty, we stay on repo's default branch. Example: ssh://git.myhost.org/my/git/path/myprojec.git/MYPROJECT_1_2_3

---

✨ Usage ✨

Usage: ui-auto-uvc [-h|-H] -s -S arg -m arg CMD OPT1 OPT2

• -h|-H : Get usage help; short (-h) or complete (-H).

---

🎀 Options 🎀

• -s — Only print the autodetected vc system id. 👀
• -S arg — Set VC System id arbitrarily. Supported: cvs svn git local. [local]
• -m arg — Message for this action. [ui-auto-uvc: No user message.] Note that it depends on the used UVC command and the VC used how and if this is used. (so like, sometimes it's used, sometimes it isn't, don't @ me)

---

💜 Positionals 💜

• CMD — UVC command: check_installation path version update check_sync diff add commit tag branch changelog news checkout push_all.
  • check_installation — Check whether version control tools are installed. ✅
  • path — Print current working directory's VC path. 📍
  • version — Print a VC version string (suitable for snapshots).
  • update — Update working directory w/ server.
  • check_sync — Check that working directory has no uncommitted changes and is up-to-date w/ server (where applicable).
  • diff FILE — Display diff for file.
  • add FILES — Add files to version control.
  • commit FILES — Check-in FILES (-m may be used).
  • tag NAME [DEST] — Tag repository using NAME (use DEST for VCSes that copy for tags).
  • branch NAME [DEST] — Branch repository using NAME (use DEST for VCSes that copy for branches).
  • changelog — Generate ChangeLog from the VCSes logs. 📜
  • news SINCE — Generate NEWS text (first line of VC checkins). 📰
  • checkout VCPATH DIR — Checkout a from VC path to DIR (you need to explicitly set VCS via -S). See above for the syntax of VCPATH.
  • push_all — Try to push any local changes and tags found in any branches (noop for non git). 🚀
• OPT1 — Option 1 for command.
• OPT2 — Option 2 for command.

---

👑 AUTHOR 👑

Produced automatically by ui-auto on Wed, 17 Sep 2025 12:11:56 +0000.

---

ok that's the whole page bestie, you ate that read fr fr 💖✨

and as a lil' sign-off: this was the UI-AUTO-UVC(1) page, served up from the General Commands Manual, auto-generated by ui-auto on Wed, 17 Sep 2025 12:11:56 +0000. go run ui-auto-uvc -H for the full lore, mwah 🎀🦋🌸