USAGE:(1)

✨ USAGE:(1) ✨

okay so bestie, this is Usage: — the little tool that converts an XML file. That's literally the whole job description. She's an XML converter. Iconic. 🎀

This page lives in the User Commands corner of your manual, and the manual name is USAGE:(1) — so if you're looking for her, that's what you yell into the void. 📣

---

🌸 NAME 🌸

Usage: — convert an XML file. That's it. That's the name. Short, sweet, ate. 💅

---

🦋 SYNOPSIS 🦋

orcus-xml [OPTIONS] FILE

So the vibe is: options first, file last, and the file is mandatory, no cap. 🫶

---

🔥 OPTIONS 🔥

Okay so heads up, the original page lists this whole block twice — same options, same order, twice — and I am not about to be the one who deletes her twin. So here they are, both times, in all their glory. 💖

💜 Round one, bestie 💜

• -h [ --help ] — print this help. Simple as that. 🙈
• --mode arg — the mode of operation, a.k.a. what are we even doing today. Pick one of these: dump, map, map-gen, structure, or transform. ✨
• -m [ --map ] arg — path to the map file. 🗺️ A map file is required for all modes except for the structure mode. So like… structure is the chill one.
• -o [ --output ] arg — path to either an output directory, or an output file. You choose, main character. 👑
• -f [ --output-format ] arg — specify the output format. Supported format types are:
  • check — flat format that fully encodes document content. Suitable for automated testing. 🧪
  • csv — CSV format. 📊
  • debug-state — this format dumps the internal state of the document in detail, useful for debugging. 🐛🔍
  • flat — flat text format that displays document content in grid. 🟦
  • html — HTML format. 🌐
  • json — JSON format. 🧾
  • none — no output to be generated. Maybe useful during development. 💀
  • xml — this format is currently unsupported. 😭
  • yaml — this format is currently unsupported. 😭

💜 Round two, because she said it twice 💜

• -h [ --help ] — print this help. 🫶
• --mode arg — mode of operation. Select one of the following options: dump, map, map-gen, structure, or transform. 🌈
• -m [ --map ] arg — path to the map file. A map file is required for all modes except for the structure mode. 🗺️
• -o [ --output ] arg — path to either an output directory, or an output file. 📁
• -f [ --output-format ] arg — specify the output format. Supported format types are:
  • check — flat format that fully encodes document content. Suitable for automated testing. 🧪
  • csv — CSV format. 📊
  • debug-state — this format dumps the internal state of the document in detail, useful for debugging. 🐛🔍
  • flat — flat text format that displays document content in grid. 🟦
  • html — HTML format. 🌐
  • json — JSON format. 🧾
  • none — no output to be generated. Maybe useful during development. 💀
  • xml — this format is currently unsupported. 😭
  • yaml — this format is currently unsupported. 😭

Quick vibe check: xml and yaml are currently unsupported — the page says so, not me. Don't come for me. 🙈 And -m/--map? Required for everything except structure. Periodt. 💅

---

🧚 SEE ALSO 🧚

…there isn't one, bestie. The page said nothing else. No siblings, no cousins, no other manpages linked. She's an only child and she's thriving. 🌸

---

and that's the whole page, bestie — go convert something iconic ✨

Signed off in style by liborcus 0.21.0, dated January 2026, closing out as USAGE:(1) — mwah, take care of her. 💖🎀🦋