Re: [OctDev] Re: Nonlinear optimization tutorial

[Paul K. <pki...@ja...>]

I'm interested in the actual editting since that is what we are doing now.

Pure latex for tutorial guides seems to be the concensus since it is a
freely available stable format that is easily editted and which can be
transformed in a variety of distribution formats.  Also, given the
distributed nature of the project, it is convenient for the documents
are "composable" in perl, e.g., allowing the function descriptions to be
pulled from the function files and pasted after the unifying description.
Feel free to continue to suggest other alternatives.

For the documentation we distribute we need to use a format that is
available to the user.  html and pdf are obvious candidates here, and I see
that most everyone will be able to view MathML with a bit of effort
(http://www.w3.org/Math/implementations.html).  Initially I'll use html
because it is easiest, but MathML seems like the direction we should go.

- Paul

On Tue, Mar 19, 2002 at 11:08:36AM +0100, Rafael Laboissiere wrote:
> * Paul Kienzle <pki...@ja...> [2002-03-18 10:28]:
> 
> > We need to settle on a document format, or maybe a small number of formats.
> > That way it will be easier to work together on documentation. Standard
> > layout of documentation in the directory would also be helpful so that the
> > build/install docs can work like install m-files.
> 
> DocBook-XML seems to be a natural choice, besides the fact that it has no
> native support for mathematical typesetting.  If/when MathML will work
> together with DocBook and have a good TeX backend, the DocBook format will
> be a strong candidate.  Sebastian Ratz' PassiveTeX looks promising, though I
> never used it (see http://www.hcu.ox.ac.uk/TEI/Software/passivetex/).  
> 
> At any rate, editing math directly in MathML seems quite tedious and
> verbose. However, I think that the present discussion has to do with choice
> of formats and not with the actual editing.
> 
> -- 
> Rafael
> 
> _______________________________________________
> Octave-dev mailing list
> Oct...@li...
> https://lists.sourceforge.net/lists/listinfo/octave-dev