UNRECOGNISED(1)

📦
version 0.21.0 · 2 versions
, in fedora 44

👑 UNRECOGNISED(1) — User Commands 👑

okay so bestie, welcome to UNRECOGNISED, which is a whole User Commands situation, and honestly? it ate. it's the manual page for a little tool that converts ODF spreadsheets. yes the page is called UNRECOGNISED and the command inside is called orcus-ods — we don't ask questions, we just vibe. 💅

✨ NAME ✨

unrecognised — convert an ODF spreadsheet. that's it, that's the whole identity. 🦋

🌸 SYNOPSIS 🌸

orcus-ods [options] FILE

like, you give it a FILE, you give it some options if you're feeling fancy, and it does the thing. periodt. 💖

💜 DESCRIPTION 💜

the FILE must specify a path to an existing file. that's the one rule. if the file isn't there, bestie, it's not gonna manifest it for you. 🙈

💅 OPTIONS 💅

okay this is the part where the original page just... lists everything, and then lists everything again, which is highkey iconic of it. so here's round one, no skips, every single flag. 🔥

  • -h, --help — prints this help. the classic. the moment you type it, it's giving "I'm lost but politely."
  • -d, --debug — turns on debug mode, and you can optionally specify a debug level so it generates run-time debug outputs. yes, optional arg, yes, go off.
  • -r, --recalc — re-calculates all formula cells after the documetn is loaded. (that spelling is their spelling, not mine — we preserve the lore, fr fr.)
  • -e, --error-policy arg (=fail) — tells it what to do when the loader fails to parse the first formula cell. you get two choices and only two: fail → abort immediately, or skip → skip the offending cells and just keep going. default is fail, so by default it is not the chill one. 😭
  • --dump-check — dumps the content to stdout in a special format used for content verification in automated tests. test-girlie behaviour, love that for it.
  • -o, --output arg — the output directory path, or the output file when the --dump-check option is used. one arg, two moods.
  • -f, --output-format arg — picks the output format. here's the whole roster, every single one, no gatekeeping:
    • 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 unsupported. that's not me being dramatic, that's literally the page. don't come for me. 💀
  • --row-size arg — specifies the number of maximum rows in each sheet.

🔁 OPTIONS, AGAIN (the remix) 🔁

not me having to do this twice — the original page genuinely prints the entire option block a second time, so we're doing the encore. every detail, same as above, because skipping it would be a crime against the source material. 🎀

  • -h, --help — print this help.
  • -d, --debug — turn on a debug mode and optionally specify a debug level in order to generate run-time debug outputs.
  • -r, --recalc — re-calculate all formula cells after the documetn is loaded.
  • -e, --error-policy arg (=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 — dump 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 option is used.
  • -f, --output-format arg — specify the output format. supported format types:
    • 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.

🫶 THE SEND-OFF 🫶

and that's the whole page, bestie — no SEE ALSO, no AUTHORS section, no bug notes, it just ends. this absolute queen of a manual page is liborcus 0.21.0, dated January 2026, and it's filed under UNRECOGNISED(1) in User Commands. go convert some spreadsheets. slay. 💖✨🦋

📦 where this page comes from