CHIBI-DOC(1)

πŸ“¦
version 0.12 Β· 3 versions
, in ubuntu jammy, ubuntu noble, ubuntu stonking

🌸 NAME 🌸

chibi-doc β€” bestie, it generates documentation from Scheme scribble syntax πŸ’–


✨ SYNOPSIS ✨

chibi-doc [-hst] [file]
chibi-doc dotted.name.of.module [identifier]

πŸ’… DESCRIPTION πŸ’…

okay so chibi-doc is literally a lil doc-generating icon πŸ‘‘ it takes Scheme scribble syntax (yes, the one from Racket) and turns it into actual documentation. no cap.

it works exactly like a UNIX filter β€” it reads from the current input or from a file, and it writes the translated stuff straight to standard output. classic filter behavior, we love to see it 🫢

but wait, there's more ✨ you can also hand it a module name, with the components all separated by dots, and it'll go hunt down that module and generate the docs for you by processing the literate comments inside the module or any of its source files. and those comments? they're any line that begins with the characters

;;>

so cute, so simple πŸŽ€

and the scribble syntax itself is described in the manual β€” go look, iykyk πŸ’œ


πŸ¦‹ OPTIONS πŸ¦‹

  • -h β€” output in HTML format (which is, fyi, the default) 🌈
  • -s β€” output in SXML format ✨
  • -t β€” output in text format (this one's the default when you're describing a single identifier) πŸ’…

πŸŽ€ AUTHORS πŸŽ€

Alex Shinn πŸ’–


😭 REPORTING BUGS 😭

found a bug? tragic. please report it on Github πŸ™ˆ


🌟 SEE ALSO 🌟

chibi-scheme(1)


quick vibe check: this whole thing is chibi-doc from the General Commands Manual, version 0.9 (fluorine), dated 2020-08-08. slay, periodt πŸ’…βœ¨πŸ¦‹
πŸ“¦ where this page comes from