publish2latex

Using full Latex markup in m-files to generate high quality documentation. Version 1.3

Publish2Latex

Version V1.3

A new conversion of figures to eps has been implemented. This automatically selects the best renderer depending on the nature of the data on the axis of the figure. It automatically chacks the size of surfaces and renders very large surfaces as raster-graphics while using vector graphics for the axes. This imporves the size and speed at which the pdf document can be viewed and printed.

Version V1.2

Some details in the string handling of the screen output from MATLAB have been improved. The renderer used when exporting eps has been changed to improve efficiency.

Version V1.0

April 2013

Matthew Harker and Paul O'Leary
Institute for Automation
University of Leoben
Austria

Introduction
------------
This toolbox enables the use of full Latex markup for the generation of high quality documentation from m-files. This includes bibliographies, cross referencing, captions etc.

The tool documents the code in a listing environment, the screen output in a verbatim environment, the graphical output is captured to eps and integrated into the final documentation.

We originally wrote this tool to support a detter quality of documentation for out mathematical libraries. All the documentation for the Discrete Orthogonal Polynomial Toolbox: DOPbox:

http://www.mathworks.com/matlabcentral/fileexchange/41250

and the ODEbox

http://www.mathworks.de/matlabcentral/fileexchange/41354

were generated with this tool. Consequently, many examples of m-files for use with this tool can be found there.

Where to Start
--------------
We recommend you start in the documentation directory. There there is an example .m file and the resulting .pdf. the file introduction.pdf is the documentation for this toolbox and was generated using this tool.

Changes
-------
Version V1.1

1) The MATLAB figure files are now cropped so that the bounding box is the minimum size bounding box possible.