|
From: | Bill Page |
Subject: | Re: [Axiom-developer] Axiom, FriCAS, forks and teeth |
Date: | Thu, 12 Jul 2007 10:05:22 -0400 |
On 7/12/07, C Y wrote:
... Gaby wrote: > And the ones that look > advanced documentation look to me poorer than non-pamphletized > documentation -- e.g. I have far less trouble reading > and trying to undestand SBCL source code than reading and > understanding bookvol5 and friends and the rest of the system.
I agree!
As I understand it, bookvol5 is nowhere near completion. What is your take on dhmatrix? As I understand it that file is closer to a "proper" literate document. Or, for that matter, what about cl-web?
I think dhmatrix as a literate document is rather "marginal". Yes it presents the main ideas of the code but does not seem like much advance over embedded comments to me. cl-web: A very well written example for a relatively small program. I think this is very hard to reproduce for most Axiom components. (cl-web is not Axiom). Regards, Bill Page.
[Prev in Thread] | Current Thread | [Next in Thread] |