Copyright (c) 2012-2019 Marco Antoniotti and Stefano Gandelli
See file COPYING for licensing information
HE?P ("HELP") is yet another CL code documentation utility, which has
been inspired by JavaDoc and doxygen.
HE?P produces, by default, a (mostly) XHTML set of documents. The
system strives to be simple to use by making a few choices, while
maintaining a number of hooks that can be used to customize the
system, e.g., by producing a different kind of output (e.g., Texinfo).
The simplest way to get HE?P (pun intended) is to use the function
document, as in the example below, where a few assumptions are made.
We are in the directory where the code to be documented resides. The
actual documentation will end up in the directory (using POSIX syntax
and conventions) `./docs/html/`.
cl-prompt> (document *the-current-directory* :documentation-title "My Library")
;;; Several messages, some warnings and error messages.
;;; More messages, more warnings and error messages (these last ones ignored.).
;;; Yadda, yadda, yadda....
As stated, the previous command will create the documentation (with an
index.htm file in the `./docs/html/` folder. Alas, note that the
`*the-current-directory*` must be obtained in an
implementation-dependent way. Note also that the default format for
the documentation is (mostly) XHTML.
The documentation thus generated is incomplete. Some HTML files are
either skeletons or are not there (and your browser may complain
accordingly). It is up to you to fill these files with appropriate
content: a prominent example is the file named introduction.htm which
appears on the first page. It usually appears blank.
HE?P is available on quicklisp.
Otherwise, installation should be simple if you have quicklisp, ASDF,
or MK-DEFSYSTEM set up. You will need also XHTM? and a few other
libraries. Check out the system files for the current list.
A NOTE ON FORKING
Of course you are free to fork the project subject to the current
licensing scheme. However, before you do so, I ask you to consider
plain old "cooperation" by becoming asking me to become a developer.
It helps keeping the entropy level at an acceptable level.
Marco Antoniotti 2017-03-23