Hello,


I removed Manuel from the recipient because I had put them in the loop only for the math aspects...


Concerning your suggestion, this is something that I had often thought about that it would be good if docstrings would allow better interaction with manuals, like be written with some markup to allow other format (like some Org mode like, or some simplified texinfo). 


It would be good if a docstring could point at some anchor in a manual. I had started to think about that because in Calc there is no docstrings at all, but rather some function that scans the manual for the function description. Unfortunately this function first uses the language in which the manual is written, which is not good programming practice to make any algorithm locale-dependent, and second this function had a number of bugs which were corrected over time, which shows that this method is hard to tune. 


It would be better to have some markup to say "hey !  go the the point that correspond to index entry XXX where you find that index in this index info node", and XXX is the function/variable/etc... to document and that has some index entry.


That would also allow to make function/variable documentation internationalized.


Anyhow, a simple-to-do thing would be to place this manual in some place, like similar to that of sed:


http://gnu.april.org/software/sed/manual/


And then put an url to this page in some docstring or in the emacs manual info node about games.


   Vincent.