[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Axiom-developer] putting pamphlets on MathAction
From: |
Ralf Hemmecke |
Subject: |
Re: [Axiom-developer] putting pamphlets on MathAction |
Date: |
Thu, 14 Sep 2006 19:18:25 +0200 |
User-agent: |
Thunderbird 1.5.0.5 (X11/20060719) |
Sorry to say, Martin, but even though you tried to document the API of
the package constructors, your code is much in the spirit of the old
Axiom files. :-(
Your code may be excellent, but it is clearly written for a machine and
not for humans. So I cannot read it. You probably know that.
Take for example mantepse.spad.pamphlet:
\begin{abstract}
The packages defined in this file enable {\Axiom} to guess formulas
for sequences of, for example, rational numbers or rational functions,
given the first few terms. It extends and complements Christian
Krattenthaler's
program \Rate\ and the relevant parts of Bruno Salvy and Paul
Zimmermann's \GFUN.
\end{abstract}
That is actually ALL there is to describe the algorithms you use inside
your code. :-( Even worse. The macros \Rate and \GFUN are not references
to the literature or URLs.
If Axiom were a Journal and your code were a contribution to that
journal. I am sure you yourself would reject that.
Sorry for such harsh criticism, but I simply think if new things are to
be accepted to Axiom they should come with a certain standard. We
already have enough legacy code to deal with.
I would change my mind if your contributions makes (at least) two more
contributors to Axiom Algebra and and you promise to document your code
in an LP style till the end of the year.
Maybe you should have a nap... ;-)
Good luck with the presentation of your Guess package.
Ralf
On 09/14/2006 05:56 PM, Martin Rubey wrote:
Dear Bill,
could you please put the three attached pamphlets on mathaction.
fffg.spad.pamphlet => FractionFreeFastGaussianElimination
rec.spad.pamphlet => RecurrenceRelationOperator
mantepse.spad.pamphlet => Guess
(mantepse depends on the other two)
I got an error message about noweave not found, and including it via spad
doesn't seem to like the dollar signs...
(sorry for not being particularly useful anymore, I didn't sleep last night...)
Thanks for everything,
Martin