axiom-developer
[Top][All Lists]

## 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.

(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





reply via email to