Martin Baker wrote:
>
> I agree with you about going back to the original spad files but not
> about going to hypertext. As far as I can see hypertext is an old
> fashioned interface, in a small window on the screen, which I never use
> because it crashes too often. Its also very hard to contribute to (I've
> tried).
If you can crash HyperDoc, please report. ATM I know one way
of crashing HyperDoc, namely if you give complicated parameters
to a type and request info about implementations (I am working on
a fix for this). If you have any other way of crashing HyperDoc
please report.
BTW: In the past significant part HyperDoc crashes were in
functionality that was only available via HyperDoc, namely
looking up information about types and operations. If we would
like to present this information in a different way the simplest
way is to resuse the same code. So fixes to HyperDoc make
is easier to create alternative interface.
> At the moment documentation is spread between:
>
> Literate Programming (which is spread over about 400 pamphlet files
> and it is not always clear which one might hold the information that is
> being sought)
> Hypertext - An old fashioned interface which I never use.
> Axiom Book in either PDF or html form
> FriCAS Wiki, formally known as Axiom Wiki.
> fricas-devel mailing list
> Online Documentation spread over various places on the web.
>
> Much of this is out of date and confusing. It is very incomplete, even
> if you manage to search through all of this, chances are you wont find
> what you want?
One remark: it should be possible to recreate Axiom Book pdf from
htex files. This was done in the past. IIRC what Arthur Ralfs wrote,
MathML version of Axiom Book was done as combination of emacs lisp
code and hand effort. Since we do not have a way of updating it
authomaticaly it is somewhat out of date. However, using programs
like latex2html or tex4ht it should be possible to automathically
generate html version of Axiom Book from htex files. So .htex
file are the main form of FriCAS documentation. Mailing list
wiki and independent sites are another story.
> I think that a lot of this documentation needs to be brought together in
> on place so that a person, looking for information on a given topic,
> knows where to find it.
In Internet era you never can be sure where the information is.
Of course, there are reliable and rich sources. But a lot
is spread out in various obscure places.
--
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.
