Martin Baker <ax87...@martinb.com> writes: > On Sunday 31 Jan 2010 16:59:14 Martin Rubey wrote: >> Waldek Hebisch <hebi...@math.uni.wroc.pl> writes: >> > And yes, it is inconvenient, but some folks here consider it the only >> > right way to write programs... >> >> I don't find it inconvenient, but I understand well that Waldek does. >> On the other hand, I find it very inconvenient to look for documentation >> outside of the source file, which Waldek seems to prefer (see >> fricas/doc/sttaylor.txt). > > I think I'm with Waldek on this, I find this way of mixing in documentation > very inconvenient, it may be useful to read the level of detail in > sttaylor.txt once but I don't think I would want to wade though that, every > time I wanted to find a piece of code once I understood the program.
The trouble is that I will not update documentation if it's not right next to the source. As much as I admire Waldek skills, and although I call myself mathematician (well, combinatorialist), I was unable to understand most of modhpsol.spad so far. I admit that the documentation in mantepse.spad is a mess, but moving the mess into a separate directory won't help, I think. I would really like to discuss changing the documentation policy of FriCAS, but I cannot do so before the project I'm currently working on is done. Martin -- 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 fricas-de...@googlegroups.com. To unsubscribe from this group, send email to fricas-devel+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/fricas-devel?hl=en.
