Hi Martin,

do you allow me to criticise your Guess implementation?

I was just looking up in hyperdoc, what the function "guess" is actually doing.

Of course, I basically see only what is written here.

  guess: List F -> GUESSRESULT
    ++ \spad{guess l} applies recursively \spadfun{guessRat} to the
    ++ successive differences and quotients of the list.
    ++ Default options as described in
    ++ \spadtype{GuessOptionFunctions0} are used.

OK, that does, of course, not tell something about how I have to interpret the output for

  guess [1,1,2,3,5,8]

                s  - 1
         n - 1   6
          --+    --+
   (2)  [ >      >      [f(s ): (- s  + 1)f(s ) + s  - 1= 0] + 1]
          --+    --+        5       5        5     5
         s = 0  s = 0
          6      5
                                       Type: List(Expression(Integer))

Now, if I don't a chance to ask you immediately, then the first check would be to see what you describe for "guessRat". But if I click on it, then I get "Select a view below". So I click "signatures". But uhhh... I get a list of 18 guessRat functions. All with different signature. How do you expect a user to find out which of them you actually applied in "guess"? As a unexperienced Guess user, I stop here and don't use your package.

Is that what you want? It seems that you must be the only Guess user. Would you mind to improve the documentation so that others could benefit from your work?

Ralf

PS: You might have some more documentation in the pamphlet, but if I wouldn't already know how FriCAS is programmed, I would have no idea that somewhere is still some more information. So the pamphlet is irrelevant to the non-experience user. And anyway, how would I find out *quickly* about my question of how to interpret the result of guess?

--
You received this message because you are subscribed to the Google Groups "FriCAS - 
computer algebra system" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/fricas-devel?hl=en.

Reply via email to