QUICKBOOK(1)

πŸ’– QUICKBOOK(1) πŸ’–

hey bestie!! welcome to the User Commands corner of the manual, where we're talking about Quickbook β€” yeah, the section header literally says QUICKBOOK(1) and I am obsessed with how much this little tool can do. sit down, grab a boba, let's get into it πŸ§‹βœ¨


✨ NAME ✨

Quickbook</purl> β€” it's a WikiWiki style documentation tool, and it is geared towards C++ documentation. periodt. πŸ’…


🌸 DESCRIPTION 🌸

Okay so picture this: QuickBook is a WikiWiki style documentation tool geared towards C++ documentation, using simple rules and markup for simple formatting tasks. It's giving "I don't want to write raw HTML by hand" and honestly? relatable. 😭

Here's the glow-up: QuickBook extends the WikiWiki concept. Like the WikiWiki, QuickBook documents are just simple text files. But the way that ONE QuickBook document can generate a fully linked set of nice HTML and PostScript/PDF documents β€” complete with images and syntax-colorized source code?? no cap, that's main character energy. πŸ‘‘

πŸŽ€ Features include πŸŽ€

  • generate BoostBook xml, to generate HTML, PostScript and PDF
  • simple markup to link to Doxygen-generated entities
  • macro system for simple text substitution
  • simple markup for italics, bold, preformatted, blurbs, code samples, tables, URLs, anchors, images, etc.
  • automatic syntax coloring of code samples
  • CSS support

πŸ’… Allowed options πŸ’…

okay bestie, here's the full menu. no skips, no skimming β€” every single flag is below:

  • --help β€” produce help message 🫢
  • --version β€” print version string
  • --no-pretty-print β€” disable XML pretty printing
  • --indent arg β€” indent spaces
  • --linewidth arg β€” line width
  • --input-file arg β€” input file
  • --output-file arg β€” output file
  • --debug β€” debug mode (for developers) πŸ™ˆ
  • --ms-errors β€” use Microsoft Visual Studio style error & warn message format
  • -I [ --include-path ] arg β€” include path
lowkey important: that last one is written -I [ --include-path ] arg in the original, so --include-path shows up in brackets. iykyk. πŸ’€

πŸ¦‹ SEE ALSO πŸ¦‹

The full documentation for Quickbook is maintained in HTML; see /usr/share/doc/libboostX.Y-doc/HTML/doc/html/quickbook.html ✨


and that's the whole vibe!! this page is from Quickbook Version 1.4, dated July 2009, living under QUICKBOOK(1) in User Commands. mwah πŸ’‹ go write some docs, bestie, you got this πŸ’–πŸŽ€πŸ¦‹