175d18840a
avoid backticks in examples; use repr() instead
2004-06-03 16:23:23 +00:00
cee8879a7d
note that the error code for socket.gaierror will be one of the EAI_*
...
constants
(closes SF bug #837929 )
2004-05-05 04:18:11 +00:00
ba813e2089
#928751 , fix typos in socket doc
2004-04-03 18:02:37 +00:00
fcc51767bd
update signature of the socket constructor
...
(could someone backport this to Python 2.3.x please?)
2004-01-27 18:21:26 +00:00
5a92175fbc
After hearing from someone who gave up on timeout sockets due to a
...
mistake in his code, I'm adding a note explaining that you should call
settimeout() before connect().
2003-12-13 22:12:53 +00:00
94681fc4a3
Patch #849595 : Add socket.shutdown() constants.
2003-11-27 19:40:22 +00:00
b278ac4e46
Add note about fileno not being usable as a normal file descriptor in Windows.
2003-08-05 03:51:24 +00:00
476fcae4d7
SF bug #774411 : Typo in socket documentation
2003-07-20 01:10:15 +00:00
be2528d866
SF patch #760257 : add socket.timeout exception
...
(Contributed by Bob Halley)
Add documentation for the new socket.timeout exception.
2003-06-29 04:55:59 +00:00
3a03de4a27
SF #757229 , fix libsocket.tex typo
2003-06-20 17:11:39 +00:00
d198f38505
- add availability statements for some of the new APIs
...
- lots of general cleanup
2003-04-25 16:16:02 +00:00
b016752d8b
Fix a copy-paste error: the paragraph about inet_ntop's use was copied
...
literally from inet_pton.
2003-04-25 15:26:58 +00:00
6eb502f267
Add versionadded for has_ipv6 attribute
2003-04-25 14:53:48 +00:00
47dfa4a89a
Patch by Jp Calderone:
...
- The socket module now provides the functions inet_pton and inet_ntop
for converting between string and packed representation of IP addresses.
See SF patch #658327 .
This still needs a bit of work in the doc area, because it is not
available on all platforms (especially not on Windows).
2003-04-25 05:48:32 +00:00
2a403e8a7e
add descriptions of {get,set}defaulttimeout.
2003-03-20 17:58:12 +00:00
11ba094957
Major overhaul of timeout sockets:
...
- setblocking(0) and settimeout(0) are now equivalent, and ditto for
setblocking(1) and settimeout(None).
- Don't raise an exception from internal_select(); let the final call
report the error (this means you will get an EAGAIN error instead of
an ETIMEDOUT error -- I don't care).
- Move the select to inside the Py_{BEGIN,END}_ALLOW_THREADS brackets,
so other theads can run (this was a bug in the original code).
- Redid the retry logic in connect() and connect_ex() to avoid masking
errors. This probably doesn't work for Windows yet; I'll fix that
next. It may also fail on other platforms, depending on what
retrying a connect does; I need help with this.
- Get rid of the retry logic in accept(). I don't think it was needed
at all. But I may be wrong.
2002-06-13 15:07:44 +00:00
715b861d94
Clarify the interaction between timeout/non-blocking mode, makefile
...
and fromfd.
2002-06-07 12:38:23 +00:00
62a7f63a24
Fix typo
2002-06-07 12:36:44 +00:00
fc9823b1a9
Clarify the interaction between blocking and timeouts. Explain that
...
fromfd() assumes a blocking non-timeout socket.
2002-06-07 03:39:21 +00:00
bdbd84fdac
Add version info, and fix another typo and wording spotted by /F. I think this is what he meant. :-)
2002-06-06 22:24:10 +00:00
1a06fb0605
Fix typo spotted by Fredrik Lundh.
2002-06-06 22:19:20 +00:00
6c6d662760
Fix some markup errors and adjust wording slightly.
2002-06-06 21:57:48 +00:00
be946bfea7
SF patch 555085 (timeout socket implementation) by Michael Gilfix.
...
I've made considerable changes to Michael's code, specifically to use
the select() system call directly and to store the timeout as a C
double instead of a Python object; internally, -1.0 (or anything
negative) represents the None from the API.
I'm not 100% sure that all corner cases are covered correctly, so
please keep an eye on this. Next I'm going to try it Windows before
Tim complains.
No way is this a bugfix candidate. :-)
2002-06-06 21:51:01 +00:00
39960f6ec9
Fix the erroneous availability annotation for s.makefile() from the last
...
checkin (my fault!).
Wrap some long lines and fix some markup inconsistencies.
2001-12-22 19:07:58 +00:00
87fa3aa12c
Add notes that fromfd() and s.makefile() are Unix-specific.
...
This fixes SF bug #495896 .
Fix up various markup consistency & style guide conformance nits.
2001-12-21 17:45:03 +00:00
39368c1053
Added documentation of the sendall() method, and a note to the send() method
...
that it does not guarantee that all data is sent.
This closes SF patch #474307 .
2001-12-05 05:25:59 +00:00
0aa811c527
Use the \note and \warning macros where appropriate.
2001-10-20 04:24:09 +00:00
aad8bb5d7a
When stating that some parameters to makefile() are similar to the open()
...
parameters, given a hyperlink to the right part of the documentation to
make it easier to look those up. Also, refer to the file() function/
constructor instead of open() now that that is where the actual docs for
those parameters live.
This closes SF bug #472004 .
2001-10-19 17:22:29 +00:00
cb43c085e2
Document that keyfile and certfile are now optional.
...
XXX Forgot to mention this in the last socketmodule.c checkin.
2001-10-11 16:17:22 +00:00
3fc291a1d7
Fix some markup errors.
2001-09-27 04:17:20 +00:00
9081bb1d21
Added documentation for the SSL interface, contributed by Gerhard Häring.
...
This closes SF patch #461337 .
2001-09-25 15:48:11 +00:00
c9908c4f5c
Document IPv6 changes. Contributed by itojun.
2001-08-04 22:22:45 +00:00
8321026ff4
SourceForge patch #103140 , checked in at fdrake's invitation. Minor fixes and
...
additions to library docs.#
2001-01-10 19:34:52 +00:00
ef52f601ed
Revise the examples not to use the "from socket import *", and adjust
...
one comment in the example for clarity.
2000-10-10 20:36:29 +00:00
8b2e8f846c
Added a \versionadded statement to the getfqdn() description.
2000-09-06 02:22:16 +00:00
5772c86816
Document socket.getfqdn().
2000-08-16 14:21:42 +00:00
caa658d047
Apply SF patch #101151 , by Peter S-K, which fixes smtplib's passing of the
...
'helo' and 'ehlo' message, and exports the 'make_fqdn' function. This
function should be moved to socket.py, if that module ever gets a Python
wrapper.
2000-08-15 19:30:36 +00:00
aa7524cf1f
Clean up markup to be more like recommended practice; only small changes
...
needed.
2000-07-06 18:37:08 +00:00
9a748aa832
Say "manual page", not "man page", when referring to the Unix manual.
2000-06-30 04:21:41 +00:00
3d69c0e440
Someone found the examples of poor practice on socket addresses!
...
Spotted by Greg Kochanski <gpk@bell-labs.com>.
2000-05-03 19:40:32 +00:00
7d68690d8d
Added notes about the eventual disappearance of two-parameter bind(),
...
connect(), and connect_ex().
I didn't make these deprecation notices since it was never a
documented feature.
2000-04-04 17:48:30 +00:00
38e5d27cae
Merged changes from the 1.5.2p2 release.
...
(Very rough.)
2000-04-03 20:13:55 +00:00
37f1574f2e
Use \citetitle and \programopt as appropriate.
1999-11-10 16:21:37 +00:00
e6fb1c4bd3
Added documentation for inet_aton() and inet_ntoa(), from Ben
...
Gertzfield <che@debian.org> (with minor changes).
(Should have been here instead of in the branch in the first place,
since these weren't in for the 1.5.2 release.)
1999-09-16 15:50:00 +00:00
a94f6762bc
Add index entry "I/O control, buffering" for makefile().
1999-08-05 13:41:04 +00:00
b0bc7f2d6c
Updated connect_ex() documentation based on comments in the newgroup
...
(M.-A. Lemburg and GvR).
1999-05-06 22:03:50 +00:00
318c0b131f
Logical markup nits.
...
Make references to other modules hyperlinks.
1999-04-21 17:29:14 +00:00
295da24eaf
New section header style.
...
Fix up a few synopses.
1998-08-10 19:42:37 +00:00
cdf6af1233
Document gethostbyname_ex().
1998-08-07 18:07:36 +00:00
b91e934cf1
Adjusted to use the new module synopsis support macros.
1998-07-23 17:59:49 +00:00
Fred Drake
Neal Norwitz
Guido van Rossum
Martin v. Löwis
Brett Cannon
Raymond Hettinger
Skip Montanaro
Jeremy Hylton
Eric S. Raymond
Thomas Wouters