Bill Page wrote:
>
> I am not talking about spurious usage. Pamphlet files are supposed to
> contain documentation and explainations. Since they are also LaTeX
> files in is also common to use %% for free form comments or for
> temporarily removing some content, etc. For example, if I wanted to
> write a pamphlet file describing how to use the
>
> )abbrev ...
>
> line in Spad source files and giving examples that were not intended
> to be part of any
>
> <<.....>>=
> ...
>
> code chunk, then including such a file could cause hard to diagnose
> problems in the doc/Makefile
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.
--
Waldek Hebisch
[email protected]
--
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.
