1.2 release update

[Richard Jones]

Just so you're aware, I'm currently working towards:

- release the 1.2 alpha 1 source dist
- release the docs to the website

Thanks Txema and Winston for the work on the docs! I've made a few
more tweaks. In order to achieve the docs release I just need to
structure things so the 1.2 docs don't nuke those for the 1.1 release.
I also need to go back through the commit logs to create the change
log.

Also it'd be good to prune some of the OpenGL leaves from the API
docs. In a future version.


Richard

[anatoly techtonik]

Good news. I've moved the website generation script from tools/ to website/ so that people could discover it more quickly and changed comments to progress messages here.
http://code.google.com/r/techtonik-scaffoldings/source/detail?r=0e6014c232d6450f8dcfd069aececca2cdc386cb

Feel free to:
hg pull https://code.google.com/r/techtonik-scaffoldings/

[Richard Jones]

Could you please update that to match my latest push to the main repos? Thanks!


Richard

[anatoly techtonik]

Rebased and uploaded to:
https://code.google.com/r/techtonik-pyglet-site/

I didn't notice any changes though.

[Txema Vicente]

Hi.

- The Testing Framework is not documented now because you need the
autosummary directive to generate api/tests.test.txt. (like pyglet.txt does)

> Also it'd be good to prune some of the OpenGL leaves from the API
> docs. In a future version.

I intentionally left those there, so if you search "glMultMatrixd" it is
found somewhere.
(I was even planning to include links to
http://www.opengl.org/sdk/docs/man/ )

But if the page is too long, a simple tweak in conf.py skip_member will
prune easily.
>
> Richard
>

[Richard Jones]

On 24 June 2012 19:58, Txema Vicente <tx...@nabla.net> wrote:
> - The Testing Framework is not documented now because you need the
> autosummary directive to generate api/tests.test.txt. (like pyglet.txt does)

Ah, darn, sorry! There's some other strangenesses going on with the
api doc generation as well (I have "doc/api/api/..." which is
definitely not right.) I've started fixing that, as well as my
breaking of api/tests.test.txt, but then I had to go off and fix
testpypi.python.org and that's kinda done me for the night. I'll have
another crack at the docs etc. tomorrow.

>> Also it'd be good to prune some of the OpenGL leaves from the API
>> docs. In a future version.
>
> I intentionally left those there, so if you search "glMultMatrixd" it is
> found somewhere.
> (I was even planning to include links to http://www.opengl.org/sdk/docs/man/
> )
>
> But if the page is too long, a simple tweak in conf.py skip_member will
> prune easily.

I think my re-adding of the "Defined" section (by choosing the
"module.rst" template over the "package.rst") was a bad idea. It ends
up including a whole lot of symbols that offer almost no value to the
API doc reader.


Richard