ASUBST(1)

✨ ASUBST(1) — the EN Tools girlies know 💅

okay so bestie, welcome to asubst, aka Area Substitution 🌸 she lives in the EN Tools family and she is so underrated, fr fr.

---

🎀 SYNOPSIS 🎀

asubst [-o outputfile] [-v] [inputfile]

like. that's it. that's the whole summoning ritual 🫶

---

💖 DESCRIPTION 💖

So here's the vibe: asubst reads from inputfile, or from "stdin" if you didn't hand her one, and then she does the thing — she substitutes characters and substrings based on Perl-like substitution commands that are wrapped up inside surrounding area delimiters 🦋

The substitution commands she recognizes are, and I need you to write these down exactly bestie, no cap:

[[s/pattern/string/options]]
[[tr/input/output/options]]

and the areas themselves are defined by blocks delimited with this lil cutie:

{: ... :}

so like, the block is the area, and inside the area you put your substitution commands, and she goes to work. periodt. 👑

---

🌈 EXAMPLE 🌈

here's her serving, look:

{: [[s/X/ä/]] [[s/X/ü/]]
Foo Bar Baz Quux with Umlauts X and X
:}

not me getting emotional over umlaut substitution 😭 iconic behaviour honestly.

---

✨ OPTIONS ✨

• -o outputfile — this redirects the output to outputfile. Usually the output gets sent to "stdout" if you don't pass this option at all, or if outputfile is "-". yes really, a literal dash means "yeah just stdout it", she's flexible like that 💅
• -v — this sets verbose mode, where some processing information will be given on the console. she will talk to you. she will tell you things. some might say she overshares but honestly? we love a transparent queen 🗣️💖

---

👑 AUTHOR 👑

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

the literal main character who made all this happen 🫶

---

and that's the whole page bestie, no notes 💜 this was EN Tools, dated 2020-11-29 — go substitute something, you've got this 🌟🍓