-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
On Sep 21, 2008, at 6:03 AM, Georg Brandl wrote:
Barry Warsaw schrieb:
Martin points out that in the past, as part of the release process,
we've built separate downloadable documentation.
Do we still want to do that for Python 2.6 and 3.0, and if so, how do
we go about doing that? I have this feeling that building the
documentation is much different now than in the past, and I don't
really have a good feel for how it's done now.
If you think we should release separate downloadable documentation
and
can help integrate that into the release project, you just might be a
Documentation Expert <wink>. Please let me know if you can help.
There is almost everything ready for doing this. There is a "download"
page in the HTML docs (that at the moment contains nothing).
If you tell me where the downloadable files will be on python.org, I
can
add them to the "download" page and you only need to build the docs
and
put them in that location. I've just added a "dist" target to the Doc/
Makefile, so a "make dist" should place all needed files in the Doc/
dist
directory, from where you can copy them to the desired location.
Benjamin has hacked on the release.py script to build and sign the
documentation. I haven't tried it yet but it looks like it does a
'make html' and exports that.
Given the above, we should change that to 'make dist' and update the
PEP to describe scp'ing them to dinsdale:/ftp/python/doc/X.Y using the
templates on this page: http://docs.python.org/download.html
I notice that for 2.5, we zip'd and tar-bz2'd them. Do we want to
also support tgz? We'll have to hack the release script to build the
doc zips. I'll try to test drive this whole process soon.
Thanks!
- -Barry
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (Darwin)
iQCVAwUBSNYvAXEjvBPtnXfVAQKj/QQApu2YzQLZfpazIb6jPxtWDMnpW99+TrRP
miMEwURQmncYWIK1kt9RuBpjszjKKw5x/pP9DEy7Slx+AQq13q1U2Ddi8yQmvWGk
Sf3rRxBbgG8QM5H67toB/T6kDtti8C0F0OZZFZpG83nAVZuwtomw7ZYZS2P5Qzq+
eZnW5aANX4g=
=HF5j
-----END PGP SIGNATURE-----
_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe:
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com