Am Freitag, den 04.09.2009, 23:43 -0400 schrieb Raymond Toy:
> All that can be reasonably expected is that people write comments on
> tricky parts of the code. I try to do this, but sometimes it's
> "obvious" (but not really); sometimes, I don't really understand; and
> sometimes, I'm just plain too lazy. And sometimes the checkin comment
> explains it, unfortunately.
When I am working on some code I sometimes reorder and rewrite the
complete code to get more insight what is going on and to learn how it
is was implemented. Furthermore, I comment the code. I have done this
e.g. for hypgeo.lisp, sin.lip, compar.lisp, rpart.lisp, ...
This way I get a much more readable code and often found the problems in
the code. Furthermore, I can find the points the code can be extended,
e.g. the algorithm to get the limit, the integral or the complex
characteristics of new functions.
But I hesitate to commit most of this work, because I always try not to
change to much in old files, including the comments.
If it is of interest I can put in more of this work into the source
code.
Dieter Kaiser