MAKEPPCLEAN(1)

✨ NAME ✨

okay so this is makeppclean(1), straight out of the Makepp manual — it's the stand-alone cleanup script for makepp 💅✨

---

🧚 DESCRIPTION 🧚

first of all, here's the lil option map, no cap, exactly how it comes:

?: -?,  A: -A,
  --args-file,
  --arguments-file,  B: -b,
  --build-cache-links,  D: -d,  E: --empty-directories,  H: -h,
  --help,  K: -k,
  --keep-src-info,  L: -l,
  --leave-src-info,
  --log,  M: -m,
  --makepp,
  $MAKEPPCLEANFLAGS,
  --meta,  O: --only-build-cache-links,
  --only-logs,
  --only-meta,
  --only-repository-links,  R: -R,
  -r,
  --recurse,
  --recursive,
  --repository-links,  V: -V,
  -v,
  --verbose,
  --version

and the way you actually run it, both names, both iconic 👑:

makeppclean [ -b ] [ -l ] [ -R ] [ -r ] [ -v ] [ path ... ]

mppc [ -b ] [ -l ] [ -R ] [ -r ] [ -v ] [ path ... ]

so like, makeppclean efficiently removes files that were knowingly generated through makepp. bestie it knows. 🔥

per each path: if path is not a directory and was known to be generated by makepp by virtue of having a build info file with a matching signature, then it removes path and its build info file; and if path is a directory, it does the same for every file in path, and then removes the build info directory below path. and path defaults to . 🫶

---

💀 the traditional approach (aka the old way, not the vibe)

the traditional approach to removing generated files is to create a clean target in your makefiles whose action is to remove all of the targets. and listen, this approach has some fundamental limitations:

• it requires that all the relevant makefiles be loaded before cleaning. this can take quite a while. 😭
• if the clean target in one makefile depends on the clean target in another makefile, then it is possible that a file that must be built in order to load one of the makefiles (e.g. because of a prebuild statement) has already been built and cleaned by the time it needs to be built again. makepp wisely fails in this situation, rather than potentially building the same file many times during the course of a single build. periodt.

provided that your intention is to remove all the generated files without regard for which makefile (if any) currently generates them, then these limitations are avoided by using makeppclean. slay 🌈

---

💅 OPTIONS 💅

• -A filename, --args-file=filename, --arguments-file=filename — read the file and parse it as possibly quoted whitespace- and/or newline-separated options. 🎀
• -b, --build-cache-links, --only-build-cache-links — remove only links or files from a build cache. that's it, that's the whole job ✨
• -d, --empty-directories — remove directories that became empty after removing their content. since directories are not usually created by rules, makepp does not keep track of which one it created. therefore this applies to those, where makepp created something, whether the directory was created manually or automatically. 👑
• -?, -h, --help — print out a brief summary of the options. your lil cheat sheet fr fr 📋
• -k, --keep-src-info, --leave-src-info — leave the build info directory below each named directory. like, don't touch that one, it's staying 🙈
• -l, --log, --only-logs — remove only the raw logfiles, which can be many in case of traditional recursion. and when i say many, bestie… 💀
• -m, --meta, --only-meta, --makepp — remove only the meta information subdirectories. 🦋
• -R, --repository-links, --only-repository-links — remove only links pointing to a repository. 🔗
• -r, --recurse, --recursive — descend each named directory recursively. symbolic links are not followed. 🚫 note that, it matters
• -v, --verbose — enable verbose output to STDERR. it's giving chatty 💬
• -V, --version — print out the version number. 🏷️

---

🌸 ENVIRONMENT 🌸

makeppclean looks at the following environment variable, just the one, she's lowkey picky:

• $MAKEPPCLEANFLAGS — any flags in this environment variable are interpreted as command line options before any explicit options. quotes are interpreted like in makefiles. 🎀

---

🫶 AUTHOR 🫶

Anders Johnson <anders@ieee.org> — thank you for your service, icon 👑

---

and that's the whole page, bestie!! this was perl v5.32.0, dated 2021-01-06, coming to you from the Makepp manual — MAKEPPCLEAN(1), and yes she ate 💖✨🎀🦋