UNRECOGNISED(1)

💖 UNRECOGNISED(1) 💖 — User Commands, but make it cute

okay bestie, welcome to UNRECOGNISED(1), aka the part of the manual where we all pretend the name makes sense 🫶 it's a User Commands page, it's giving vintage, it's giving ✨liborcus✨, and we're gonna walk through it together. no skimming, no skipping, we're doing the whole thing. periodt.

---

🌸 NAME 🌸

unrecognised — convert a Gnumeric file

like. that's it. that's the whole job. one (1) job. she converts Gnumeric files and she does it flawlessly 💅

---

🦋 SYNOPSIS 🦋

orcus-gnumeric [options] FILE

okay so yes, the page is called unrecognised and the binary is orcus-gnumeric. not me noticing that. not us. we're not gonna talk about it 🙈 the vibe check passes anyway. you give it some options, you give it a FILE, it goes brrr.

---

🎀 DESCRIPTION 🎀

The FILE must specify a path to an existing file.

that's the whole description. highkey iconic of her to be this concise. existing file only — she is not manifesting a file for you, bestie. if it's not on disk, it's not happening 😭

---

✨ OPTIONS ✨

here's the tea, and I need you seated for this: the original page lists these options twice. same options, same order, twice. so we're doing them twice too, because the one rule is that we keep everything. consider it a remix 🔥

💜 Round One 💜

• -h, --help — Print this help. the classic. she will tell you about herself if you just ask 🥺
• -d, --debug — Turn on a debug mode and optionally specify a debug level in order to generate run-time debug outputs. so you can go full detective mode and get the runtime receipts 🔍
• -r, --recalc — Re-calculate all formula cells after the documetn is loaded. (yes, "documetn". we keep the typo, it's part of the lore 🫶) every formula cell gets a glow-up after loading ✨
• -e, --error-policy arg (=fail) — Specify whether to abort immediately when the loader fails to parse the first formula cell (fail), or skip the offending cells and continue (skip). default is fail, so by default she is dramatic and immediate about it. choose skip if you'd rather she just. move on. no cap.
• --dump-check — Dump the content to stdout in a special format used for content verification in automated tests. this is for the automated-test girlies, she's showing you her whole soul on stdout 💀
• -o, --output arg — Output directory path, or output file when --dump-check option is used. so it's a directory... unless --dump-check is in the chat, in which case it's a file. context matters, iykyk 🌈
• -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.

heads up bestie: xml and yaml are currently unsupported. do not manifest them. she said no 🚫

• --row-size arg — Specify the number of maximum rows in each sheet. maximum rows per sheet, she's setting a limit and she means it 👑

---

💫 OPTIONS (again, but make it a sequel) 💫

not the page repeating itself, but yes, fr fr, she does. here we go again, same energy, same flags, no skips 💅

• -h, --help — Print this help. still printing the help. still helpful. still iconic 🎀
• -d, --debug — Turn on a debug mode and optionally specify a debug level in order to generate run-time debug outputs. debug mode, take two, the runtime outputs are still runtime outputting 🔍
• -r, --recalc — Re-calculate all formula cells after the documetn is loaded. recalculating, again, after the documetn, again ✨
• -e, --error-policy arg (=fail) — Specify whether to abort immediately when the loader fails to parse the first formula cell (fail), or skip the offending cells and continue (skip). same default, same fail, same skip, same girl 🫶
• --dump-check — Dump the content to stdout in a special format used for content verification in automated tests. dumping the content to stdout in the special format, as one does 💀
• -o, --output arg — Output directory path, or output file when --dump-check option is used. directory, or file with --dump-check, no notes 🌈
• -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.
• --row-size arg — Specify the number of maximum rows in each sheet. max rows, per sheet, every time 👑

---

and that's genuinely the entire page, bestie. no SEE ALSO, no env vars, no exit statuses, no examples, no authors, no bugs section — she said "options and vibes only" and honestly? respect 🫶

---

and that's a wrap on UNRECOGNISED(1) from liborcus 0.21.0, dated January 2026 💜 thank you for coming to my ted talk, go convert a Gnumeric file, slay, and remember: the FILE must be an existing file. mwah 🎀✨🦋