[vsipl++] Using synopsis for VSIPL++ documentation

[Jules Bergmann]

Stefan Seefeld wrote:

>> (a) create a build-synopsis script (for inclusion in build-vpp-World) 
>> so that we can install synopsis in /usr/local/tools/vpp-1.0.
> 
> 
> What platforms would this be (potentially) be run on ? I'd like to make
> sure synopsis compiles out of the box on all those, before I add a 
> dependency
> like that. Also, what constraints does this impose on synopsis'
> availability ? Can / should it be fetched from svn ? Or should we put it 
> locally
> into our own repository ?

The build-synopsis script would be run on our build systems (i.e. 
Sethra) to build a "good" version synopsis for use in making releases. 
We wouldn't distribute the build-synopsis or even synopsis with VSIPL++, 
just the generated output.

The build-synopsis script could work from a tarball, or from CVS (such 
as build-qmtest).  I don't know if we have any build-* scripts that pull 
out of svn, but if that makes sense, it shouldn't be too hard.

> 
>> (b) add/update the Makefiles to run synopsis (if not already done)
> 
> 
> That is already done, AFAICT.

good!

				-- Jules