Fred Drake
5af41c55e6
Correct dependency information -- the Python docs load the "About this
...
document" text from html/stdabout.dat, not html/about.dat.
2003-05-22 15:28:55 +00:00
Fred Drake
4864bfb88f
Minor elaboration in the information about reporting errors.
2003-05-22 15:09:27 +00:00
Fred Drake
6ce0b60063
update version history
2003-05-22 14:58:02 +00:00
Jeremy Hylton
e41195fab6
Add documentation for __future__
2003-05-21 21:45:01 +00:00
Jeremy Hylton
8bea5dc879
Move future statement here from appendix a.
2003-05-21 21:43:00 +00:00
Andrew M. Kuchling
28137a09d6
Don't mention __slots__ as a technique for error avoidance
2003-05-20 18:12:21 +00:00
Fred Drake
15eac1f95c
Fix markup nits.
2003-05-20 16:21:51 +00:00
Tim Peters
dbaf04ead6
Straighten out the docs for os.system(); the Unix and Windows behaviors
...
really can't be smushed together.
Bugfix candidate.
2003-05-20 16:15:58 +00:00
Fred Drake
6bab183d4e
Markup nits.
2003-05-20 15:28:58 +00:00
Fred Drake
e5a55519a8
Remove unused line numbers from example code.
...
Line numbering of examples is not used elsewhere.
2003-05-20 15:21:08 +00:00
Raymond Hettinger
f9c2eda3c1
Fix missing parethesis.
2003-05-20 05:31:16 +00:00
Brett Cannon
235d1efe12
Add docs for key_file and cert_file arguments for HTTPSConnection. Copied from socket.ssl docs.
2003-05-20 02:56:35 +00:00
Skip Montanaro
7789237331
* Correct Sniffer doc to correspond to the implementation.
...
* Add optional delimiters arg to Sniffer.sniff() which restricts the set of
candidate field delimiters.
2003-05-19 15:33:36 +00:00
Walter Dörwald
9e46abed50
Fix array.array.insert(), so that it treats negative indices as
...
being relative to the end of the array, just like list.insert() does.
This closes SF bug #739313 .
2003-05-18 03:15:10 +00:00
Raymond Hettinger
047c54bb24
Missing parenthesis.
2003-05-16 14:36:26 +00:00
Jim Fulton
1f325562f0
Added some missing PyObject* casts in the deallocators.
...
Added some defines for PyMODINIT_FUNC so that the examples work
with Python 2.2.
I think I'm done hacking this documentation. Yippie! :)
2003-05-16 13:53:43 +00:00
Jim Fulton
a24d73ddb1
Added a missing PyObject* cast to the dealloc examples.
...
Added a note that the mechanism for defining new tyoes documented here
only works for Python 2.2 and higher.
2003-05-16 13:51:58 +00:00
Jim Fulton
aea763bde7
Removed reference to the out-of-date (and not very useful)
...
Objects/xxobject.c example.
Updated the discussion of type checking to refer to
PyObject_TypeCheck.
2003-05-16 13:32:59 +00:00
Guido van Rossum
8f512a22cd
Add docs for MessageBeep.
2003-05-16 01:42:22 +00:00
Andrew M. Kuchling
7696344182
[Bug #471893 ] Replace security material with a warning against unpickling
...
untrusted data.
2003-05-14 16:51:46 +00:00
Fred Drake
126d366ea6
document Stats.dump_stats(), new for Python 2.3
2003-05-14 14:29:27 +00:00
Fred Drake
c868d16e11
When an external application we use exits normally, exit with the same
...
exit code they returned. All other types of exit from child processes
are normalized to a return code of 1.
Closes SF bug #732143 .
2003-05-14 04:16:14 +00:00
Guido van Rossum
bf1bef820c
Add optional 'onerror' argument to os.walk(), to control error
...
handling.
2003-05-13 18:01:19 +00:00
Andrew M. Kuchling
e9a54a3eaf
[Bug #713722 ] Delete dangling references to unwritten sections
2003-05-13 15:02:06 +00:00
Andrew M. Kuchling
c85bf58276
[Bug #732124 ] Clarify .pos, .endpos by saying 'method' instead of 'function'
...
Also, put match() description before search(); search() refers to match()
2003-05-13 14:40:24 +00:00
Andrew M. Kuchling
8d17709c5c
Remove more markup from headers
2003-05-13 14:26:54 +00:00
Andrew M. Kuchling
433307b75d
[Bug #729297 ] Remove markup in section headers
2003-05-13 14:23:54 +00:00
Andrew M. Kuchling
eabd9a1314
[Bug #729817 ] Document the rexec and Bastion modules as dead
2003-05-13 14:16:18 +00:00
Andrew M. Kuchling
032bd0a9a8
Fix typo
2003-05-13 14:13:58 +00:00
Brett Cannon
1213bdd16d
Fix and add reference to urllib.urlencode for parse_qsl? functions.
2003-05-13 02:50:36 +00:00
Jim Fulton
d2eadc6946
Updated simple example. This should have been checked in the other
...
day, but I missfired in CVS.
2003-05-12 17:42:56 +00:00
Fred Drake
7af9f4dac3
Add a specific mention of the term "operator overloading" and add an
...
index entry. Suggested to python-docs.
2003-05-12 13:50:11 +00:00
Raymond Hettinger
bf3a75283c
Fix minor typos.
2003-05-12 03:23:51 +00:00
Fred Drake
8f53cdcfce
- object is a class type, not a function
...
- when marking a function, the trailing () should be included
consistently
2003-05-10 19:46:39 +00:00
Raymond Hettinger
b4c1d9be8f
Fix unbalanced parethesis.
2003-05-10 08:51:28 +00:00
Raymond Hettinger
0dfd7a9361
Missing parenthesis found by texcheck.py
2003-05-10 07:40:56 +00:00
Martin v. Löwis
5467d4c0e3
Patch #612627 : Add encoding attribute to file objects, and determine
...
the terminal encoding on Windows and Unix.
2003-05-10 07:10:12 +00:00
Raymond Hettinger
eca984fcce
Fix missing parenthesis.
2003-05-10 04:21:08 +00:00
Raymond Hettinger
52136a8bea
Fixed spacing and unbalanced brackets or parenthesis.
2003-05-10 03:35:37 +00:00
Fred Drake
9f545c489a
Make this format again.
2003-05-09 19:10:12 +00:00
Skip Montanaro
a30dffbb53
add a note about accessing user-defined functions with an import statement
...
in the setup parameter
2003-05-09 18:21:02 +00:00
Fred Drake
3ec4dfd812
Make this format again.
2003-05-09 18:18:46 +00:00
Fred Drake
8b6ed26dc7
- remove bogus \end{description}
...
- fix two typos
2003-05-09 15:04:56 +00:00
Jack Jansen
1662162c04
Documented the new autoGIL module.
2003-05-09 14:45:04 +00:00
Jim Fulton
3ff5bb20b7
Fixed small typo Pointed out by Michael Hudson.
2003-05-08 10:35:07 +00:00
Jim Fulton
83cedcf660
Fixed a typo in an example dealloc routine that calls it's "self"
...
argument "obj" rather than "self".
2003-05-08 10:32:10 +00:00
Greg Ward
86e1790cad
Clarify the dedent() example a bit by indenting the input lines unevenly.
2003-05-08 02:12:35 +00:00
Greg Ward
8f6329c547
SF patch #598163 (Ville Vainio, vvainio@users.sourceforge.net):
...
document dedent() function.
2003-05-08 02:09:49 +00:00
Brett Cannon
066f3928b2
Library documentation for the 'test' package. Still needs to be checked by Fred.
2003-05-07 22:02:17 +00:00
Jim Fulton
aed0a4a138
Rewrote the basic section of the chapter on defining new types.
...
Changed the example to show how to create types the new way:
- Use a class new method rather than a new function.
- Use self->ob_type->tp_free in deallocators
- Use attribute descriptors rather than set/getattr methods.
- Make the type usable as a base type.
I split the example into 3 parts:
1. The minimal new type
2. Adding attributes and methods.
3. Finer control over attributes.
It's much simpler to define builtin types. These updates hopefully
show this.
I also made minor wording changes in two other places.
I still need to update xxobject.c
2003-05-07 19:48:13 +00:00
Raymond Hettinger
a02469f969
More message updates and minor fixes.
2003-05-07 17:49:36 +00:00
Raymond Hettinger
a2f84ceda5
Update traceback message
2003-05-07 17:11:15 +00:00
Andrew M. Kuchling
fcf6b3ecde
Add list.insert() change for negative positions
...
Add ~ to MvL's last name
Fix use of all-caps for a name
Bump version number
2003-05-07 17:00:35 +00:00
Skip Montanaro
45a9c93236
add missing parens - verified w/ interpreter - sorry to dismiss your comment
...
Fred
2003-05-07 16:01:43 +00:00
Skip Montanaro
b4f12424a5
replace most uses of `...` by repr(...), noting that `...` is discouraged,
...
but convenient in interactive sessions.
2003-05-07 15:29:12 +00:00
Skip Montanaro
6d9f45bc3f
add a note about the undocumented bsddb185 module
2003-05-06 20:40:17 +00:00
Jeremy Hylton
6cb52ddc3c
Refer reader to platform library docs for specific semantics.
...
Resolves SF bugs 697989, 697988, 697986.
2003-05-05 16:46:26 +00:00
Greg Ward
d72312857e
Scattered wording and typographical improvements (up to but not
...
including the "Callback Options" section).
2003-05-03 21:22:58 +00:00
Greg Ward
649625bc05
Rename "The Tao of Option Parsing" section to "Philosophy".
...
Remove first-person usage from it. Various wording tweaks.
2003-05-03 20:41:37 +00:00
Greg Ward
1f53517a8c
Use True/False instead of 1/0 when talking about store_true/store_false.
...
Particularly important since they now store True and False rather than 1
and 0!
2003-05-03 20:13:08 +00:00
Greg Ward
c50b088cfd
Add a big comment about cross-platform issues (especially OpenBSD).
...
This should be turned into a footnote by someone who actually
understands OSS and its relationship to Linux, FreeBSD, OpenBSD, NetBSD,
etc.
2003-05-03 19:45:47 +00:00
Greg Ward
bf8f1b55a8
Use TeX quotes -- ``foo'' -- as appropriate.
...
Remove whitespace around em-dashes.
2003-05-03 19:41:45 +00:00
Greg Ward
b4e3319302
Fix various markup errors: use \longprogramopt{} more, and use it
...
correctly. (Closes SF #731689.) Use \emph{} in a few places.
2003-05-03 19:16:36 +00:00
Martin v. Löwis
ec31047c0c
Use \versionchanged, not \versionadded.
2003-05-03 10:59:13 +00:00
Martin v. Löwis
7829e5661c
Patch #731514 : Update recursion documentation to mention simple recursion.
2003-05-03 10:57:53 +00:00
Martin v. Löwis
e59e2bab8f
Patch #711902 : Cause pydoc to show data descriptor __doc__ strings.
2003-05-03 09:09:02 +00:00
Fred Drake
8b34e7cc40
- add title attributes to the navigation icons on the navigation bars;
...
this causes some browsers to offer descriptive tooltips when the
mouse hovers over the linked icon
- clean up the code in this area
2003-05-03 02:07:22 +00:00
Fred Drake
05404c3d7c
add link types for the remaining links in the navigation panels
2003-05-02 20:30:18 +00:00
Fred Drake
bf8ec3e035
- add link relationships to some of the links in the navigation panels
...
- implement custom_REL_hook() so LaTeX2HTML uses currently recommended
link types; those work fine with tools like the Mozilla Site
Navigation Bar
2003-05-02 20:18:01 +00:00
Raymond Hettinger
341deb74e7
The previous made the stop argument optional.
...
It is better to be explicit and just allow stop to be None.
2003-05-02 19:44:20 +00:00
Raymond Hettinger
14ef54cd83
SF bug #730685 : itertools.islice stop argument is not optional
...
* itertools.islice() stop argument did not perform as documented.
* beefed-up test suite
2003-05-02 19:04:37 +00:00
Fred Drake
98b2576424
Avoid extraneous blank line generated in the middle of the document
...
head.
2003-05-02 18:21:22 +00:00
Fred Drake
f06b90534b
Remove section number from the title for use in the
...
<meta name='description' ...> element in the document head.
2003-05-02 18:08:16 +00:00
Fred Drake
90fc0b356f
At the site of an indexed reference to print, point to the relevant
...
documentation. Closes SF bug #723136 .
2003-04-30 16:44:36 +00:00
Fred Drake
b876bcc561
work around mostly-minor formatting problems; the encodings.idna
...
example still doesn't come out quite right: a bug in the formatting
tools
2003-04-30 15:03:46 +00:00
Fred Drake
d4be747e1e
- comment out \moduleauthor that broke formatting until the formatting
...
tools can be fixed; added XXX comment
- general markup fixes
2003-04-30 15:02:07 +00:00
Fred Drake
c95628e3f2
- clean up some extra punctuation hidden in indexing markup
...
- fix a typo and one markup nit
- normalize whitespace
2003-04-29 13:56:40 +00:00
Fred Drake
83c19ee06b
Clarify that the timeout argument to read_until() is in seconds.
2003-04-29 13:39:05 +00:00
Raymond Hettinger
6e887bb05f
SF bug #729096 : getopt online documentation example improvement
...
A newbie found it difficult to translate the exampe into a
case that used only short options or long options but not both.
He tried to shorten the tuple search but forgot the trailing comma,
The appropriate pattern is an equality check.
Revised the example to point him in the right direction.
Backport candidate.
2003-04-29 04:35:36 +00:00
Brett Cannon
a2f8737faf
Add comment that urlopen opens local files without universal newlines
2003-04-29 04:11:12 +00:00
Tim Peters
a1af767c4d
Reworded fabs() for consistency with the others. Noted that all
...
return values are floats.
2003-04-28 21:32:03 +00:00
Tim Peters
a390c6e194
walk() docs: Emphasize that the recursive-delete example is dangerous.
2003-04-28 19:15:10 +00:00
Tim Peters
5501b5e3d7
SF bug 728097: tmpnam problems on windows 2.3b, breaks test.test_os.
...
tmpnam() appears essentially useless on Windows, and it finally broke
the test for Irmen de Jong. Read the long new comment in test_tmpnam()
for details. Since the MS implementation is insane, it might be good
if we supplied a different implementation.
Bugfix candidate.
2003-04-28 03:13:03 +00:00
Tim Peters
bf89b3a1f7
walk() docs: Worked "walking" into the description and the text. Added
...
a brief example where bottom-up walking is essential.
2003-04-28 02:09:43 +00:00
Tim Peters
965697fc4b
Clarified new text about math exceptions.
...
Bugfix candidate.
2003-04-26 15:11:08 +00:00
Skip Montanaro
5118341530
Add note about platform-specific behavior arising from discussion on bug
...
711019.
2003-04-26 02:59:00 +00:00
Fred Drake
2f36b3e205
Version updates for Python 2.3.
2003-04-26 00:52:30 +00:00
Fred Drake
9635268ea9
organizational and markup cleansing
2003-04-25 18:02:34 +00:00
Fred Drake
c440af5495
Updated information on package metadata to reflect recent additions.
...
This is a modified form of SF patch #718027 (mostly markup changes).
2003-04-25 16:43:28 +00:00
Fred Drake
d198f38505
- add availability statements for some of the new APIs
...
- lots of general cleanup
2003-04-25 16:16:02 +00:00
Fred Drake
53e5b71bbc
Add modified versions of the examples from Sean Reifschneider
...
(SF patch #545480 ).
2003-04-25 15:27:33 +00:00
Guido van Rossum
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
Skip Montanaro
5d0136e297
reflect csv's change back to a module. Document the new sniffer api.
2003-04-25 15:14:49 +00:00
Fred Drake
9f48045ec0
Use a simpler \note instead of a "See also" section to refer to the
...
os.walk() generator.
2003-04-25 15:12:47 +00:00
Neal Norwitz
6eb502f267
Add versionadded for has_ipv6 attribute
2003-04-25 14:53:48 +00:00
Neal Norwitz
cabf56f8b4
Fix markup
2003-04-25 14:52:41 +00:00
Fred Drake
2194a4eede
markup adjustments
2003-04-25 14:50:06 +00:00
Tim Peters
c4e0940042
New generator os.walk() does a bit more than os.path.walk() does, and
...
seems much easier to use. Code, docs, NEWS, and additions to test_os.py
(testing this sucker is a bitch!).
2003-04-25 07:11:48 +00:00
Guido van Rossum
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
Andrew M. Kuchling
f8d0c075b2
[Patch #628208 ] Document the allow_none argument
2003-04-25 00:29:31 +00:00