HG(PURGE)

✨ hg purge ✨

okay bestie, welcome to the hg purge page from the Mercurial manual 💖 this one's a little chaotic but we're gonna get through it together, i promise 🫶

🌸 NAME 🌸

hg purge — removes files not tracked by Mercurial 💅

🎀 SYNOPSIS 🎀

hg purge [OPTION]... [DIR]...

🦋 DESCRIPTION 🦋

so basically: it deletes files that Mercurial doesn't know about. no cap. it's giving "test local and uncommitted changes in an otherwise-clean source tree" energy ✨

which means, by default, purge is gonna delete these:

• Unknown files — the ones marked with "?" by hg status 👀
• Empty directories — like, Mercurial literally ignores directories unless they contain files under source control management 🗂️

but bestie, it will leave these untouched:

• Modified and unmodified tracked files — safe, protected, main character energy 👑
• Ignored files — unless -i or --all is specified 🙈
• New files added to the repository (with hg add) 🫶

the --files and --dirs options let you direct purge to delete only files, only directories, or both. if you don't give either option, both get deleted 💀

if directories are given on the command line, only files in these directories are considered 📁

⚠️ be careful with purge, fr fr. you could irreversibly delete some files you forgot to add to the repository 😭 if you only want to print the list of files that this program would delete, use the --print option. do that first. seriously. 💜

💅 OPTIONS 💅

• -a, --abort-on-err — abort if an error occurs 🛑
• --all — purge ignored files too 👀
• -i, --ignored — purge only ignored files 🙈
• --dirs — purge empty directories 🗂️
• --files — purge files 📄
• -p, --print — print filenames instead of deleting them 🖨️ (the safe bestie option)
• -0, --print0 — end filenames with NUL, for use with xargs (implies -p/--print) ✨
• --confirm — ask before permanently deleting files 🙋‍♀️
• -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 🔁

⭐ ALIASES ⭐

clean 🧼

and that's the whole page, bestie!! go forth and purge responsibly, or like… don't, and use --print instead, iykyk 💖✨🎀🦋🌸💅🫶

this has been HG(PURGE) from the Mercurial manual — thanks for reading, love u, bye 💜