6d9f45bc3f
add a note about the undocumented bsddb185 module
2003-05-06 20:40:17 +00:00
6cb52ddc3c
Refer reader to platform library docs for specific semantics.
...
Resolves SF bugs 697989, 697988, 697986.
2003-05-05 16:46:26 +00:00
d72312857e
Scattered wording and typographical improvements (up to but not
...
including the "Callback Options" section).
2003-05-03 21:22:58 +00:00
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
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
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
bf8f1b55a8
Use TeX quotes -- ``foo'' -- as appropriate.
...
Remove whitespace around em-dashes.
2003-05-03 19:41:45 +00:00
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
ec31047c0c
Use \versionchanged, not \versionadded.
2003-05-03 10:59:13 +00:00
7829e5661c
Patch #731514 : Update recursion documentation to mention simple recursion.
2003-05-03 10:57:53 +00:00
e59e2bab8f
Patch #711902 : Cause pydoc to show data descriptor __doc__ strings.
2003-05-03 09:09:02 +00:00
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
05404c3d7c
add link types for the remaining links in the navigation panels
2003-05-02 20:30:18 +00:00
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
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
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
98b2576424
Avoid extraneous blank line generated in the middle of the document
...
head.
2003-05-02 18:21:22 +00:00
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
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
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
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
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
83c19ee06b
Clarify that the timeout argument to read_until() is in seconds.
2003-04-29 13:39:05 +00:00
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
a2f8737faf
Add comment that urlopen opens local files without universal newlines
2003-04-29 04:11:12 +00:00
a1af767c4d
Reworded fabs() for consistency with the others. Noted that all
...
return values are floats.
2003-04-28 21:32:03 +00:00
a390c6e194
walk() docs: Emphasize that the recursive-delete example is dangerous.
2003-04-28 19:15:10 +00:00
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
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
965697fc4b
Clarified new text about math exceptions.
...
Bugfix candidate.
2003-04-26 15:11:08 +00:00
5118341530
Add note about platform-specific behavior arising from discussion on bug
...
711019.
2003-04-26 02:59:00 +00:00
2f36b3e205
Version updates for Python 2.3.
2003-04-26 00:52:30 +00:00
9635268ea9
organizational and markup cleansing
2003-04-25 18:02:34 +00:00
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
d198f38505
- add availability statements for some of the new APIs
...
- lots of general cleanup
2003-04-25 16:16:02 +00:00
53e5b71bbc
Add modified versions of the examples from Sean Reifschneider
...
(SF patch #545480 ).
2003-04-25 15:27:33 +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
5d0136e297
reflect csv's change back to a module. Document the new sniffer api.
2003-04-25 15:14:49 +00:00
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
6eb502f267
Add versionadded for has_ipv6 attribute
2003-04-25 14:53:48 +00:00
cabf56f8b4
Fix markup
2003-04-25 14:52:41 +00:00
2194a4eede
markup adjustments
2003-04-25 14:50:06 +00:00
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
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
f8d0c075b2
[Patch #628208 ] Document the allow_none argument
2003-04-25 00:29:31 +00:00
3bd3c8403a
* minor tweaks relating to the package nature of the beast
...
* added an (incomplete) description of the utils.Sniffer class
2003-04-24 18:47:31 +00:00
50889239c3
Updated a bunch of docs to describe how message ids and strings are
...
Unicode in GNUTranslations. Also provide better descriptions of
*gettext() overridden methods, esp. w.r.t. the behavior in the face of
fallbacks.
2003-04-24 18:14:49 +00:00
035272be91
Add some more items
2003-04-24 16:38:20 +00:00
c11076e0da
Bump the release information.
2003-04-24 16:37:21 +00:00
d859d470a1
Add cross-references between urllib.urlencode() and cgi.parse_qs[l]().
...
Closes SF bug #724751 .
2003-04-24 16:22:47 +00:00
024aaa1bfe
SF Patch 549151: urllib2 POSTs on redirect
...
(contributed by John J Lee)
2003-04-24 15:32:12 +00:00
1d5854fdc4
Note the platform module.
2003-04-24 15:24:46 +00:00
13b4c41748
Mention deprecation of rotor module
2003-04-24 13:23:43 +00:00
bbb9a55327
[Patch #679505 ] Document that this module is deprecated
2003-04-24 13:19:09 +00:00
317ad7a5ee
Fixed docs for urlretrieve() to match code in the case of opening a local file.
...
Also some typos and removed trailing whitespace on the lines.
2003-04-24 02:31:14 +00:00
c22b2999f6
fix some markup errors
2003-04-23 20:38:41 +00:00
54a234a566
clarify - restrict version mention to the trunk version
2003-04-23 20:35:14 +00:00
1bd1d858ae
added note about character set limitations in passwords.
2003-04-23 20:22:12 +00:00
34d7f0927b
Document the new functions PyInt_AsUnsignedLongMask(), PyInt_AsUnsignedLongLongMask(),
...
PyLong_AsUnsignedLongMask(), PyLong_AsUnsignedLongLongMask().
2003-04-23 19:51:05 +00:00
2d1c846b73
Clarified new fsync() docs.
2003-04-23 19:47:14 +00:00
42a1172cf4
Document the new format codes B, H, I, k, K.
2003-04-23 19:27:35 +00:00
444e434011
Update the package list whenever we build distfiles.
...
This is used on www.python.org.
2003-04-23 15:04:52 +00:00
11b2306960
Enable os.fsync() for Windows, mapping it to MS's _commit() there. The
...
docs here are best-guess: the MS docs I could find weren't clear, and
some even claimed _commit() has no effect on Win32 systems (which is
easily shown to be false just by trying it).
2003-04-23 02:39:17 +00:00
863983e8e5
Add comment on performance.
...
Fix missing right parenthesis.
Add three examples.
2003-04-23 00:09:42 +00:00
70995830a6
markup corrections
2003-04-22 18:54:53 +00:00
282be3ab89
- explain the start argument to sum()
...
- various adjustments to sum() markup and explanation
2003-04-22 14:52:08 +00:00
03e929e7e0
Fix some markup nits.
2003-04-22 14:30:53 +00:00
a70b19147f
Adding new built-in function sum, with docs and tests.
2003-04-22 08:12:33 +00:00
48f3dcc93e
- Changed shlex.split() method to have more useful and
...
meaningful parameters.
2003-04-20 01:57:03 +00:00
cf146d31e7
- Included examples documenting how the lastindex member of
...
match objects work.
2003-04-20 01:48:59 +00:00
153c9e493e
Patch #553171 : Add writeback parameter. Also add protocol parameter.
2003-04-19 20:59:03 +00:00
a26854095b
- Several methods of nntplib.NNTP have grown an optional file argument
...
which specifies a file where to divert the command's output
(already supported by the body() method). (SF patch #720468 )
Thanks to Terry Carroll.
2003-04-19 18:04:57 +00:00
e36b690087
Mention the bz2 module
...
Various rewrites
2003-04-19 15:38:47 +00:00
b05df5796a
Added some more documentation to as_string() to make it clear that
...
it's a convenience only. Give an example of what to do for more
flexibility.
2003-04-18 23:03:53 +00:00
338bcbccfa
Change email address.
2003-04-18 22:04:34 +00:00
faf71ea5b3
Fix spelling of cedillas.
2003-04-18 21:48:56 +00:00
07d4fb6f17
Correct methoddesc environments.
2003-04-18 21:48:13 +00:00
382f078437
Add lib/libstringprep.tex lib/libdocxmlrpc.tex.
2003-04-18 21:45:26 +00:00
281b2c6211
Patch #536883 : SimpleXMLRPCServer auto-docing subclass.
2003-04-18 21:04:39 +00:00
cf6d74aedd
- accepted (slightly) modified version of docs for the OptionGroup
...
class; closes SF patch #697941
- use em-dashes intead of en-dashes
- section references: use a "tie" between the word "section" and the
section number, use quotation marks around section titles
- other minor markup corrections/cleanups
2003-04-18 15:50:13 +00:00
2548c730c1
Implement IDNA (Internationalized Domain Names in Applications).
2003-04-18 10:39:54 +00:00
10cf21802d
Use True in a few more places.
...
Use isinstance(somestring, basestring) instead of type() as per PEP 8
2003-04-17 23:09:08 +00:00
a6bdf2aef6
Oops, missed updating doc to correct version for split
2003-04-17 23:07:13 +00:00
30b6e8230b
Added documentation for the handle_pi() method, based on SF patch #662464 .
...
Closes SF bug #659188 , patch #662464 .
2003-04-17 22:36:52 +00:00
aa3b5d2ec5
markup banalities
2003-04-17 21:49:04 +00:00
68d8cef89a
Implemented posix-mode parsing support in shlex.py, as dicussed in
...
mailing list, and in patch #722686 .
2003-04-17 21:31:33 +00:00
2ed6dff796
As discussed on python-dev, revised docs to note that
...
PyObject_IsTrue() can have an error result.
Also, added missing docs for PyObject_Not().
Will backport.
2003-04-16 17:28:12 +00:00
1475c49211
Add version info for name2codepoint and codepoint2name
2003-04-16 13:21:06 +00:00
5688b7ac3e
Add two dictionaries to htmlentitydefs: name2codepoint maps
...
HTML entity names to Unicode codepoints (as integers).
codepoint2name is the reverse mapping. From SF patch #722017 .
2003-04-16 09:46:13 +00:00
0fc8f00252
- pythunrun.c, Py_Finalize(): move the call to _Py_PrintReferences()
...
even farther down, to just before the call to
_PyObject_DebugMallocStats(). This required the following changes:
- pystate.c, PyThreadState_GetDict(): changed not to raise an
exception or issue a fatal error when no current thread state is
available, but simply return NULL without raising an exception
(ever).
- object.c, Py_ReprEnter(): when PyThreadState_GetDict() returns NULL,
don't raise an exception but return 0. This means that when
printing a container that's recursive, printing will go on and on
and on. But that shouldn't happen in the case we care about (see
first bullet).
- Updated Misc/NEWS and Doc/api/init.tex to reflect changes to
PyThreadState_GetDict() definition.
2003-04-15 15:12:39 +00:00
3a3cca5b82
- list.insert(i, x) now interprets negative i as it would be
...
interpreted by slicing, so negative values count from the end of the
list. This was the only place where such an interpretation was not
placed on a list index.
2003-04-14 20:58:14 +00:00
b43f15e1ce
Add a name
2003-04-14 18:47:28 +00:00
44c62ef5ee
Typo fix
2003-04-14 15:32:18 +00:00
d39078ba2d
Mention timeit module
...
Fix error in description of logging package's 'propagate'
Mention default arg to dict.pop()
Link to more module docs
(I wonder if I should adopt some convention such as linking the first
mention of all new modules to the LibRef?)
Various text changes
Bump version number and Python version
2003-04-13 21:44:28 +00:00
ba887bb04e
Use simpler import
2003-04-13 21:13:02 +00:00
125b9b0736
Back out of setting the default charset to iso-8859-1.
2003-04-11 21:28:10 +00:00
06c7b62a83
Fix markup
2003-04-11 18:48:03 +00:00
a1ce93f87c
From http://mail.python.org/pipermail/i18n-sig/2003-April/001557.html
...
- Expose NullTranslations and GNUTranslations to __all__
- Set the default charset to iso-8859-1. It used to be None, which
would cause problems with .ugettext() if the file had no charset
parameter. Arguably, the po/mo file would be broken, but I still think
iso-8859-1 is a reasonable default.
- Add a "coerce" default argument to GNUTranslations's constructor. The
reason for this is that in Zope, we want all msgids and msgstrs to be
Unicode. For the latter, we could use .ugettext() but there isn't
currently a mechanism for Unicode-ifying msgids.
The plan then is that the charset parameter specifies the encoding for
both the msgids and msgstrs, and both are decoded to Unicode when read.
For example, we might encode po files with utf-8. I think the GNU
gettext tools don't care.
Since this could potentially break code [*] that wants to use the
encoded interface .gettext(), the constructor flag is added, defaulting
to False. Most code I suspect will want to set this to True and use
.ugettext().
- A few other minor changes from the Zope project, including asserting
that a zero-length msgid must have a Project-ID-Version header for it to
be counted as the metadata record.
2003-04-11 18:36:43 +00:00
bae5c965e8
Moved all the scripting stuff to a separate section, added all the
...
missing bits (well, all the bits I could think of) and updated the
rest.
2003-04-11 15:35:28 +00:00
ffe33b7f24
Attempt to make all the various string *strip methods the same.
...
* Doc - add doc for when functions were added
* UserString
* string object methods
* string module functions
'chars' is used for the last parameter everywhere.
These changes will be backported, since part of the changes
have already been made, but they were inconsistent.
2003-04-10 22:35:32 +00:00
Skip Montanaro
Jeremy Hylton
Greg Ward
Martin v. Löwis
Fred Drake
Raymond Hettinger
Brett Cannon
Tim Peters
Guido van Rossum
Neal Norwitz
Andrew M. Kuchling
Barry Warsaw
Thomas Heller
Alex Martelli
Gustavo Niemeyer
Walter Dörwald
Jack Jansen