UNRECOGNISED(1)

💅 UNRECOGNISED(1) — User Commands 💅

okay bestie, you're looking at UNRECOGNISED(1), filed under User Commands, and it's a whole manual page about one lil utility. grab a boba, sit down, we're doing this properly. 🧋✨

---

🌸 NAME 🌸

unrecognised — it converts a OpenXML spreadsheet. that's the job. that's the whole job. it does not do your taxes, it does not text your ex back, it converts a OpenXML spreadsheet. 👑

---

✨ SYNOPSIS ✨

orcus-xlsx [options] FILE

so the thing you actually type at your prompt is orcus-xlsx, even though the page itself is called UNRECOGNISED(1). mystery. intrigue. we don't ask, we just run it. 🕵️

---

🎀 DESCRIPTION 🎀

FILE must be a path to an existing file. like, a real one. sitting on your actual disk. not a file you intended to make, not a file that exists in your heart. existing. periodt. 💀

---

🦋 OPTIONS 🦋

• -h, --help — print this help. the people's champion, the one option everyone meets first. 🫶
• -d, --debug — turns on debug mode, and you can optionally hand it a debug level too, so you get run-time debug outputs. lowkey the most useful thing here when stuff goes sideways.
• -r, --recalc — re-calculate all formula cells after the document is loaded. all of them. every single one. (the original page says "documetn" here and honestly? iconic typo energy. moving on. 💖)
• -e, --error-policy arg (default: fail) — decides what happens when the loader fails to parse the first formula cell. pick fail and it aborts immediately. pick skip and it skips the offending cells and keeps going. choose wisely, bestie. 😭
• --dump-check — dumps the content to stdout in a special format used for content verification in automated tests. iykyk.
• -o, --output arg — the output directory path. or, when you're using --dump-check, it's the output file instead. context matters, babes. 🌸
• -f, --output-format arg — picks the output format. the supported format types are:
  • check — flat format that fully encodes document content. suitable for automated testing.
  • csv — CSV format.
  • debug-state — 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.
• --row-size arg — specify the number of maximum rows in each sheet. 🧚

---

okay so not me noticing this page lists the entire option block twice, back to back, word for word. i didn't write that. that's just what's in here. and because my one sacred rule is that i skip nothing, here it is again, bestie. same energy, same facts. 💅

• -h, --help — print this help.
• -d, --debug — turns on debug mode, and you can optionally specify a debug level so you get run-time debug outputs.
• -r, --recalc — re-calculate all formula cells after the document is loaded.
• -e, --error-policy arg (default: fail) — whether to abort immediately when the loader fails to parse the first formula cell (fail), or skip the offending cells and continue (skip).
• --dump-check — dumps the content to stdout in a special format used for content verification in automated tests.
• -o, --output arg — output directory path, or output file when --dump-check is used.
• -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 — 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.
• --row-size arg — specify the number of maximum rows in each sheet. ⭐

---

and that's the whole page, no crumbs left. 💖

this absolute banger of a manpage comes to you from liborcus 0.21.0, dated January 2026, and it answers to the name UNRECOGNISED(1). now go convert a OpenXML spreadsheet, you main character. 🎀🦋👑