Re: Small documentation problem

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

Re: Small documentation problem

Tim Daly
I'll fix the duplicate line. Thanks for the bug report.
Any path that is convenient for reporting bugs is ok.

re: diagrams.

The diagrams in the Axiom pdf use .eps (which is
encapsulated postscript, i.e. postscript with size info).
The eps files live in books/ps with the convention that
    books/ps/v103*
are images in volume 10.3. Your images are
    books/ps/v103permgrpxx.eps
where xx is a sequential number.

If you tar up the .svg diagrams I can redo the images.

Alternatively, the pamphlet files are just raw latex. If you
cd to the books directory you should be able to just do
   gcc -o tanglec tanglec.c
to get the tanglec program. You only need to do this once.
 
   ./tanglec bookvolbib.pamphlet axiom.bib >axiom.bib
   latex bookvol10.3.pamphlet
   makeindex bookvol10.3.idx
   bibtex bookvol10.3.aux
   latex bookvol10.3.pamphlet
   latex bookvol10.3.pamphlet
   dvipdfm bookvol10.3.dvi
   evince bookvol10.3.pdf

Open a shell to run the above commands in a bash script.
If you leave the pdf viewer running it will update automatically
every time you remake the file. So you get a "hot loop' where
you change the pamphlet file, run the bash script, and see the
result immediately.

When you are happy with the changes you can do

   git diff books/bookvol10.3.pamphlet >patchfile

and send me the patch file.

Tim



re: too much information

The target audience is students. I'm about to be a visiting
scholar at CMU and I hope to set up a seminar series to
attract students to working with Axiom. Since these are CS
students, not Math students, I assume they have very little
if any idea about group theory concepts.

Topics of a general nature would likely go into Volume 1, the
Axiom Tutorial. Topics specific to new algebra would modify
Volume 0, the Jenks book, in the appropriate algebra location,
in the help files, in hyperdoc, and in the (as yet unpublished)
web pages.

So there is a place somewhere in the system for documentation
at almost any level. Indeed, if all else seems inappropriate there
can always be a new volume.

Tim


_______________________________________________
Axiom-developer mailing list
[hidden email]
https://lists.nongnu.org/mailman/listinfo/axiom-developer