HG(ADD)

💖 hg add — the "okay bestie, let's get you tracked" command 💖

HG(ADD) is the page, hg add is the vibe. It lives in the Mercurial manual set, and it's literally the cutest little onboarding ritual: you've got files, the repo doesn't know about them yet, and you're about to fix that.

✨ SYNOPSIS ✨

hg add [OPTION]... [FILE]...

🦋 DESCRIPTION 🦋

Schedule files to be version controlled and added to the repository.

That's it, that's the whole job. The files will be added to the repository at the next commit — so nothing is actually in there yet, it's more like a pinky promise to the repo. And if you change your mind before that commit happens? No worries babe, see hg forget. Undo era. 💅

If no names are given, add all files to the repository (except files matching .hgignore). Every single one. It's giving "yes to everything" energy and honestly, sometimes that's the move.

🌸 Examples 🌸

• New (unknown) files are added automatically by hg add:

$ ls
foo.c
$ hg status
? foo.c
$ hg add
adding foo.c
$ hg status
A foo.c

Not the ? turning into an A 😭 that's the character development arc fr fr.

• Specific files to be added can be specified:

$ ls
bar.c  foo.c
$ hg status
? bar.c
? foo.c
$ hg add bar.c
$ hg status
A bar.c
? foo.c

Returns 0 if all files are successfully added. Zero means slay. Zero means we ate. 👑

🎀 OPTIONS 🎀

• -I, --include <PATTERN[+]> — include names matching the given patterns. Only the chosen ones get in, gatekeeping but make it fashion.
• -X, --exclude <PATTERN[+]> — exclude names matching the given patterns. Not you, not you, absolutely not you.
• -S, --subrepos — recurse into subrepositories. Yes bestie, we're going deeper. 🌀
• -n, --dry-run — do not perform actions, just print output. A little dress rehearsal, no commitment, zero consequences. Iconic behaviour honestly.

[+] marked option can be specified multiple times — so if you need -I four times, that's valid, that's allowed, live your truth. ✨

Anyway, this whole page comes from the hg manual set — the footer's just HG(ADD), no extra version drama or date attached, so that's all the metadata we've got, bestie. Go add those files, you main character. 🫶🌸💜