Re: [fricas-devel] [PATCH] computation.spad Documentation Issues.

2016-09-22 Thread Bill Page
On 22 September 2016 at 05:25, Ralf Hemmecke wrote: > ... > And (maybe contrary to Waldek) I am not in favour of keeping hypertex > as a format. In fact, I don't believe that there is somewhere written > down document that defines the format of the ++ docstrings. I'd like > to

Re: [fricas-devel] [PATCH] computation.spad Documentation Issues.

2016-09-22 Thread Martin Baker
On 22/09/16 10:35, Ralf Hemmecke wrote: Hi Martin, Because different browsers can render SVG slightly differently I tend to export to a raster format (PNG) for the web. I think this is as standards based as I can get. I have seen that font-related stuff can differ from computer to computer,

Re: [fricas-devel] [PATCH] computation.spad Documentation Issues.

2016-09-22 Thread Martin Baker
On 22/09/16 10:25, Ralf Hemmecke wrote: What exactly is meant by "FriCAS IO"? I meant your website: https://fricas.github.io/ Do you think it would be viable, when browsing the Category/Domain/Package API, that the information about each individual structure might additionally link out to

Re: [fricas-devel] [PATCH] computation.spad Documentation Issues.

2016-09-22 Thread Ralf Hemmecke
Hi Martin, > Because different browsers can render SVG slightly differently I tend > to export to a raster format (PNG) for the web. I think this is as > standards based as I can get. I have seen that font-related stuff can differ from computer to computer, but if you have converted your objects

Re: [fricas-devel] [PATCH] computation.spad Documentation Issues.

2016-09-22 Thread Ralf Hemmecke
>> It would be really good if Fricas IO could be the hub for all the >> various types of online documentation for all categories, domains, etc. >> If there were to be a standardised way to embed URLs in ++ comments like >> this: >> >> ++ Author: Martin Baker >> ++ Date Created: March 2011 >> ++

Re: [fricas-devel] [PATCH] computation.spad Documentation Issues.

2016-09-22 Thread Martin Baker
On 21/09/16 20:56, Waldek Hebisch wrote: Martin Baker wrote: Usually I first produce documentation in HTML and put it on my website. I then copy it into code file, this copy is inferior to the HTML version because it does not have diagrams. What do you use to create diagrams? In other words:

Re: [fricas-devel] [PATCH] computation.spad Documentation Issues.

2016-09-21 Thread Waldek Hebisch
Martin Baker wrote: > > In order to complete the recent changes to computation.spad I have > updated the documentation to match the code changes. Commited. > > Issues: > > 1) Is it possible to suppress automatic insertion of spaces around colon > and commas in literate parts of the file?

[fricas-devel] [PATCH] computation.spad Documentation Issues.

2016-09-21 Thread Martin Baker
In order to complete the recent changes to computation.spad I have updated the documentation to match the code changes. Documentation changes only, no change to code. patch is here: https://github.com/martinbaker/multivector/blob/master/computation5.patch code is here: