UNRECOGNISED(1)

okay so bestie, pull up a chair, because we're reading UNRECOGNISED(1) together and honestly? it's giving mysterious. it's a User Command, it lives in section 1, and it's here to do exactly one (1) thing. let's get into it 💅

---

✨ NAME ✨

unrecognised — transform an XML file 🌈

that's it. that's the whole name section. no notes.

---

🦋 SYNOPSIS 🦋

orcus-xls-xml [options] FILE

okay so not me noticing the command is called orcus-xls-xml while the manpage is called unrecognised 💀 iconic behaviour, we love a plot twist.

---

🌸 DESCRIPTION 🌸

the FILE has to be a path to a file that actually exists, bestie. like, an existing file. that's the vibe check. if your file isn't real, we're not doing this today 🙈

---

💖 OPTIONS 💖

here's the whole menu, no skips, no crumbs, every single one:

• -h, --help — print this help. the classic. the icon. the "please tell me what this does" button 🫶
• -d, --debug — turn on a debug mode, and optionally tell it a debug level so it can generate run-time debug outputs. yes, you can just say -d and let it cook, or get specific with a level ✨
• -r, --recalc — re-calculate all the formula cells once the document is loaded. crunch those numbers again, queen 👑
• -e, --error-policy arg (default fail) — decides what happens when the loader can't parse that first formula cell. pick fail and it aborts immediately, or pick skip and it just skips the offending cells and keeps it moving. choose your fighter 😭
• --dump-check — dumps the content to stdout in a special format that gets used for content verification in automated tests. very much for the test girlies 🧚
• -o, --output arg — output directory path. OR, when the --dump-check option is in play, it's the output file instead. context-dependent king 🌟
• -f, --output-format arg — specify the output format. supported format types are:
  • check — flat format that fully encodes document content. suitable for automated testing. the overachiever 🎀
  • csv — CSV format. the people's princess.
  • debug-state — dumps the internal state of the document in detail, useful for debugging. it's giving x-ray vision 🔥
  • flat — flat text format that displays document content in grid. very grid, very demure.
  • html — HTML format.
  • json — JSON format.
  • none — no output to be generated. maybe useful during development. sometimes the best output is no output, periodt 💜
  • xml — this format is currently unsupported. 💀
  • yaml — this format is currently unsupported. 💀💀
• --row-size arg — specify the number of maximum rows in each sheet.

---

🍓 OPTIONS (again) 🍓

okay bestie, listen. the original manpage lists this entire block twice. same options, same order, same everything. so here it is again, verbatim-in-spirit, because the one rule is that nothing gets dropped. i'm not summarising, i'm not merging, i'm serving you the sequel 🫡

• -h, --help — print this help. encore performance 🎤
• -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 (default 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.

---

🚨 real talk, no cap: -e/--error-policy defaults to fail, which means it will abort immediately on the first formula cell it can't parse. if that's not the energy you want, you have to say skip out loud. don't come crying to me later 💖

---

and that's the whole page, bestie!! 🌈✨ this little love letter was written for liborcus 0.21.0 and dated January 2026 — so go transform some XML, slay your spreadsheets, and remember: if the format is xml or yaml, it is unsupported, and that is simply not your problem today 💅🦋🎀