SHTOOLIZE.TMP(1)

💖 SHTOOLIZE.TMP(1) 💖

okay bestie, pull up a chair, we're reading the shtoolize page from the GNU Portable Shell Tool manual and it is lowkey iconic. no cap.

---

✨ NAME ✨

shtoolize — build individual GNU shtool scripts. that's it. that's the whole job. she builds scripts. 💅

---

🌸 VERSION 🌸

GNU shtool 2.0.8 (18-Jul-2008) — yes she's a vintage queen and she still slays 🎀

---

🦋 SYNOPSIS 🦋

shtoolize [-h] [-v] [-q] [-o script] module [ module ... ]

like. she takes some flags, and then she takes modules, and she will keep taking modules until you stop typing them. greedy in the best way fr fr.

---

💜 DESCRIPTION 💜

so here's the tea: the shtoolize program builds individual GNU shtool scripts — written to the default output file shtool, or to whatever script you specified — out of one or more shtool ingredient modules. think of it like a build-your-own-bestie situation. you pick the modules, she assembles the script. ✨

the available modules are:

• echo — Print string with optional construct expansion
• mdate — Pretty-print modification time of a file or dir
• table — Pretty print a field-separated list as a table
• prop — Display progress with a running propeller
• move — Move files with simultan substitution
• install — Install a program, script or datafile
• mkdir — Make one or more directories
• mkln — Make link with calculation of relative paths
• mkshadow — Make a shadow tree
• fixperm — Fix file permissions inside a source tree
• rotate — Rotate a logfile
• tarball — Roll distribution tarballs
• subst — Apply sed(1) substitution operations
• platform — Platform identification utility
• arx — Extended archive command
• slo — Separate linker options by library class
• scpp — Sharing C Pre-Processor
• version — Generate and maintain a version information file
• path — Deal with program paths

and THEN, bestie, there's a little bonus situation: a pseudo-module "all" which is basically a short-hand for:

"echo mdate table prop move install mkdir mkln mkshadow fixperm platform arx slo scpp version path"

which is to say, it builds a shtool script with all the modules in the standard order. an installed shtool is usually built this way via "shtoolize -o shtool all". one word, whole script, main character energy 👑

now, why would you even do this instead of just grabbing everything? because sometimes you want a smaller sized script and you genuinely don't need all of the available shtool functionality. the way that a classical Autoconf based free software package only needs, like, a tiny lil shtool script built via "shtoolize -o shtool install mkdir" — and honestly? that might be sufficient. minimalism is a vibe. 🌿

---

🎀 OPTIONS 🎀

the following command line options exist, and yes we're going through all of them:

• -h — Displays a short help page describing the usage of shtoolize. (she's helping! she's telling you how to use her!)
• -v — Displays the version number of shtoolize/shtool. (identity check 💅)
• -q — Displays no processing information. (quiet. mysterious. silent but slaying.)
• -o script — Writes the output to file script instead to file "shtool". (custom filename, custom destiny ✨)

---

🌈 EXAMPLE 🌈

the typical free software package which is based on GNU libtool and GNU shtool uses a "Makefile" entry like the following:

#   Makefile entry for upgrading GNU tools
upgrade-tools:
    libtoolize -f -c
    shtoolize -q all

this upgrades the three files "ltmain.sh", "ltconfig" and "shtool" in the current source tree to the latest versions. three files, one make target, absolutely ate 🔥

---

🫶 SEE ALSO 🫶

• shtool(1).

---

💖 AUTHOR 💖

• Ralf S. Engelschall
• rse@engelschall.com
• www.engelschall.com

---

💀 friendly reminder that all the facts above are hers, not mine — I just put them in a cuter outfit. everything literal stays literal. periodt.

---

okay that's the whole page, bestie, and lemme just say — this is shtool 2.0.8, dated 18-Jul-2008, and the manual page is literally called SHTOOLIZE.TMP(1). vintage, but she still understood the assignment. mwah 💋🦋🌸