[Openmcl-devel] ccl manual (was Re: trace on recursive functions)

[Philippe Sismondi]

As I read through this thread I have been asking myself what is most  
important to me as a recent student of Lisp and ccl. My desires as  
regards documentation are:

It should (of course) be as complete and up to date as possible.

Authoritative documentation should be in one place rather than  
multiple places. (That was the problem I raised in my post that led to  
this thread. I look in the manual but forget the wiki.)

It should be available in some one-chunk offline format, html or pdf.  
Presently I most often rely on a simple text search of the ccl manual.  
I don't want to rely on a web search capability for searching manuals.  
(Maybe I'm a luddite in that regard.)

I don't know whether community contributions would be good or not. I  
would be very displeased to discover that spurious or badly written  
stuff was creeping in. Technical documentation is not wikipedia; I  
rely on ccl docs to do actual work. I would find it sufficient to  
search mailing list archives for community input, I think.

So, my guess is that fancy semantic markup like docbook or restrictive  
wiki rules are probably more of a hinderance than a help here.  
Reasonable structural and stylistic rules enforced by convention  
rather than software are more likely to produce what I want to read  
and use.

- P -