THG(1)

💖 THG(1) — the thg user manual, but make it cute 💖

okay bestie, sit down, grab a boba, because we're about to talk about thg — the manual page for TortoiseHg's GUI tools for Mercurial SCM (Hg). yes this is a real thing, yes it's giving very "your cool older cousin who does version control for fun" energy, and yes I'm gonna walk you through every single flag. no skips. no skimming. periodt. 💅

---

✨ SYNOPSIS ✨

thg [global options] command [command options]

that's it. that's the whole vibe. global stuff first, then a command, then that command's own little options. slay. 🦋

---

🌸 DESCRIPTION 🌸

so this manual page documents thg briefly, okay? brief. it's a lil summary situation.

here's the tea though: this manual page was written for the Debian distribution because the original program literally does not have a manual page. not one. so Debian said "fine, I'll do it myself" and here we are. iconic behavior honestly. 👑

and what is thg? it's a program that invokes TortoiseHg's GUI tools for Mercurial SCM — aka hg(1). so if you're out here living that Mercurial life but you want buttons and windows and pretty dialogs instead of typing everything, thg is your girl. 💖

---

💅 OPTIONS 💅

the program follows the usual GNU command line syntax, with long options starting with two dashes (`-`). here's the whole summary, no gatekeeping, we don't do that here:

🌈 Global Options 🌈

• -R, --repository — set the repository root directory or symbolic path name. basically "hey, look over here." 📍
• -v, --verbose — enable additional output. more words, more info, more everything. 🗣️
• -q, --quiet — suppress output. shhh. 🤫
• -h, --help — display help and exit. the classic. the icon. the one everyone runs first. ✨
• --debugger — start debugger. 🐛
• --profile — print command execution profile.
• --nofork — do not fork GUI process.
• --fork — always fork GUI process. (yes, it's the opposite of the one above. they're both here. balanced, as all things should be.) ⚖️
• --listfile — read file list from file.
• --listfileutf8 — read file list from file encoding utf-8. 🌍

🎀 Commands 🎀

here's a brief list of the supported commands, bestie. and if you want the detailed documentation on one specific command, just run this:

thg help command

like that. literally that. it's giving self-serve, and we love a program that explains itself. 🫶

• about — about dialog.
• add — add files.
• annotate, blame — annotate dialog.
• archive — archive dialog.
• backout — backout tool.
• bisect — bisect dialog.
• clone — clone tool.
• commit, ci — commit tool.
• drag_copy — copy the selected files to the desired directory.
• drag_move — move the selected files to the desired directory.
• email — send changesets by email.
• forget — forget selected files.
• grep, search — grep/search dialog.
• guess — guess previous renames or copies.
• help — show help for a command, extension, or list of commands.
• hgignore, ignore, filter — ignore filter editor.
• import — import an ordered set of patches.
• init — init dialog.
• log, history, explorer, workbench — workbench application.
• manifest — display the current or given revision of the project manifest.
• merge — merge wizard.
• mq — Mercurial Queue tool.
• purge — purge unknown and/or ignore files from repository.
• qqueue — manage multiple MQ patch queues.
• qreorder — reorder unapplied MQ patches.
• rebase — rebase dialog.
• rejects — manually resolve rejected patch chunks.
• remove, rm — remove selected files.
• rename, mv, copy — rename dialog.
• repoconfig — repository configuration editor.
• resolve — resolve dialog.
• revert — revert selected files.
• serve — start stand-alone webserver.
• shelve, unshelve — move changes between working directory and patches.
• status — browse working copy status.
• strip — strip dialog.
• sync, synchronize — synchronize with other repositories.
• tag — tag tool.
• test — test arbitrary widgets.
• update, checkout, co — update/checkout tool.
• userconfig — user configuration editor.
• vdiff — launch configured visual diff tool.
• version — output version and copyright information.

look at that list. forty-something commands. we did NOT skip a single one. not one. 💯

---

😭 BUGS 😭

found a bug? first of all, relatable. second of all, the upstream's BTS lives right here:

https://bitbucket.org/tortoisehg/thg/issues

go tell them, they wanna know. 🐞

---

🦋 SEE ALSO 🦋

• hg(1) — the main character, honestly. the one this whole thing orbits around. ⭐

---

👑 AUTHOR 👑

Ludovico Cavedon <cavedon@debian.org>

• wrote this manpage for the Debian system. thank you for your service, king. 🫡

---

📜 COPYRIGHT 📜

Copyright © 2009-2011 Ludovico Cavedon <cavedon@debian.org>>

this manual page was written for the Debian system (and may be used by others).

permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation.

on Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-2.

---

and that's the whole page, bestie!! 🎀 this one's thg 0.8, dated 03/18/2011 — so yeah, she's an elder but she still ate. go forth and GUI your Mercurial, you absolute icon. mwah. 💖✨🦋