Skip to content

Clozure/ccldoc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CCLDoc documentation system

CCLDoc is a system for creating Lisp documentation. It uses S-expressions to represent document structure, markup, cross references, and contents. It has a small number of basic operators, supports macros for syntax extensions, and supports a simple syntax for embedding expressions in strings for added convenience.

The documentation for Clozure CL is written in CCLDoc. The documentation files themselves are included in the CCL repository (see https://github.com/Clozure/ccl/tree/master/doc/manual).

After cloning the CCLDoc repository, load it into CCL by doing the following:

(require 'asdf)
(push "</path/to/ccldoc>/source/" asdf:*central-registry*)
(asdf:load-system 'ccldoc)

At this point, you can load the CCL manaul with

(defparameter *d* (ccldoc:load-document "ccl:doc;manual;ccl.ccldoc"))

To format the manaul, evaluate

(ccldoc:output-html *d* "ccl.html" :stylesheet "ccl:doc;manual;style.css")

You can then view the generated ccl.html file in your browser.

There is also a not-quite-complete LaTeX converter. To use it, do (output-latex *d* "ccl.tex") and then process the ccl.tex file with xelatex to produce a PDF file. The version of xelatex that comes with MacTeX 2014 has worked in the past.

About

CCLDoc documentation system used by Clozure CL

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages