[Openmcl-devel] ccl manual (was Re: trace on recursive functions)
psismondi at arqux.com
Thu Dec 10 20:56:45 UTC 2009
On 2009-12-10, at 2:20 PM, Tom Emerson wrote:
> On Thu, Dec 10, 2009 at 2:11 PM, R. Matthew Emerson
> <rme at clozure.com> wrote:
>> The manual is in DocBook, and it is rather painful to edit (at
>> least for me it is). Emacs's nXML mode keeps me from producing
>> invalid structure, but still, DocBook is big and complicated.
> Is there a compelling reason to keep the manual in DocBook?
> Not only is it painful to edit, setting up the tool chain to build the
> documentation can be a RPITA. Is there interest in moving to another
> system? I'd be interested in helping with such a transition. As an
> example, LaTeX is (IMHO) easier to deal with in the large, has
> excellent pre-packaged distributions on multiple platforms, and
> excellent support in Emacs.
> Tom Emerson
> tremerson at gmail.com
> Openmcl-devel mailing list
> Openmcl-devel at clozure.com
Sorry - further to my last post: I am pretty comfortable with both
both docbook and latex. I really like the not-so-new idea of having a
single source of documentation that can be transformed into multiple
output forms - html, pdf, notches carved on a stick, etc.
- P -
More information about the Openmcl-devel