pyopengl-users

[PyOpenGL-Users] Re: [PyOpenGL-Devel] How to make documentation?

[Mike C. F. <mcf...@ro...>]

If I'm not mistaken, Tarn was using the DocBook DTD, here's his comments 
from an old email... the build process has apparently formalised 
somewhat since then:

> It is possible to generate your own copy of the docs sent out with the
> distribution.  To do so you need Saxon and DocBook XSL.  Its probably not
> worth it though since the dist includes HTML and PDF pregenerated.
> 
> Right now I am the only one who can build the new docs, mostly because I
> haven't formalized the build process.  It's also slow as hell.  Takes about
> an hour to generate the docs for the website. 

I've never done it myself since this new system came into use.  I'm 
assuming that with those two pieces installed (Saxon is an XSL 
processor, if I'm recalling correctly) and configured in the environment 
the process should just go ahead and run. (But may take an hour, as 
noted above).

HTH,
Mike

Rene Dudfield wrote:
> Hello.
> 
> "python setup.py build_doc" gives me a message:
> 
> warning: build_doc: Can't generate docs because
> SAXON_HOME, DOCBOOK_XSL_HOME, WEBEQ_HOME or
> warning: build_doc: RESOLVER_HOME environment variable
> is not set.  Will just use existing docs.
> 
> 
> How do I set up the necessary programs?
> 
> any help appreciated :)
> 
> __________________________________________________
> Do You Yahoo!?
> Everything you'll ever need on one web page
> from News and Sport to Email and Music Charts
> http://uk.my.yahoo.com
> 
> 
> -------------------------------------------------------
> This sf.net email is sponsored by:ThinkGeek
> No, I will not fix your computer.
> http://thinkgeek.com/sf
> _______________________________________________
> PyOpenGL Homepage
> http://pyopengl.sourceforge.net
> _______________________________________________
> PyOpenGL-Devel mailing list
> PyO...@li...
> https://lists.sourceforge.net/lists/listinfo/pyopengl-devel
> 


-- 
_______________________________________
   Mike C. Fletcher
   http://members.rogers.com/mcfletch/

Re: [PyOpenGL-Users] How to make documentation?

[<il...@ya...>]

 --- "Mike C. Fletcher" <mcf...@ro...> wrote: >
If I'm not mistaken, Tarn was using the DocBook DTD,
> here's his comments 
> from an old email... the build process has
> apparently formalised 
> somewhat since then:
> 
> > It is possible to generate your own copy of the
> docs sent out with the
> > distribution.  To do so you need Saxon and DocBook
> XSL.  Its probably not
> > worth it though since the dist includes HTML and
> PDF pregenerated.
> > 
> > Right now I am the only one who can build the new
> docs, mostly because I
> > haven't formalized the build process.  It's also
> slow as hell.  Takes about
> > an hour to generate the docs for the website. 
> 
> I've never done it myself since this new system came
> into use.  I'm 
> assuming that with those two pieces installed (Saxon
> is an XSL 
> processor, if I'm recalling correctly) and
> configured in the environment 
> the process should just go ahead and run. (But may
> take an hour, as 
> noted above).
> 


Thanks for the info, I'll look into those packages and
try and figure it out.



__________________________________________________
Do You Yahoo!?
Everything you'll ever need on one web page
from News and Sport to Email and Music Charts
http://uk.my.yahoo.com