MAKESH(1)

📦 version 3.5-236, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 MAKESH(1) — like, the manual page but make it cute 💖

okay bestie, so this is makeSH, which lives in the General Commands Manual section 1 (you know, the "commands you type at a shell" section, iykyk). Buckle up, it's giving build-tool fairy godmother 🧚✨

✨ NAME ✨

makeSH — a .SH script maker 🎀

🌸 SYNOPSIS 🌸

makeSH files

🦋 DESCRIPTION 🦋

So here's the tea: makeSH looks at one or more scripts and spits out a .SH file that, when you run it under sh, will literally recreate the original script. Like a photocopier but for scripts. Iconic behavior honestly 👑

The .SH script it produces has two sections, and both of them contain code that's destined for the output. Here's the difference, and it matters:

  • The first section gets variable substitutions done on it — taking values from config.sh 💅
  • The second section does not. No substitutions, no notes. Just vibes.

Now, makeSH has no idea which variables you actually want substituted (it's not a mind reader, bestie 😭), so it just throws the whole script into the second section. Every last line. It's up to you to go in there and insert any variable substitutions you want in the first section, for any values you want pulled from config.sh. That's your job, not its job. The way that division of labor is so real.

🫶 Pro tip from the page itself: you should run makeSH from within your top-level directory, and use the relative path to the file as an argument. Why? So that the "Extracting ..." line printed while running the produced .SH file later on will give that same path. Consistency is the moment. Periodt.

👑 AUTHOR 👑

Larry Wall <lwall@netlabs.com> — yes, that Larry Wall, the legend himself 🌈⭐

🔥 SEE ALSO 🔥

Go read those too, they're all part of the same little ecosystem and honestly the lore runs deep 🧚💜

💀 BUGS 💀

Okay so, not me exposing the author but here's what the page literally says: it could assume that variables from metaconfig's Glossary need to be initialized in the first section... but the author says they're too lazy to make it do that 🙈

So like. That's the whole bug report. We respect the honesty. No cap. 🍓

and that's the whole page, bestie — written by Larry Wall, part of the LOCAL collection, and yeah, no version number or date on this one, she's timeless 💖✨🌸🦋🎀💅🫶

📦 where this page comes from