[issue1732367] Document the constants in the socket module

Ammar Askar added the comment: That makes sense, listing availability for exceptions would certainly make everything more succinct. How do you propose we mention that certain options don't actually do anything on Windows. Currently I have a footnote in the table that links to the MSDN

[issue1732367] Document the constants in the socket module

Martin Panter added the comment: The general rule for documenting availability seems to be to only list the special cases. Many of the socket options are specified by Posix, and seem to be available on Linux, Windows, BSD and other OSes. If you say “Availability: Linux, Windows”, it could

[issue1732367] Document the constants in the socket module

Martin Panter added the comment: Issue 13256 contains a patch documenting socket options, but was closed because the author lost interest. Issue 27409 is a proposal to list the symbols available without documenting what each one is for. -- dependencies: +Document and test new socket

[issue1732367] Document the constants in the socket module

Ammar Askar added the comment: I've opened up a PR for this ticket's dependencies. There's some things I'm looking for feedback on there: https://github.com/python/cpython/pull/3072 -- ___ Python tracker

[issue1732367] Document the constants in the socket module

Ammar Askar added the comment: Gonna take this and its dependencies on, eta 2-4 days. -- nosy: +ammar2 ___ Python tracker ___

[issue1732367] Document the constants in the socket module

Changes by Ned Deily : -- assignee: georg.brandl -> versions: +Python 3.7 -Python 2.6 ___ Python tracker ___

[issue1732367] Document the constants in the socket module

Changes by Martin Panter : -- dependencies: +Document socket.SOL_SOCKET ___ Python tracker ___

[issue1732367] Document the constants in the socket module

Martin Panter added the comment: Issue 12887 is open to add explanations of the SO_* constants -- dependencies: +Documenting all SO_* constants in socket module ___ Python tracker

[issue1732367] Document the constants in the socket module

Changes by Mark Lawrence : -- nosy: -BreamoreBoy ___ Python tracker ___ ___

[issue1732367] Document the constants in the socket module

Martin Panter added the comment: Reopening because the consensus seems to be to update and apply this sort of change. -- nosy: +martin.panter stage: -> needs patch status: closed -> open ___ Python tracker

[issue1732367] Document the constants in the socket module

Mark Lawrence breamore...@yahoo.co.uk added the comment: msg67121 states proposed changes were lost :( -- nosy: +BreamoreBoy resolution: - wont fix status: open - closed ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue1732367

[issue1732367] Document the constants in the socket module

R. David Murray rdmur...@bitdance.com added the comment: Resolution won't fix is inappropriate. We'd love to fix it, but someone has to volunteer to (re)write the doc update... -- nosy: +r.david.murray resolution: wont fix - type: - feature request

[issue1732367] Document the constants in the socket module

Björn Lindqvist [EMAIL PROTECTED] added the comment: There is no progress on this. I had lots of documentation written in Latex on a laptop, but then I lost it. Sorry. -- nosy: +bjourne _ Tracker [EMAIL PROTECTED] http://bugs.python.org/issue1732367

[issue1732367] Document the constants in the socket module

Georg Brandl [EMAIL PROTECTED] added the comment: Is there progress on this? _ Tracker [EMAIL PROTECTED] http://bugs.python.org/issue1732367 _ ___ Python-bugs-list mailing list

[issue1732367] Document the constants in the socket module

Changes by Christian Heimes: -- assignee: - georg.brandl versions: +Python 2.6 _ Tracker [EMAIL PROTECTED] http://bugs.python.org/issue1732367 _ ___ Python-bugs-list

[issue1732367] Document the constants in the socket module

Georg Brandl added the comment: Be sure to use reST format now that we've switched to that. Much easier to type :) _ Tracker [EMAIL PROTECTED] http://bugs.python.org/issue1732367 _