pyopengl-users

RE: [PyOpenGL-Users] PyOpenGL Documentation, Ports & Future Features

[Tarn W. B. <twb...@ma...>]

|
| On Mon, 24 Sep 2001 07:32, Tarn Weisner Burton wrote:
| > man2dbk is far from complete, but it is complete enough for the more
| > immediate task of converting the GL, GL, GLUT and GLE manpages.
|  I've done
| > this and the results are now in the "reference" section of the manual.
|
| The content there doesn't appear to have changed - does that mean
| the output
| is identical to the old generated HTML, or is something between
| me and there
| caching the pages where it shouldn't be?
|

The "User's Manual" with integrated manpages at
http://pyopengl.sf.net/documentation/manual has actually had the manpages
for about two weeks, I just hadn't announced it.

For the docs sent out with the distribution see <site-packages>/OpenGL/doc

|
| > 1) integrated manpages
|
| As a quick note on directions I'd like to see... this is #1! I'm
| using the
| man page HTML on the sf.net site as a constant reference. I
| should pull my
| finger out and generate a local copy :)
|

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.

| > Note that the Mac port is currently stalled since
| > PyOpenGL setup requires the ability to compile executables, not just
| > dynamic/static libs.  I've talked to a few people about this
| but I haven't
| > heard any word about progress yet.  Fixing this involves adding some
| > capabilities to distutils.mwerkscompiler.  I can provide more details to
| > anyone who is interested.
|
| Hrm - I'm doing a fair bit of OS X / Python work these days, and
| I could give
| the source a try out at work. I use only the utilities
| distributed with OS X
| - gcc, the apple Project Builder etc. I can't develop for OS 9 or earlier.
|

Feel free to look at it.  I believe that the config file you will need to
create is "config/darwin"  Does OSX use mac line endings? Anyways there's a
dist with mac line endings at http://pyopengl.sf.net/ftp/

You're probably going to need the latest CVS of distutils since there have
been some Mac changes recently.

thanks,
Tarn

RE: [PyOpenGL-Users] PyOpenGL Documentation, Ports & Future Features

[Tarn W. B. <twb...@ma...>]

| I think Richard was referring to the links from the documentation page to
| "GL", "GLU", "GLUT", and "GLE", which up to a few minutes ago
| were pointing
| at my old proof-of-concept conversions of the man pages.  They
| now point to
| your XML-generated manual sections.  Note, however, that save for the GLE
| docs, none of the Python sections is currently showing up in IE 5.5,
| possibly a style sheet problem (your test document for adding the sections
| originally showed up with the Python section as I recall)?

Looks fine to me.  Most of the Python sections just haven't been written.
GLE is done
but only a few GL pages are done.

Tarn

RE: [PyOpenGL-Users] PyOpenGL Documentation, Ports & Future Features

[Tarn W. B. <twb...@ma...>]

| Unfortunately, the TOC loads ok, but sub-pages crash Konqueror 
| (2.2.1). I'll 
| look into that tomorrow night.

I'll look at that.

| ps. I just got moderation notes for the mailing list. Is it not 
| intended for 
| general discussion like this?

Yep.  I was just tweaking some spam settings.  Should work fine now.

Tarn

RE: [PyOpenGL-Users] PyOpenGL Documentation, Ports & Future Features

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

I think Richard was referring to the links from the documentation page to
"GL", "GLU", "GLUT", and "GLE", which up to a few minutes ago were pointing
at my old proof-of-concept conversions of the man pages.  They now point to
your XML-generated manual sections.  Note, however, that save for the GLE
docs, none of the Python sections is currently showing up in IE 5.5,
possibly a style sheet problem (your test document for adding the sections
originally showed up with the Python section as I recall)?

Sorry for the delay in updating the site there,
Mike

-----Original Message-----
From: pyo...@li...
[mailto:pyo...@li...]On Behalf Of Tarn
Weisner Burton
Sent: September 24, 2001 07:51
To: pyo...@li...
Subject: RE: [PyOpenGL-Users] PyOpenGL Documentation, Ports & Future
Features


|
| On Mon, 24 Sep 2001 07:32, Tarn Weisner Burton wrote:
| > man2dbk is far from complete, but it is complete enough for the more
| > immediate task of converting the GL, GL, GLUT and GLE manpages.
|  I've done
| > this and the results are now in the "reference" section of the manual.
|
| The content there doesn't appear to have changed - does that mean
| the output
| is identical to the old generated HTML, or is something between
| me and there
| caching the pages where it shouldn't be?
|

The "User's Manual" with integrated manpages at
http://pyopengl.sf.net/documentation/manual has actually had the manpages
for about two weeks, I just hadn't announced it.

For the docs sent out with the distribution see <site-packages>/OpenGL/doc
...