Issue1590

It looks like the Jython docs contain the Python 2.6 stdlib refernece, for example:

http://www.jython.org/docs/library/ssl.html

This was confusing a user on IRC who was wondering (a) where the ssl module was and (b) where Jython 2.6 was.

It seems like it would be a better idea to include the Python library docs for 2.5 instead.

I agree and I am currently in the progress of removing all 2.6 references.  The documentation set was taken from Python 2.6 and I've been slowly removing references as to back port the set to 2.5 with libs Jython currently makes available.  Unfortunately, I've been sidetracked lately and this has been put on hold slightly.  I will do my best to get this resolved by removing all 2.6 references that Jython does not contain as soon as possible.

As a side note, the reason we started with Python 2.6 was that it was in restructured text, which most of us are more comfortable with than latex. This is especially true after writing the book. But using RST comes at a cost of backporting to 2.5.

At this point Jython 2.7 does in fact support ssl and other 2.6 functionality. But we still need to update these docs.

We should really stop pretending the latest is 2.5.1 :)
http://www.jython.org/currentdocs.html

THe current website now points to CPython 2.7 documentation, which ought to be a good, and only occasionally disappointing, reference for Jython. It is what I use when coding.

Unless I'm missing some way to make it automatic, we can't afford to maintain a Jython re-write. There is scope for a document that explains the differences. This need is served fairly well by the Jython Book, which we might have the capacity to maintain.

I propose we consider the gross problem cited to be fixed.