Hi Steven,

sorry but my explanation was too short. Shogun is using doxygen to build
the documentation that is arch indep and in addition to that it embeds
the doxygen documentation into the python module(s) such that you can
type e.g.

import modshogun

help(modshogun.Kernel)

and get all the methods documented/annotated.

This probably could be done without graphviz/tex but I didn't try that.

Soeren

On Thu, 2014-09-04 at 22:36 +0100, Steven Chamberlain wrote:
> On 04/09/14 21:52, Soeren Sonnenburg wrote:
> > The problem with the doc is - it is needed so you can type help...
> 
> I don't think I understand...  but I'll explain again just in case I
> wasn't understood:
> 
> What I suggest is that since the docs are distributed in an arch:all
> package, they shouldn't need to be built on every architecture (with
> texlive, dot, graphviz tools).
> 
> It's something that usually belongs in a build-indep target, that the
> maintainer runs when uploading a new version of the package, but each of
> the buildds don't need to do it.  Also the package won't Build-Depends
> on all those documentation tools any more.
> 
> Regards,

-- 
For the one fact about the future of which we can be certain is that it
will be utterly fantastic. -- Arthur C. Clarke, 1962

Attachment: signature.asc
Description: This is a digitally signed message part

Reply via email to