UNRECOGNISED(1)

📦
version 0.21.0 · 2 versions
, in fedora 44

💖 UNRECOGNISED — the manual page, but make it make sense 💖

okay so bestie, welcome to UNRECOGNISED(1), part of the User Commands section, and no because the name is literally UNRECOGNISED, that's not me being dramatic, that's just what it's called 😭

✨ NAME ✨

unrecognised — convert a CSV file. that's it. that's the whole job. she converts, she serves, she goes home. 💅

🌸 SYNOPSIS 🌸

orcus-csv [options] FILE

so you run orcus-csv, you throw some [options] at her if you want, and then you hand her a FILE. iconic behavior honestly.

🦋 DESCRIPTION 🦋

The FILE has to point at a path to an existing file. like. it has to actually be there. a file that exists. that's the vibe check and it must be passed, no cap. 💀

👑 OPTIONS 👑

okay this is the part where I need you to pay attention because there are a LOT of them, and then — plot twist — they get listed a second time. not me inventing that, it's just how the page is. we love a double feature. 🍓

  • -h, --help — print this help. she tells you about herself. main character energy.
  • -d, --debug — turn on a debug mode, and you can optionally specify a debug level so you get run-time debug outputs. turn it up 💅
  • -r, --recalc — re-calculate all formula cells after the document is loaded. yes all of them. every last one.
  • -e, --error-policy arg (=fail) — tells her what to do when the loader fails to parse the first formula cell. pick 'fail' to abort immediately, or 'skip' to skip the offending cells and keep it moving. default is fail so she WILL be dramatic unless you tell her otherwise.
  • --dump-check — dump the content to stdout in a special format used for content verification in automated tests. very "iykyk".
  • -o, --output arg — output directory path, or the output file when the --dump-check option is used. one arg, two personalities.
  • -f, --output-format arg — specify the output format. supported format types are, and I'm listing them all because bestie you deserve the full menu:
    • check — flat format that fully encodes document content. suitable for automated testing.
    • csv — CSV format. the classic. the original.
    • 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. lowkey a mood.
    • xml — this format is currently unsupported. 🚫
    • yaml — this format is currently unsupported. 🚫
  • --row-size arg — specify the number of maximum rows in each sheet. cap the rows, queen.

🌈 and now... round two 🌈

no because literally, the page says all of this AGAIN. same options, same order, same everything. I'm not going to skip it because skipping is a crime and I'm not a criminal. here she is, take two, we're obsessed 🫶

  • -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 document is loaded.
  • -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').
  • --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 the --dump-check option 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 — 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.
⚠️ reminder bestie: xml and yaml are listed as output formats but the page straight up says they're currently unsupported. don't come for me, I'm just the messenger. 💀

and that's the whole page. no notes. go convert something. 🎀

this page is liborcus 0.21.0, dated January 2026 — so like, shoutout to the version and the month, they ate and left no crumbs ✨ bye bestie, love u, hydrate 💜

📦 where this page comes from