... more fixing and, ça va sans dire, more creeping features.
I got prodded to integrate HEΛP with other tools; mostly, of course, ASDF. A simple solution was to define a document-op for a system. After jumping through a few hoops, the solution was to use the :properties of a system to pile up arguments for the main HEΛP document function (well, only one for the time being). Bottom line, suppose you have:
(asdf:defsystem "foosys" :pathname #P"D:/Common Lisp/Systems/foosys/")
now you just issue
(asdf:operate 'hlp:document-op "foosys")
and the documentation for the system "foosys" will appear in the "docs/html/" subfolder.
If you want to pass a title to the document function, you set up your system as:
(asdf:defsystem "foosys" :properties (:documentation-title "The FOO Omnipotent Tool") :pathname #P"D:/Common Lisp/Systems/foosys/")
and the parameter will be used (instead of the bare system name).
It works! 😁
Some more fixing and more extensions may be needed (hlp:document takes a lot of parameters) but it is already usable.
All the necessary bits and pieces are in the HEΛP repository, and they should get into Quicklisp in the next release.