On November 5, 2006 6:11 PM Waldek Hebisch wrote: > I just neticed that a large documentation hunk was copied > almost verbatim from 'src/interp/daase.lisp.pamphlet' into > 'src/etc/asq.c.pamphlet' IMHO this is _very_ bad practise. It > increas work needed to maintain Axiom. And the to copies are > likely to get out of sync anyway, which will cause confusion > to the readers. > > AFAICS the copy in 'src/etc/asq.c.pamphlet' should be removed > and replaced by text like: > > Database structure is described in [[src/interp/daase.lisp.pamphlet]]. > Note that [[asq]] currently works only with compressed databases. >
On November 5, 2006 6:39 PM Tim Daly replied: > > Although the text in some blocks is the same the structure of the > documents are different. Asq does not contain all of the information > that is in daase. Both documents needs explanation and they will > diverge in the future. I'm looking at changing asq to handle html > style output. The information will certainly diverge (and you'll > notice that they are structured differently) as I continue to > change asq. The asq changes are not fully documented. Please have > patience. > I strongly agree with Waldek. You should not be duplicating information from src/interp/daase.lisp.pamphlet in the documentation for asq. This is independent of whether asq produces HTML styly output or not. In reference to the underlying database structure I think you should use Waldek's version. Regards, Bill Page. _______________________________________________ Axiom-developer mailing list [email protected] http://lists.nongnu.org/mailman/listinfo/axiom-developer
