cl-gendoc

2018-08-31

cl-gendoc: Simple component-based documentation generator

Upstream URL

github.com/rpav/cl-gendoc

Author

Ryan Pavlik

License

LLGPL, BSD
README

cl-gendoc

This is a simple but flexible modular document generator for Common Lisp, because I couldn't find something similar:

(gendoc (:output-filename "docs.html"
         :css "simple.css")
  (:mdf "intro.md")
  (:mdf "details.md")
  (:apiref :some-package :another-package)
  (:mdf "closing.md"))

Of some interest is probably the API reference generator:

(defun some-function (X)
  "=> output-forms

This takes `X` and produces *output-forms*"
  ...)

The docstring is processed as markdown with 3bmd, optionally specifying a return-spec if the first line starts with "=>".

See the generated documentation for cl-gendoc.

Dependencies (2)

  • 3bmd
  • cl-who
  • GitHub
  • Quicklisp