XFPT(1)

📦
version 1.00 · 2 versions
, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 XFPT(1) — the General Commands Manual glow-up 💖

okay bestie, pull up a chair, because we're about to talk about xfpt 💅 (that's section 1 of the General Commands Manual, for the record — she's official, she's documented, she's that girl).

✨ NAME ✨

xfpt — make XML from plain text 🦋

🌸 SYNOPSIS 🌸

xfpt [options] [source file]

🎀 DESCRIPTION 🎀

so basically, xfpt takes a marked up text file and turns it into XML. no cap. it's giving "glow up via formatting" and we're obsessed. 💖

the markup is simple, like genuinely lowkey adorable, and it comes in two flavors:

  • lines that begin with a dot — these are called "directive lines" 👑
  • sequences in the text that begin with an ampersand — these are called "flags" ✨

and here's the tea: the flag sequences are not built-in. they're defined by directives. so like, you make the rules, you set the vibe, you run the show. 🫶

as well as the in-built directives, macros can be used to implement higher level concepts — highkey iconic behavior.

a standard set of macros and flags that generate DocBook XML is provided, so if that's your thing, slay. 💅

there's a full description in the xfpt specification, which is distributed as a PDF file, an HTML file, and as xfpt source. so many formats, so many ways to read her. 📚✨

💜 OPTIONS 💜

  • -help or --help — this causes xfpt to output its "usage" information and then exit. she's telling you how she works, and then she's leaving. main character exit. 🚪✨
  • -o file — this specifies the output file. the default is the standard output if no source file is given, and the source file name with a .xml extension otherwise. so if you don't say where it goes, she picks for you. 🎀
  • -S directory — this specifies an alternative "share" directory in which to find standard configuration files. relocation era. 🦋
  • -v or --version — output the xfpt version and exit. a little "hi, it's me" moment. 💖

🌈 AUTHOR 🌈

Philip Hazel Retired from University Computing Service Cambridge, England.

Last updated: 08 March 2023 🌸 Copyright (c) 2023 University of Cambridge. 👑

and that's the whole page bestie, XFPT(1) out. mwah. 💅💖🦋

📦 where this page comes from