HG(SHELVE)

💖 hg shelve — the Mercurial manual, but make it bestie 💖

okay so this is the page for hg shelve from the Mercurial manual (the manual name is literally HG(SHELVE), she's giving very "my name is on both the top and the bottom of the page" main character energy and honestly? slay).

✨ NAME ✨

hg shelve — save and set aside changes from the working directory 🎀

🦋 SYNOPSIS 🦋

hg shelve [OPTION]... [FILE]...

🌸 DESCRIPTION 🌸

so basically, shelving is the move where you take files that hg status is like "bestie these are NOT clean" about, save all those modifications into a bundle (that's your shelved change 💅), and then revert the files so their state in the working directory becomes clean again. it's giving "clean up your room by shoving everything in the closet", but make it version control.

to restore those changes back into the working directory, you use hg unshelve. and here's the iconic part: this will work even if you switch to a different commit. the way that works is genuinely so powerful, no cap.

when you don't specify any files, hg shelve saves all the not-clean files. if you name specific files or directories, only the changes to those files get shelved. simple as that, periodt.

in bare shelve — which means no files specified, and no interactive, include or exclude option — shelving remembers info if the working directory was on a newly created branch. in other words, the working directory was on a different branch than its first parent. in that situation, unshelving restores the branch information to the working directory. 🌈 iykyk.

every shelved change has a name, so it's easier to find later. the name defaults to being based on the active bookmark — or, if there's no active bookmark, the current named branch. wanna pick your own? use --name. 💖

to see a list of existing shelved changes, use the --list option. for each shelved change it prints its name, age, and description. want more tea? use --patch or --stat for more details. 👑

to delete specific shelved changes, use --delete. to delete all shelved changes, use --cleanup. (careful, bestie, that one is a full send 💀)

💅 OPTIONS 💅

• -A, --addremove — mark new/missing files as added/removed before shelving ✨
• -u, --unknown — store unknown files in the shelve 🙈
• --cleanup — delete all shelved changes 💀 (yes ALL of them, she does not play)
• --date <DATE> — shelve with the specified commit date 🗓️
• -d, --delete — delete the named shelved change(s) 🗑️
• -e, --edit — invoke editor on commit messages ✍️
• -k, --keep — shelve, but keep changes in the working directory 🫶 (the "have your cake and eat it too" option, obsessed)
• -l, --list — list current shelves 📋
• -m, --message <TEXT> — use text as shelve message 💬
• -n, --name <NAME> — use the given name for the shelved commit 🏷️
• -p, --patch — output patches for changes (provide the names of the shelved changes as positional arguments) 🩹
• -i, --interactive — interactive mode 🎮
• --stat — output diffstat-style summary of changes (provide the names of the shelved changes as positional arguments) 📊
• -I, --include <PATTERN[+]> — include names matching the given patterns ✅
• -X, --exclude <PATTERN[+]> — exclude names matching the given patterns ❌

[+] marked option can be specified multiple times 🔁

and that's the whole page, bestie!! 🫶 every last flag accounted for, nothing skipped, we ate and left no crumbs. this one is signed off by none other than HG(SHELVE) — yes, the same name that opened the page, she's closing it too because she's consistent like that 👑 — dated HG(SHELVE). iconic from start to finish. bye!! 💜🌸✨