On 1 April 2014 21:17, Waldek Hebisch <[email protected]> wrote: > ... > In FriCAS you are not supposed to mix documentation and code. > If your documentation is usable from HyperDoc then it should > go into src/doc/ht or src/doc/htex. Otherwise doc is a good > place. IME trying to mix documentation and code make writing > documentation harder and lowers quality of documentation. > The only useful case beeing example code in documentation > and this is handled in .ht (and .htex) files. >
Actually I agree with you. I think that in FriCAS you have argued - and now I agree with you - that the use of pamphlet files inherited from the original Axiom project is of little or even negative utility. It would be best to replace all pamphlet files with just the original spad files as was the case in the original NAG source code release. The little useful documentation in the existing pamphlet files is better off moved to the .htex files. If this were the case then there would be no need for a separate target src directory and the issue with false positives and Ralf's code would not arise. -- You received this message because you are subscribed to the Google Groups "FriCAS - computer algebra system" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/fricas-devel. For more options, visit https://groups.google.com/d/optout.
