Re: [Axiom-developer] [axiom-developer] What do diagrams in bookvol10.3 mean?

[daly]

On Thu, 2011-09-22 at 13:05 +0200, Ralf Hemmecke wrote:
> > Besides, in my opinion (it is only my opinion, but still it is opinion
> > of newcomer) HyperDoc documentaion is structured in non-standard fasion,
> > which makes it not so easy to use at the beginning.
> 
> It's not just your opinion. But there is currently not enough manpower 
> to treat every aspect of this big system. And if you look at the 
> sources, you'll find that they are written in hypertex, which is close 
> to tex, but has some hyperlinking features. There is no browser version 

Actually, Axiom has a browser version (books/bookvol11.pamphlet)
It is being redesigned to use HTML5 rather than straight HTML.

> since someone would have to translate (or automatically convert) the 
> hypertex sources into html. Furthermore some of the sources, in 
> particular the API descriptions are written in the source code itself as 
> ++ comments. These are currently automatically extracted from the code 
> and made available to HyperDoc.

...[snip]...

> > (that's why I was wondering about diagrams, as I thought they could help
> > me to build hierarchies of Domains of categories - diagram given on the
> > axiom-developers.org <http://axiom-developers.org> is too big to be usable).
> 
> There are two quite usable diagrams in the original Axiom book by 
> Jenks&Sutor. I don't however know whether these (smaller) hierarchies 
> exist somewhere in the net.

The endpapers from the original book are in src/doc/endpaper.pamphlet
or on the web at http://axiom-developer.org/axiom-website/endpaper.pdf