Issue1791

One of the users pointed out (issues 1788) that the socket module documentation refers to 2.6 features that don't yet exist.

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

Presumably this is not the 2.5 version of the documentation?

Essentially the same issue reported as #1590 and #1650.

The Python 2.6 documentation has been used for the Jython 2.5.x docs since they are available in Sphinx format.  There are bits and pieces that still pertain to 2.6 and it is a matter of clean-up.  Thanks for the catch.

Josh, now that we're moving to 2.7, we need to be able to update these documents.

Where are they repo'ed?

The documentation is stored on Sourceforge.

http://sourceforge.net/projects/jythondocs/

Thanks, and let me know if you have any questions.

OK, so it's a HG repo on sourceforge. It would be nice if we could get it into the HG repo on python.org.

I notice that there is no changelog there.

http://jythondocs.hg.sourceforge.net/hgweb/jythondocs/jythondocs/log

Josh, Frank, should we be moving this to hg.python.org?

I suppose keeping it separate has the benefit of being able to give permissions to the docs without giving permissions to code repo?

Otherwise I can't think of a reason why they should be in separate repos.

Sounds good to me...I can move it to python.org if you like.  I moved the website there last week, so it makes sense to have it all in one place.

There is no change log because I have not make any changes to the docs, unfortunately, since they have been committed.

Thanks Alan

My primary intention for the docs is to add links to jython specific documentation. For example, on the doc page for the socket module, I'd add a link to the wiki page, which acts as a sort of "release notes" page for jython sockets.

http://wiki.python.org/jython/NewSocketModule

Adding links, where needed, sounds like a good idea.  It may make sense to start over with the 2.7 Python docs and modify accordingly, adding Jython-specific content and getting rid of that content that is specific to CPython.  Should be easy enough to apply the current 2.5 docset template to the CPython 2.7 docs and go from there.

We should move this to hg.python.org - probably under hg.python.org/jython-docs/ and (sort of unrelated) I need to find out why Josh had trouble creating jython-website.

Duplicate of #1590