XMLROFF(1)

📦 version 0.6.2, in ubuntu jammy

✨ XMLROFF(1) ✨

okay bestie, welcome to the manual page for xmlroff — yes, that's the whole manual name, she's from section 1 of the Unix manuals, and she's about to become your new obsession 💖

🌸 NAME 🌸

xmlroff — an XSL formatter. that's it, that's the name, short and iconic 💅

🦋 SYNOPSIS 🦋

xmlroff [-o output-file] [--format {auto | pdf | postscript}]
        [--backend {gp | cairo}] [--continue] [-? | --help] [--compat |
        --nocompat] [--compat-stylesheet] [--valid | --novalid] [-v |
        --version] [-w warning-mode] [-d debug-mode] file [stylesheet]

💜 DESCRIPTION 💜

so xmlroff is a free, fast and high-quality XSL formatter, and honestly? she's so useful for DocBook formatting. like, that's her whole thing. she produces PDF or PostScript output, and she integrates easily with other programs and with scripting languages — she plays nice with everybody, we love a collaborative queen 🫶

here's how she works: xmlroff processes the XML-FO file. and if you want, an arbitrary XML file can optionally be first transformed via a specified XSLT stylesheet. yes bestie, you can bring your own stylesheet to the party 🎀

🎀 OPTIONS 🎀

  • -v — show version information. say hi, tell me who you are 💅
  • -?, --help — show the help message. when in doubt, ask for help, no shame in it ✨
  • -o output-file — specify the output filename. and listen, if you don't pass this option, the default of layout.pdf gets used, so don't be shocked when a layout.pdf just shows up in your folder 😭
  • -d debug-mode — specify debug mode. for when you need to see what's actually going on inside 🔥
  • -w warning-mode — specify warning mode. she's warning you, bestie, listen to her ⭐
  • --format {auto | pdf | postscript} — specify the format of the output file. the default is auto, which picks the format based on the extension of the output filename. so auto is basically the friend who reads the room and adapts 🌈
  • --backend {gp | cairo} — specify the backend used to produce the output file. the default is GNOME print (gp). two backends, two vibes, pick your fighter 👑
  • --compat, --nocompat — do, or do not, pre-process the input file with an internal compatibility stylesheet. the default is --compat. so by default she's doing the pre-processing, okay? 💖
  • --compat-stylesheet — prints the internal compatibility stylesheet, then exits. she just shows you the goods and dips, main character exit 🧚
  • --continue — continue after any formatting errors. she does not give up on you, not ever 😭
  • --valid, --novalid — do, or do not, load the DTD. the default is --novalid. so heads up, by default she is not loading that DTD 💀

🐛 REPORTING BUGS 🐛

found a bug? report it at http://xmlroff.org/newticket — that's http://xmlroff.org/newticket in case you need it twice, which the page does give you twice, so here it is twice 🫶

🌟 SEE ALSO 🌟

xsltproc(1) — go read that one too, bestie, she's part of the family 💜

👑 AUTHOR 👑

Tony Graham — the icon behind it all, thank you for your service 🎀

ok that's the whole page, no notes, go forth and format ✨

and that's a wrap on the xmlroff(1) page, bestie 💖 the header up top says XMLROFF(1) and the footer down at the bottom says XMLROFF(1) too, and ngl there's no extra source or version or date line in there for me to spill — so that's the tea, periodt 🌸

📦 where this page comes from