HG(HEADS)

✨ HG(HEADS) — aka the hg heads glow-up ✨

okay bestie, sit down, grab a boba 🧋 because we're learning about hg heads, and honestly? it's giving "where is everybody actually working" energy and you're gonna be obsessed.

---

🌸 NAME 🌸

hg heads — show branch heads 👑 (yes that's the whole name, she's simple, she's iconic)

---

🦋 SYNOPSIS 🦋

hg heads [-ct] [-r STARTREV] [REV]...

literally that's it. that's the whole vibe. 💅

---

💖 DESCRIPTION 💖

so when you run this with no arguments at all? she shows you every single open branch head in the repository. periodt.

and what even is a branch head, you ask? okay so — branch heads are changesets that have no descendants on the same branch. no children, nobody coming after them, they're the end of the line on their little branch. 🌈

and the way that matters is: these are where development generally takes place, and they're the usual targets for update and merge operations. so like, they're the main characters. the places stuff actually happens. 👑

---

if you give her one or more REVs? then she only shows you the open branch heads on the branches associated with those specified changesets. which means — and this is the cute part — you can run:

hg heads .

to see the heads on the currently checked-out branch. so handy. so slay. 🫶

---

if you pass -c / --closed, she'll also show branch heads that are marked closed (peep hg commit --close-branch for how that marking happens) 💀

if you pass STARTREV, then only the heads that are descendants of STARTREV get displayed. filter it, bestie. ✨

and if you pass -t / --topo, the named branch mechanics get completely ignored — she'll only show you topological heads, which are changesets with no children. pure structure, no branch drama. 🧚

---

lowkey important: this returns 0 if matching heads are found, and 1 if not. exit codes are the vibe check. don't ignore them. 😭

---

🎀 OPTIONS 🎀

• -r, --rev <STARTREV> — show only heads which are descendants of STARTREV 🔍
• -t, --topo — show topological heads only 🦋
• -a, --active — show active branchheads only (DEPRECATED) ⚠️
• -c, --closed — show normal and closed branch heads 👑
• --style <STYLE> — display using template map file (DEPRECATED) ⚠️
• -T, --template <TEMPLATE> — display with template ✨

not one but two deprecated flags in here bestie, -a/--active and --style. they're still listed, they still exist, but the manual is literally telling you they're deprecated. read the room. 🙈

---

and that's the whole page!! no cap, every single line accounted for. 💜

sign-off time 🎀 — this little love letter lives under the heading HG(HEADS) in the manual, and the footer at the very bottom is just... HG(HEADS) again, no version number, no date, nothing. she said "mysterious." we respect it. 🌟

anyway go check your heads, bestie, your branches are waiting for you. bye!! 💅🌸✨