TRAWLDB(1)

💖 TRAWLDB(1) — the trawldb girlies' guide 💖

okay bestie, sit down, we're learning trawldb, a User Command, and honestly? it's giving main character energy for your config files. let's go 🫶

---

✨ NAME ✨

trawldb — the CLI for managing trawl configuration resources. yes that's the whole name, short and iconic, no notes 💅

---

🌸 SYNOPSIS 🌸

trawldb [OPTIONS] [--] [FILENAME]

look at her. options first, then optionally a -- if you're being fancy, then optionally a FILENAME. that's it, that's the whole vibe check ✨

---

🦋 DESCRIPTION 🦋

so trawldb is a client CLI utility — meaning it's the little command-line bestie you talk to — and what it does is let you manage the configuration resources that are stored by Trawl. 🎀

and what's Trawl, you ask? Trawl is a resource management tool that's positioned as an xrdb alternative, except — and this is the slay part — it's session independent. so it literally works on both X11 and Wayland. no cap. no "oh sorry babe this only works on one display server" nonsense. both. periodt. 👑

---

🎀 OPTIONS 🎀

here's the full menu, bestie. every single one, no skipping, because i love you and you deserve the whole thing 💖

• -b, --backup <string> — the backup suffix used by -edit (default is .bak). so when you edit stuff, it keeps a lil backup copy with this ending. safety first, queen 🫶
• -c, --cpp <CPP> — which preprocessor to use (default is /usr/bin/cpp). yes, the classic. 🧚
• -D, --define <DEFINE> — takes a <DEFINE>. (the manpage gives us no further gossip on this one, so we hold hands and move on 🙈)
• -e, --edit <filename> — edit resources into a file. your moment to change things up ✨
• -g, --get <name> — get the content of a resource. just peek at it, no touching 💅
• -h, --help — print help information. the classic "help me i'm baby" flag 🥺
• -I, --include <INCLUDE> — takes an <INCLUDE>. (again, no extra description in the original, so no invented lore, i refuse to make things up 🫶)
• -l, --load <filename> — load resources from a file. bring them in, bestie 🌈
• -m, --merge <filename> — merge resources from a file & sort. merge AND sort, she does both, multitasking icon ⭐
• --nocpp — do NOT use a preprocessor. the raw-dogging of config processing, if you will 💀
• -q, --query [<string>...] — query resources. the <string> part is optional and you can pass more than one, hence the ... ✨
• --remove — remove resources. gone. deleted. not me being the villain era 😭
• -V, --version — print version information. always good to know which era of her you're dealing with 👑

---

💜 AUTHORS 💜

these two legends built her:

• Soumya Ranjan Patnaik <soumyaranjan1812@gmail.com>
• Ken Gilmer <kgilmer@gmail.com>

give them their flowers, fr fr 🌸

---

and that's the whole page bestie!! this was trawldb version, dated 2022 — iykyk. go forth and manage those resources, you absolute icon 🦋💖 periodt.