HG(PHASE)

💅 HG(PHASE) 💅

okay bestie, welcome to hg phase — the manual page for the hg phase command, and yes it's giving main character energy because phases are literally the whole personality of your repo. let's get into it 🫶

✨ NAME ✨

hg phase — set or show the current phase name. that's it. that's the job. 💖

🎀 SYNOPSIS 🎀

hg phase [-p|-d|-s] [-f] [-r] [REV...]

look at her. so compact. so powerful. 👑

🌸 DESCRIPTION 🌸

so like, when you run it with no argument at all, it just shows you the phase name of the current revision(s). no changes, just vibes. a little peek. 🙈

when you give it one of -p/--public, -d/--draft or -s/--secret, that's when it actually changes the phase value of the revisions you specified. slay. 💅

BUT — and this is the important part, no cap — unless -f/--force is specified, hg phase won't move changesets from a lower phase to a higher phase. it's protective like that. 🛡️ the phases are ordered like this:

public < draft < secret

so public is the chillest, secret is the most locked-down, and the hierarchy goes left to right, lowkey to highkey. 🔥

it returns 0 on success, and 1 if some phases could not be changed. simple as. 🍓

(for more information about the phases concept, see hg help phases.) — yes, there's a whole other page for the lore, go read it, iykyk 📖✨

💜 OPTIONS 💜

• -p, --public — set changeset phase to public. the most out-in-the-open phase, everybody can see her 🌈
• -d, --draft — set changeset phase to draft. the middle child, in progress, still cooking 🧚
• -s, --secret — set changeset phase to secret. locked in the vault, nobody's supposed to see this one 💀
• -f, --force — allow to move boundary backward. this is the "i said what i said" flag, it lets you push past the normal guardrails 😤
• -r, --rev <REV[+]> — target revision. pick which revision(s) you're talking to 🎯
  • [+] marked option can be specified multiple times — so yes bestie, you can stack it, go off 💖

⭐ a lil sign-off ⭐

this was the hg phase page from the HG(PHASE) manual — footer says HG(PHASE) too, so it's bookended, iconic, symmetrical, we love to see it. now go forth and phase responsibly, mwah 🎀✨💜