6fdf3cbb13
Corrected example for replacing shell pipeline. Fixes bug 1073790.
2004-11-30 18:06:42 +00:00
4871535cfe
Update release date.
2004-11-30 14:42:24 +00:00
02d74f68c6
Hear the #error: change the default value of the mutable_arg argument
...
to ioctl() and remove the warning when it is not supplied.
2004-11-30 14:31:54 +00:00
6e3fa2911d
REVERT revision 1.260; the trunk is FROZEN.
...
This change can be made on the trunk and release24-maint branch after
the trunk is unfrozen.
2004-11-29 13:12:44 +00:00
a98825ce48
Fix a nit.
2004-11-29 08:53:14 +00:00
4fd38b3f77
Fix typo.
2004-11-25 05:35:32 +00:00
23ce5848aa
Clarify the ordering of dictionary keys.
2004-11-25 05:16:19 +00:00
3de9aa40ec
Make sure the money formatting recipe can doesn't run out of digits
...
to the right of the decimal point.
2004-11-25 04:47:09 +00:00
536183b021
Following a LtU thread, change introductory paragraph of decimal section
2004-11-25 01:15:25 +00:00
f8c6e6a16b
add missing dependency
2004-11-24 14:57:04 +00:00
8f2c4eed93
SF bug #1071566 : moneyfmt recipe in decimal documentation has error
2004-11-24 05:53:26 +00:00
7f13cfa674
os.walk(): Changed the "sum of bytes consumed by files" example to use
...
a generator expression instead of a listcomp.
Not a backport candidate (genexps are new in 2.4).
2004-11-22 16:53:46 +00:00
919a3b40f9
SF bug 1071087: os.walk example for deleting a full tree is sometime wrong.
...
Clarify that the example assumes no links are present; the point of the
example is to illustrate a need for topdown=False, not to wrestle with
platform-dependent link convolutions.
Also spell os.path.join() out in full, instead of using a shortcut import.
The bug reporter was confused by that too, and it's clearer this way.
Bugfix candidate; but I don't intend to backport it.
2004-11-22 16:49:02 +00:00
a9cadcd41b
Correct the handling of 0-termination of PyUnicode_AsWideChar()
...
and its usage in PyLocale_strcoll().
Clarify the documentation on this.
Thanks to Andreas Degert for pointing this out.
2004-11-22 13:02:31 +00:00
139af0295c
Fixed quantize syntax.
2004-11-20 00:33:51 +00:00
bae8f377d3
Fill in the benchmark figures, bogus or not; add a disclaimer
2004-11-19 14:55:28 +00:00
067947e840
Last pass to fill in contributor names; remove stray 'contributed by' from the incompatible changes section; remove some XXX comments
2004-11-19 14:43:36 +00:00
c64be941e7
It's GTK+, apparently; remove XXX comment
2004-11-19 14:27:54 +00:00
7466659e83
Bump version number; update patch/bug counts; bet that the final release will be in December
2004-11-19 14:26:23 +00:00
a2325f67a1
SF patch #1068456 : small update for pdb docs
2004-11-18 08:39:33 +00:00
2a216794f0
SF bug #1066036 : Typo about PyErr_WriteUnraisable()
2004-11-18 06:50:19 +00:00
83e4a146db
SF bug #1067018 : Obsolete info in Tutorial 9.1
...
Removed a section that is out of date after type/class unification.
While there was still some validity, the paragraph offered more
confusion that insight.
2004-11-18 06:20:30 +00:00
88c2595bf6
SF bug #1067023 : A small typo
...
Make a minor clarification between "written" and "displayed".
2004-11-18 06:14:27 +00:00
b2d5a8efd5
Comment for performance measurement.
2004-11-18 05:51:53 +00:00
fdc58f2391
SF bug 1066438: datetime.replace method description error
...
Repair typo in example.
2004-11-15 03:50:16 +00:00
58954813ce
avoid applying :active to anchors that are only link targets
...
(no href attribute)
2004-11-13 21:58:01 +00:00
1681b62251
add another way to specify an alternate name for the documentation set,
...
so that this is harder to forget to do for development of new styles
2004-11-13 17:45:39 +00:00
deb39b5fef
if we treat \LaTeX specially, we need to do the same for \TeX
2004-11-13 05:46:18 +00:00
64f164e08f
- wrap a long line
...
- add directory information for the "What's New" document
2004-11-13 04:41:01 +00:00
9103ec5afd
avoid the inane markup generated by LaTeX2HTML for \LaTeX; that simply
...
doesn't look right in HTML
2004-11-13 01:20:24 +00:00
441609466b
SF bug 1060644. Better explanation of min() and max() methods. Thanks Raymond Hettinger and Tim Peters.
2004-11-12 02:03:36 +00:00
961eda7ad9
SF #1063757 : fix markup error (had LaTeX markup in the reST source,
...
oops!).
2004-11-12 01:20:17 +00:00
edde492f13
Minor grammatical errors fixed
2004-11-11 13:54:48 +00:00
af305b1dab
remove some generated cruft now that we avoid the removal of elements
...
with no content (due to the text_cleanup() override in l2hinit.perl)
2004-11-11 08:05:34 +00:00
2269d86598
Fix SF bug #1061770 : Manual typesets bit-shift operators as guillemet
2004-11-11 06:14:05 +00:00
c6864832d7
add a comment explaining a particular text transformation
2004-11-11 05:42:13 +00:00
758f5ea419
Replace last two uses of the "list" environment with "description"
...
environments.
Closes SF bug #692442 : Konqueror can't render docs because of
malformed HTML. While the generated HTML is still terrible, the cited
cases of <DL COMPACT> have been removed. The general problem of XHTML
conformance has not been solved, but is endemic to LaTeX2HTML output.
2004-11-11 05:04:55 +00:00
52c937dc09
remove unhelpful property setting that overrides the right setting for
...
text-align in .realtable cells; fix suggested by Richard Brodie
2004-11-11 04:41:24 +00:00
8efc80a909
- remove use of a "list" environment (replace with a table)
...
- fix minor markup nits
2004-11-11 04:39:56 +00:00
0a3c818fc5
- hack for MSIE5 to make (real) tables center
...
- remove last <center> element (long deprecated in HTML)
2004-11-10 19:22:05 +00:00
9c8149a162
more HTML styling detail changes
2004-11-10 17:56:29 +00:00
5d93eef263
move table formatting for grammar productions from HTML to CSS
2004-11-10 17:02:43 +00:00
5b00059110
minor markup nits; fix missing whitespace
2004-11-10 16:51:17 +00:00
179b39ab9e
remove unreachable cruft
2004-11-10 15:54:46 +00:00
9e927f1564
add a comment about one of the remaining warts in the table
...
formatting
2004-11-10 15:49:25 +00:00
b194b5b3cc
remove comment that seems to be wrong after all; browsers do implement
...
this, but I was misled by a LaTeX2HTML wart that I worked around
yesterday
2004-11-10 15:39:50 +00:00
39a6a6d3c8
move much of the table styling out of the HTML and into the CSS;
...
this also makes some constructs more XHTML friendly (including adding in
some missing </tr> tags)
2004-11-10 15:37:54 +00:00
0cf87be326
more more styling to the CSS
2004-11-10 08:08:26 +00:00
d7a5bca89b
more XHTML friendliness: <dl compact> becomes well-formed
2004-11-10 08:07:00 +00:00
dcb16ac03c
override a bit of LaTeX2HTML so empty table cells don't disappear from
...
the output
2004-11-10 07:48:17 +00:00
f8c075cefc
Bump version number
...
Add doctest section
Wordsmithing
2004-11-09 02:58:02 +00:00
4de9374b0e
Patch #1062033 / bug #1027771 : clarify what happens when calling
...
insertBefore() with refChild=None.
2004-11-07 19:55:18 +00:00
4f18caa07b
Patch #1062018 / bug #1038693 : comment out dead link in tkinter docs.
2004-11-07 19:36:48 +00:00
3546188123
Added more documentation about the executable argument.
...
Fixes #1056441 .
2004-11-07 16:38:08 +00:00
f164322fe8
Patch #1061924 : add documentation for BaseRotatingHandler and correct
...
reference to non-existent function 'setRollover()'.
2004-11-07 16:11:35 +00:00
eaaa771816
Clarify that it's not necessary to subclass from TestCase to create a
...
test case. As Jeremy put it: "subclassing is an implementation
technique, not a type declaration".
2004-11-07 16:02:07 +00:00
4f802ac2b6
Patch #1061857 : add documentation for previously undocumented
...
TimedRotatingFileHandler class. Thanks Jeroen Vloothuis!
2004-11-07 14:14:27 +00:00
700d9b9b63
SF patch #1061780 : use a new -m option in pdb and profile invocations
...
Doc patch submitted by Ilya Sandler.
2004-11-07 06:18:37 +00:00
bb4e859ecf
SF bug #1060825 : Error in difflib docs
2004-11-05 16:38:08 +00:00
e0bdaefaf4
- remove some bogus <meta> tags from the document head
...
- clean up some of the generated markup
2004-11-05 06:42:22 +00:00
0384be3b07
generate the "type" attribute on the favicon link
2004-11-05 05:06:08 +00:00
6e2e90d160
switch remaining icon references to the PNG icons
2004-11-05 04:51:05 +00:00
8aebe19e35
add encouragement to contribute without learning LaTeX
...
(closes SF bug #948517 )
2004-11-05 04:23:25 +00:00
5c0ebdcb64
- make the default image type PNG, to match mkhowto
...
- add a command-line option to control the image type
2004-11-05 04:05:06 +00:00
2cf5e1920b
Point out some platform vagaries in stat() and utime().
...
Bugfix candidate (the vagaries aren't new <wink>), but I don't intend to
backport this.
2004-11-04 21:27:48 +00:00
80adba6873
Mistakes in the "sequence types" page:
...
* explanation for example with lists of lists made confusing use of
the word "contains" to mean "is built out of".
* wrong formula for slices with step. Is it ok to use LaTeX formulas
(which become images in the html document)? This version needs one
because it's based on a fraction. Just writing "\code{(j-i)/k}" here would
be ambiguous because it looks like a rounding-down-to-the-previous-integer
division, which is not what we need here. Of course we could write
"\code{float(j-i)/k}" but it just looks confusing.
2004-11-04 11:29:09 +00:00
99e5ce5cf4
markup nit
2004-11-04 05:45:44 +00:00
599bd5e1e1
Fix bug 1052242. Also includes rewrite of test case using unittest and
...
avoiding use of popen.
2004-11-04 04:31:30 +00:00
ed306292d6
fix markup in "title" attribute for \citetitle{}
...
(closes SF patch #1054715 ; backporting to release23-maint branch)
2004-11-04 03:23:04 +00:00
eac00edd20
fix accidental commit
2004-11-02 19:20:43 +00:00
7fabaf8375
clarify discussion of iteration in the section on the "for" statement
...
(SF bug #829073 )
2004-11-02 19:18:20 +00:00
303e30ef9f
clarify discussion of iteration in the section on the "for" statement
...
(SF bug #829073 )
2004-11-02 19:18:20 +00:00
9a40851569
clarify trailing comma in function argument list
...
(SF bug #798652 )
2004-11-02 18:57:33 +00:00
e808c2341b
- show how to use file.write() with a non-string value
...
(closes SF bug #621057 )
- add missing whitespace around assignment operator
2004-11-02 18:24:26 +00:00
87d6fc5161
SF bug #1030118 , this should have named the email.Utils module as the one
...
containing these functions. (I will backport to Python 2.3)
2004-11-01 03:59:24 +00:00
8c72eae237
SF patch #1056967 , changes the semantics of Template.safe_substitute() to not
...
raise a ValueError for dangling delimiters (the delimiter itself is returned).
2004-11-01 03:52:43 +00:00
63e2090fda
Bug #1057535 : add link in time module to calendar.timegm().
2004-10-31 12:19:34 +00:00
0c1b253fc0
add xml:id attributes wherever we generate the IDs (old patch saved up)
2004-10-29 19:47:52 +00:00
048840c485
style consistency:
...
- always include a space after the "#" that starts a comment
- easier to read imports
2004-10-29 14:35:42 +00:00
006483b003
Added network logging example
2004-10-29 12:30:28 +00:00
182ac85147
SF #737473 : Show up-to-date source code in tracebacks always.
...
And add an optional argument 'filename' to linecache.checkcache()
to enable checking caches per-file.
2004-10-26 09:16:42 +00:00
df8a0032a4
SF 1053956: help() not in tutorial index
2004-10-26 03:53:35 +00:00
3ed238503d
add missing line break
2004-10-25 21:35:17 +00:00
afe73c02a9
- improve the explanation of the -*- coding: ... -*- marker
...
- fix a minor formatting nit that affected the typeset version
2004-10-25 16:03:49 +00:00
93ae4c100e
Added example of multiple destinations
2004-10-22 21:43:15 +00:00
57712b3d9a
Remove the current version of zlib (we'll just have to keep updating it); rewrite following sentence to make sense without the previous one
2004-10-19 19:50:23 +00:00
28d07ab676
Typo fixes, and a minor edit to clarify a sentence
2004-10-19 19:39:02 +00:00
5fcc003566
[Bug #1049826 ] Update version of zlib referenced in text
2004-10-19 18:52:49 +00:00
972c9e85bb
Rely on the style sheet more for the distutils markup.
2004-10-19 15:40:38 +00:00
20a175a34a
made it clear that this isn't a complete reference to
...
LaTeX-as-used-in-Python-documentation, and added some notes about
what's missing
2004-10-18 21:30:40 +00:00
8b94dc6d07
Bump version
2004-10-18 16:16:53 +00:00
6b1597c7c7
Clarify note about using %U and %W with strptime().
2004-10-18 01:53:15 +00:00
8abcc5d533
Add support for %U and %W to contribute to calculating the date when the year
...
and day of the week are specified.
Closes bug #1045381 .
2004-10-18 01:37:57 +00:00
a5c64599d5
SF bug #1048756 , Doc typo for pdb
2004-10-17 19:55:47 +00:00
2562ff2de3
SF patch #1047577 , typo in liblocale.tex
2004-10-17 16:36:05 +00:00
b04b6afd01
SF Patch #1048341 : subprocess documentation, based on PEP/docstring by
...
Peter Astrand, with markup by Fredrik Lundh and Raymond Hettinger.
2004-10-17 16:29:48 +00:00
2784df7502
SF Bug #1046800 : Importing Tkinter correctly (thanks Vishnu).
2004-10-16 21:40:35 +00:00
371e4d895b
SF bug 1046690: difflib.HtmlDiff doc errors.
...
Easy doc corrections from Dan Gass.
Also repaired the LaTeX for optional keyword arguments throughout, which
was (incorrectly) nested instead of flat.
2004-10-14 03:09:48 +00:00
b6ffc275ab
Finish off PEP 324 section; fix Peter's last name
2004-10-12 16:36:57 +00:00
c9e7d77aaa
Start section for PEP 324
2004-10-12 15:58:02 +00:00
f3958f16cf
Add two items
2004-10-11 19:20:06 +00:00
9fc9789a0d
Document that on Unix, the 'cmd' argument to the os.popen2/3/4 and
...
popen2.popen2/3/4 functions can be a sequence. All texts are a variation on the
following:
On \UNIX, \var{cmd} may be a sequence, in which case arguments will be passed
directly to the program without shell intervention (as with
\function{os.spawnv()}). If \var{cmd} is a string it will be passed to the shell
(as with \function{os.system()}).
2004-10-11 18:12:20 +00:00
3dd9e46161
Added a usegmt flag to email.Utils.formatdate - this allows it to be
...
used to replace rfc822.formatdate for protocols like HTTP (where 'GMT' must
be the timezone string).
2004-10-11 13:53:08 +00:00
7f468f29f4
SF patch 1044089: New C API function PyEval_ThreadsInitialized(), by Nick
...
Coghlan, for determining whether PyEval_InitThreads() has been called.
Also purged the undocumented+unused _PyThread_Started int.
2004-10-11 02:40:51 +00:00
7126976ee8
Patch #1042969 : add closing brace for \token {generator_expression}. Thanks
...
George Yoshida!
2004-10-09 15:52:04 +00:00
7a8ce5afcc
[Bug #1022311 ] curses module uses y,x ordering of arguments, not x,y
2004-10-08 18:48:43 +00:00
293dc9d70f
[Bug #1041501 ] Fix example code
2004-10-08 18:34:47 +00:00
cebdd3c8f1
[Bug #1031897 ] Fix order of decorator application
2004-10-08 18:29:29 +00:00
77d110d6b8
SF patch #1041364 : True/False instead of 1/0 in libstdtypes.tex
...
(Contributed by Gerrit Holl. Reviewed by Jeff Epler.)
2004-10-08 01:52:15 +00:00
5e3f9236c7
Add item
2004-10-07 12:00:33 +00:00
db29e0fe8c
SF patch #1035498 : -m option to run a module as a script
...
(Contributed by Nick Coghlan.)
2004-10-07 06:46:25 +00:00
579b3e2416
Add some items
2004-10-05 20:23:34 +00:00
29978aedcb
The docs claimed a test would pass that actually wouldn't pass. Repaired
...
the example so it does pass.
2004-10-04 03:34:32 +00:00
1dc5b1e5a2
Clarified documentation about exc_info keyword parameter
2004-10-03 19:10:05 +00:00
1cbf206d32
SF bug #997050 : Document, test, & check for non-string values in ConfigParser. Moved the new string-only restriction added in rev. 1.65 to the SafeConfigParser class, leaving existing ConfigParser & RawConfigParser behavior alone, and documented the conditions under which non-string values work.
2004-10-03 15:55:09 +00:00
bfe5684308
typo
2004-10-03 09:41:26 +00:00
8df5921247
Blarg, fix the versions.
2004-10-03 03:58:01 +00:00
43790b4b21
Updates for distutils package.
2004-10-03 03:57:37 +00:00
2ec4854f13
Add documentation about as_string() mangling From_ lines.
2004-10-03 03:39:47 +00:00
bb11386730
Big email 3.0 API changes, with updated unit tests and documentation.
...
Briefly (from the NEWS file):
- Updates for the email package:
+ All deprecated APIs that in email 2.x issued warnings have been removed:
_encoder argument to the MIMEText constructor, Message.add_payload(),
Utils.dump_address_pair(), Utils.decode(), Utils.encode()
+ New deprecations: Generator.__call__(), Message.get_type(),
Message.get_main_type(), Message.get_subtype(), the 'strict' argument to
the Parser constructor. These will be removed in email 3.1.
+ Support for Python earlier than 2.3 has been removed (see PEP 291).
+ All defect classes have been renamed to end in 'Defect'.
+ Some FeedParser fixes; also a MultipartInvariantViolationDefect will be
added to messages that claim to be multipart but really aren't.
+ Updates to documentation.
2004-10-03 03:16:19 +00:00
565ea5ae37
SF bug#1038917 fix typos (Contributed by George Yoshida.)
2004-10-02 11:02:59 +00:00
e644a1b921
Get references working (except for references to "Extending optparse",
...
which isn't being converted from reST yet).
2004-10-01 01:16:39 +00:00
0fe00aafc3
Added 2 notes about the complexities of testing SyntaxErrors.
2004-09-30 17:18:18 +00:00
f751fa6195
SF bug #1035279 : hex() and oct() documentation is incorrect
...
* Updated docs to reflected signed return values.
* Fixed a doubled word typo.
2004-09-30 00:59:08 +00:00
975e725fc7
Fix typo in PyDict_Items doc
2004-09-29 21:39:26 +00:00
5497feefac
minor doc tweaks for writexml
2004-09-28 18:40:42 +00:00
67db9a5b72
typo
2004-09-28 18:30:03 +00:00
01ba799244
A number of list examples used 66.6, but I doubt there's any box on which
...
repr(66.6) == "66.6", so doubt that the claimed output has ever been seen.
Changed it to 66.25 everywhere, and manually verified that the new claimed
output is correct.
2004-09-28 16:12:50 +00:00
7d88a58e85
Reverted the addition of a NORMALIZE_NUMBERS option, per Tim Peter's
...
request. Tim says that "correct 'fuzzy' comparison of floats cannot
be automated." (The motivation behind adding the new option
was verifying interactive examples in Python's latex documentation;
several such examples use numbers that don't print consistently on
different platforms.)
2004-09-28 05:50:57 +00:00
aec3c9b54f
Added a new NORMALIZE_NUMBERS option, which causes number literals in
...
the expected output to match corresponding number literals in the
actual output if their values are equal (to ten digits of precision).
2004-09-28 04:29:57 +00:00
1793dd31de
Fixed minor typo in interactive example (extra '.'s in '...' prompts)
2004-09-28 03:12:01 +00:00
dcdb4b4d78
Fixed minor typo in interactive example (extra blank line)
2004-09-28 03:08:57 +00:00
78a5271d3e
SF bug #1033038 : Misleading error message in random.choice
...
Added a clarifying line to the docs.
2004-09-28 03:04:23 +00:00
ad512265a5
Fixed minor typo in interactive example
2004-09-28 02:56:45 +00:00
3077b02ff4
Fixed minor typo in interactive example (backslash shouldn't be doubled)
2004-09-28 02:54:54 +00:00
a7f62814cf
Updated interactive examples in the "Examples" session to reflect the
...
fact that compiler.ast.Function now takes a "decorators" argument.
2004-09-28 02:53:50 +00:00
b6f7fb7327
Major overhaul to reflect Optik 1.5. Section references currently broken.
2004-09-28 01:30:23 +00:00
b6aa856f25
Patch #1009075 , bug #952953 : allow execve with empty 2nd argument
2004-09-27 19:54:33 +00:00
a4c6a8522c
- Added a "parser" option to testfile() and DocFileTest().
2004-09-27 04:08:20 +00:00
456ff91664
- Fixed typo in multi-line exception example
...
- Fixed indentation for a verbatim block
2004-09-27 03:30:44 +00:00
36ee8ce373
Give a saner example for script_from_examples(); also mention an intended
...
but not entirely obvious use case.
2004-09-26 21:51:25 +00:00
9463d8761b
Made most module references "clickable".
2004-09-26 21:05:03 +00:00
0041121c25
Docs for run_docstring_examples().
2004-09-26 20:45:04 +00:00
05b05febad
Added a lot of new stuff to the debugging section.
2004-09-26 05:09:59 +00:00
16be62f054
register_optionflag(): Moved from the Debugging section to the section
...
on option flags; added a versionadded decoration.
2004-09-26 02:38:41 +00:00
6a0a64b7ad
Document set_unittest_reportflags().
2004-09-26 02:12:40 +00:00
c90ea82302
Fix double word error.
2004-09-25 08:09:23 +00:00
3f7912521d
Assorted minor changes, plus a lot more soap.
2004-09-25 03:50:35 +00:00
8c0a2cf938
Explain the motivation for the unittest functions, and beef up the
...
example. Squash repeated argument descriptions. Minor rewordings.
2004-09-25 03:02:23 +00:00
b2b26aca13
Repaired mistakes in the descriptions of testmod()/testfile(), and
...
squashed massive duplication of common argument descriptions.
2004-09-25 01:51:49 +00:00
2dc820599b
Since the doctest warnings section was reduced to one bullet point,
...
get rid of the itemize structure.
2004-09-25 01:30:16 +00:00
39c5de0376
In the "doctest warnings" section, removed obsolete info, and noted that
...
ELLIPSIS can be used to deal with examples that embed object addresses.
2004-09-25 01:22:29 +00:00
24f141ab46
Raymond observed that sometimes it's better not to link modules, so I reverted
...
part of my previous last changes.
2004-09-25 00:55:38 +00:00
06cc847cee
Beef up the section on testfile(), giving a complete example in
...
reStructuredText format. Remove words describing the return value of
testmod() and testfile() in the intro sections, since it's never
useful in such simple cases.
2004-09-25 00:49:53 +00:00
cac5e7b81d
Typo.
2004-09-25 00:11:43 +00:00
7a082142d8
Since the LaTeX isn't doctest'ed, examples are always wrong <wink>.
2004-09-25 00:10:53 +00:00
27ebcae450
- Use itemize instead of plain-text '*' for marking up a list.
...
- Add more ulink's to modules (this should probably become a standard macro).
2004-09-24 23:25:25 +00:00
739d49e39b
Added log() function documentation
2004-09-24 11:46:44 +00:00
596ba4d89e
Granted Noam Raphael's request for minor improvements to the re module and
...
its documentation.
* Documented that the compiled re methods are supposed to be more full
featured than their simpilified function counterparts.
* Documented the existing start and stop position arguments for the
findall() and finditer() methods of compiled regular expression objects.
* Added an optional flags argument to the re.findall() and re.finditer()
functions. This aligns their API with that for re.search() and
re.match().
2004-09-24 03:41:05 +00:00
9fa544cfa3
Update for beta1
2004-09-23 20:17:26 +00:00
0c7895617f
Add various items
2004-09-23 20:15:41 +00:00
4533f1fb7f
Improve three recipes in the itertools docs.
2004-09-23 07:27:39 +00:00
c6646c097a
Added getLoggerClass()
2004-09-22 12:55:16 +00:00
b3666a3da2
- Updated docs to reflect changes in 2.4.
...
- Reorganized the documentation
- Shifted focus a little more towards "literate testing"
- Documented new functions and classes:
- testfile()
- Example, DocTest
- DocTestParser, DocTestFinder, DocTestRunner, OutputChecker
- DocFileSuite
- DebugRunner, DocTestFailure, UnexpectedException
- register_optionflag()
2004-09-21 03:00:51 +00:00
468af71214
Fix minor grammar typo.
2004-09-20 17:47:46 +00:00
6cc1350807
- Updated example output to match actual output
...
- Minor wording changes
- Changed the docs to reflect the fact that multiple option directives
can be specified on a single line (and updated the directive
production list, as well).
2004-09-19 01:16:44 +00:00
33db656dbf
Update Template/PEP 292 documentation to current implementation.
2004-09-18 21:13:43 +00:00
39a317890f
Patch #1025790 : Add status code constants to httplib.
2004-09-18 09:03:49 +00:00
2e6fb4634c
remove gzipped archives from the list of expected distributions
2004-09-17 20:23:47 +00:00
266a436fe2
Remove claims that Python source code is ASCII. Fixes #1026038 .
2004-09-14 07:52:22 +00:00
879ddf30d0
Tweak the wording. Improve examples. Make more brief.
2004-09-14 06:32:20 +00:00
29c6a79b7d
Cover string.Template in the tutorial's library tour.
2004-09-14 05:21:42 +00:00
23f1241dc6
SF #1027105 : HardwareRandom should be renamed OSRandom
...
Renamed the new generator at Trevor's recommendation.
The name HardwareRandom suggested a bit more than it
delivered (no radioactive decay detectors or such).
2004-09-13 22:23:21 +00:00
7642f7af0d
Credit patch from Raymond
2004-09-13 15:06:50 +00:00
8278860e52
Document testmod's new exclude_empty argument.
2004-09-13 15:03:17 +00:00
2ee8099bd8
HtmlDiff corrections from Dan Gass, + trimmed trailing whitespace.
2004-09-12 03:21:00 +00:00
6ab4b99f95
Patch #1025795 : clarify language in Data Structures chapter of tutorial:
...
- Dictionary keys are in arbitrary order, but not random (which implies, well,
intentional randomness).
- Move a footnote closer to what it's talking about so that it doesn't look
like we're saying that "0 == 0.0" can't be relied on.
- Minor language tweaks in the vicinity.
Thanks Dima Dorfman!
2004-09-11 17:48:21 +00:00
2014c033f7
Patch #1022152 : add required 'domain' argument to gettext.translation() examples.
2004-09-11 17:33:25 +00:00
d345225ae5
Patch #1026384 : fix two common typo's:
...
- accomodate -> accommodate
- occured -> occurred
Thanks George Yoshida!
2004-09-11 16:50:06 +00:00
c9c37ca62e
Patch #1025800 : remove TeX quoting from verbatim section. Thanks Dima Dorfman!
2004-09-11 15:47:30 +00:00
f08437ca08
[Bug #1023359 ] Make code match inheritance diagram
2004-09-10 19:33:00 +00:00
a331e86452
Add some stdlib items; remove 'other changes' section; fix sorting error in list of changed modules
2004-09-10 13:05:22 +00:00
55be9eab38
Typo fix: 'comparisions' is not a word
2004-09-10 12:59:54 +00:00
2cc0c3008c
Bump version number
2004-09-10 12:38:36 +00:00
a79ec22f9f
Update PEP292 section
2004-09-10 11:34:39 +00:00
961c2882a9
document the exceptions raised by sgmllib, htmllib, and HTMLParser
2004-09-10 01:20:21 +00:00
a2544ee7f0
fix typo in markup
2004-09-10 01:16:49 +00:00
216b249e94
make_nav_panel(): Don't cause side-effects on the input variables;
...
this caused duplicate attributes for the bottom navigation panel.
(closes SF patch #1013055 ; backport candidate)
2004-09-09 05:13:52 +00:00
69652035bc
SF patch #998993 : The UTF-8 and the UTF-16 stateful decoders now support
...
decoding incomplete input (when the input stream is temporarily exhausted).
codecs.StreamReader now implements buffering, which enables proper
readline support for the UTF-16 decoders. codecs.StreamReader.read()
has a new argument chars which specifies the number of characters to
return. codecs.StreamReader.readline() and codecs.StreamReader.readlines()
have a new argument keepends. Trailing "\n"s will be stripped from the lines
if keepends is false. Added C APIs PyUnicode_DecodeUTF8Stateful and
PyUnicode_DecodeUTF16Stateful.
2004-09-07 20:24:22 +00:00
8158e84930
Fix erroneous docstring comment.
2004-09-06 07:04:09 +00:00
785c65ccd2
Markup nits.
2004-09-06 01:01:08 +00:00
bb30af4565
Add missing close parenthesis.
2004-09-06 00:42:14 +00:00
18c6960964
SF bug #901654 : split method documentation can be improved
...
* Discuss the algorithmic distinctions between s.split() and s.split(sep).
* Document the split behavior for empty strings.
* Note the behavior when maxsplit is zero.
* Include short examples.
2004-09-06 00:12:04 +00:00
1b262977a0
Rework some wording.
2004-09-05 19:42:15 +00:00
2a72f19528
SF bug #1020540 : a wrong link from "frame object" in lib index
2004-09-04 21:14:34 +00:00
1fbf9c5ec1
Added IGNORE_EXCEPTION_DETAIL comparison option. The need is explained
...
in the new docs.
DocTestRunner.__run: Separate the determination of the example outcome
from reporting that outcome, to squash brittle code duplication and
excessive nesting.
2004-09-04 17:21:02 +00:00
a01a2ee933
Applying modified version of patch #1018386 , which fixes
...
some escaping bugs in SRE.
2004-09-03 17:06:10 +00:00
0bbf137fbd
Make the api of the _dispatch() method more concrete. I have no idea if
...
this is the right way to document such things (Fred, help me out here :-),
but I got misled by the existing documentation and assumed the parameter
list was a *args sort of thing.
2004-09-03 00:04:05 +00:00
410eb84a5d
- add missing \end{seealso}
...
- wrap long line
2004-09-01 04:05:08 +00:00
3d3db9663f
Add item
2004-08-31 13:57:02 +00:00
ecd5754925
Remove rotor reference
2004-08-31 13:49:36 +00:00
595ac8a6fc
Remove rotor license
2004-08-31 13:24:08 +00:00
ab459f71d6
Remove docs for xreadlines, mpz, rotor
2004-08-31 13:22:43 +00:00
e723863ba1
Remove xreadlines reference
2004-08-31 13:21:07 +00:00
a46fd8480f
Remove TERMIOS docs
2004-08-31 13:05:59 +00:00
e4133d8d67
Use correct constant; remove reference to TERMIOS.py
2004-08-31 13:05:36 +00:00
e34c3bd621
Change from Raymond: use pos/neg instead of +/- 1; minor edits
2004-08-31 12:21:44 +00:00
ab77822826
Describe non-recursive re
2004-08-31 12:07:43 +00:00
b07aae28c5
Add bug/patch counts
2004-08-31 11:54:22 +00:00
3294e9d2e7
Update versions and dates; add PEP 328
2004-08-31 11:26:23 +00:00
17952b78e1
Updated doc for getLogger()
2004-08-31 10:21:51 +00:00
1a4ddaecc7
SF patch #1007189 , multi-line imports, for instance:
...
"from blah import (foo, bar
baz, bongo)"
2004-08-31 10:07:13 +00:00
38330fe5ef
The distinction between comparison flags and reporting flags isn't unique
...
to unittest, so make it official: new module constants COMPARISON_FLAGS
and REPORTING_FLAGS, which are bitmasks or'ing together the relevant
individual option flags.
set_unittest_reportflags(): Reworked to use REPORTING_FLAGS, and
simplified overly complicated flag logic.
class FakeModule: Removed this; neither documented nor used.
2004-08-30 16:19:24 +00:00
ed047486f5
Fix build error: \filename{/dev/urandom} -> \file{/dev/urandom}.
2004-08-30 15:03:23 +00:00
cb7b3f30d6
Add items
2004-08-30 11:58:04 +00:00
ae882f7984
Patch #941486 : add os.path.lexists(). Also fix bug #940578 by using lexists in glob.glob.
2004-08-30 10:19:56 +00:00
356a4599ac
Teach the random module about os.urandom().
...
* Use it for seeding when it is available.
* Provide an alternate generator based on it.
2004-08-30 06:14:31 +00:00
e064b41f5a
Patch #914575 : difflib side by side diff support, diff.py s/b/s HTML option.
2004-08-29 16:34:40 +00:00
dc3883f671
Patch #934711 : Expose platform-specific entropy.
2004-08-29 15:46:35 +00:00
6ab78cd0c0
SF feature request #992967 : array.array objects should support sequences.
...
Made the constructor accept general iterables.
2004-08-29 07:50:43 +00:00
592ef6110f
Correct incorrect "it's" to "its".
2004-08-26 10:40:12 +00:00
f33683fd40
Fine tune a word.
2004-08-26 04:52:46 +00:00
cf53355fcf
Thinko repair.
2004-08-26 04:50:38 +00:00
a07bcd46f3
Reorg of exception section. Now that there are fewer details needing
...
explanation, it's easier to push the remaining insufferably anal details
into a "fine print" section at the bottom.
2004-08-26 04:47:31 +00:00
f4fd79ca49
Small wording fixups.
2004-08-26 03:11:56 +00:00
a89f88d53f
Added REPORT_ONLY_FIRST_FAILURE flag, which supresses output after the
...
first failing example in each test.
2004-08-26 02:45:51 +00:00
71f55af826
Renamed UNIFIED_DIFF->REPORT_UDIFF; CONTEXT_DIFF->REPORT_CDIFF; and
...
NDIFF_DIFF->REPORT_NDIFF. This establishes the naming convention that
all reporting options should begin with "REPORT_" (since reporting
options are a different class from output comparison options; but they
are both set in optionflags).
2004-08-26 01:41:51 +00:00
0e448073d6
Restored half of a \versionadded only half of which should have been
...
deleted.
2004-08-26 01:02:08 +00:00
e8bbfe4e63
Patch #1015012 . Improve markup and punctuation in libsocket.tex
2004-08-26 00:51:16 +00:00
3203efb55f
Patch #1014930 . Expose current parse location to XMLParser.
2004-08-26 00:37:31 +00:00
19b1958730
Only recognize the expected output as an exception if it *starts* with
...
a traceback message. I.e., examples that raise exceptions may no
longer generate pre-exception output. This restores the behavior of
doctest in python 2.3. The ability to check pre-exception output is
being removed because it makes the documentation simpler; and because
there are very few use cases for it.
2004-08-25 23:07:03 +00:00
e3a1b4888c
clean up markup for --executable description
2004-08-25 14:01:32 +00:00
87c98b2e4b
Add various items
2004-08-25 13:38:46 +00:00
9f5c0c41ce
Patch #736857 , #736859 : Add -e option to build_scripts.
2004-08-25 11:37:43 +00:00
be83737c7c
Patch #798244 : More urllib2 examples.
2004-08-25 11:24:42 +00:00
8d494f3241
Patch #1015021 : Stop claiming that coerce can return None.
...
Will backport to 2.3.
2004-08-25 10:42:41 +00:00
08b07def43
Ah whoops, we didn't turn string into a package (thanks Neal!)
2004-08-25 03:09:58 +00:00
8bee76106e
PEP 292 classes Template and SafeTemplate are added to the string module.
...
This patch includes test cases and documentation updates, as well as NEWS file
updates.
This patch also updates the sre modules so that they don't import the string
module, breaking direct circular imports.
2004-08-25 02:22:30 +00:00
c885443479
Stop producing or using OverflowWarning. PEP 237 thought this would
...
happen in 2.3, but nobody noticed it still was getting generated (the
warning was disabled by default). OverflowWarning and
PyExc_OverflowWarning should be removed for 2.5, and left notes all over
saying so.
2004-08-25 02:14:08 +00:00
07fda7e3a0
Updated the socketpair() docstring and documentation to explain that the
...
default famility is AF_UNIX if defined for the platform, otherwise the
default is AF_INET.
2004-08-23 05:16:23 +00:00
656f7e4b40
Removed redundant versionadded{} for NDIFF_DIFF. Virtually everything
...
in this section is new in 2.4, and that's all mentioned already in
versionadded{} thingies at the end of the section. It hurts readability
to have them after every line <wink>.
2004-08-23 00:26:42 +00:00
8bd5cb342c
Add version info
2004-08-22 21:48:37 +00:00
c6cbab0db4
Added NDIFF_DIFF option.
2004-08-22 19:43:28 +00:00
d3b0babf66
SF bug #1013760 : Error in Chapter 4 of Tutorial
...
Fit a nit.
2004-08-22 15:24:33 +00:00
5268c3955a
sf #1009373 , #1005936 . fix underscores in index entries in PDF files.
...
I couldn't test this, but it didn't break anything and the patch
reported fixed the problem.
Bugfix candidate.
2004-08-21 15:13:52 +00:00
7109b287cf
Fix grammar, spotted by Hye-Shik Chang
2004-08-20 23:13:26 +00:00
8e3bec5418
Correct argument specifications of load_compiled and load_source: the file
...
argument is optional on both (the format string is "ss|O!").
2004-08-20 14:38:56 +00:00
c89061817b
Quote # as \# to make lib compile again.
2004-08-20 14:37:05 +00:00
8623b36ee0
Try to improve grammar and use versionadded
2004-08-20 02:36:27 +00:00
525b315326
Fix markup. versionchanged automatically adds a period, so remove the extra one.
2004-08-20 01:52:42 +00:00
026f8dc103
Now that they've settled down, document doctest directives.
2004-08-19 16:38:58 +00:00
336e85f56a
Patch #900727 : Add Py_InitializeEx to allow embedding without signals.
2004-08-19 11:31:58 +00:00
c6f3c8b612
fix SF bug #1008690 : Incorrect <link rel="index"> href in Tutorial
...
The make_head_and_body() function used a hardcoded value for the
<link> element for the index; this patch causes the proper output
filename to be captured during the transformation phase so it can be
used during the page assembly phase.
2004-08-19 01:37:48 +00:00
cf02e31683
Remove commented definition of the MKHOWTO macro.
2004-08-18 22:27:04 +00:00
5b75f7d19b
Remove zero-byte gif files from generated html docs
2004-08-18 22:17:44 +00:00
75b9da4aaf
Patch #995126 : Correct directory size, and generate GNU tarfiles by default.
2004-08-18 13:57:44 +00:00
ae075b6cb7
Patch #1011144 : Correct regex for coding decls.
2004-08-18 13:25:05 +00:00
deacce2c87
Patch #800236 : add HTTPResponse.getheaders().
2004-08-18 12:46:26 +00:00
01884d56f4
Deprecate sys.exitfunc in favor of the atexit module.
...
Per Guido, sys.exitfunc will be kept around for backwards compatability
but atexit will become the one preferred way to do it.
2004-08-18 02:50:00 +00:00
0ccff074cd
This is Mark Russell's patch:
...
[ 1009560 ] Fix @decorator evaluation order
From the description:
Changes in this patch:
- Change Grammar/Grammar to require
newlines between adjacent decorators.
- Fix order of evaluation of decorators
in the C (compile.c) and python
(Lib/compiler/pycodegen.py) compilers
- Add better order of evaluation check
to test_decorators.py (test_eval_order)
- Update the decorator documentation in
the reference manual (improve description
of evaluation order and update syntax
description)
and the comment:
Used Brett's evaluation order (see
http://mail.python.org/pipermail/python-dev/2004-August/047835.html )
(I'm checking this in for Anthony who was having problems getting SF to
talk to him)
2004-08-17 17:29:16 +00:00
8de636e2ae
SF bug #951482 : New module: doc versus action
...
Strengthen the warnings about creating bogus objects using the new module.
2004-08-17 02:31:55 +00:00
cb40ba1f5e
SF bug #805304 : super instances don't support item assignment
...
Document a nuance of super(). It is designed to work well with dotted
attribute lookup but not with equivalent implicit lookups using operators
or statements.
2004-08-17 02:21:45 +00:00
7ec7584813
Typo fix
2004-08-16 16:12:23 +00:00
d3fe2395b4
Minor improvements to the threading introduction:
...
* Expand the example to show a join.
* Mention the use case of I/O running concurrent with a computational
thread.
* Be a tad more forceful about recommending Queue over other approaches
to synchonization.
* Eliminate discussion around having a single interpreter. This is a
more advanced discussion that belongs in the library reference and
in a section on extending and embedding.
2004-08-16 05:11:04 +00:00
8df4e6b020
Fix punctuation typo.
2004-08-15 23:51:38 +00:00
2864b808c7
Add a notes section to the docs:
...
* Discuss representation error versus loss of significance.
* Document special values including qNaN, sNaN, +0, -0.
* Show the suprising display of non-normalized zero values.
2004-08-15 23:47:48 +00:00
5c8d29cb13
SF patch #872326 : generator expression implementation
...
(Contributed by Jiwon Seo.)
Add genexps to the reference manual.
2004-08-15 23:28:10 +00:00
e5069019e7
Add get_history_item and replace_history_item functions to the readline
...
module. Closes patch #675551 . My apologies to Michal Vitecek for taking so
long to process this.
2004-08-15 14:32:06 +00:00
b112d6ed78
bug 990669: os.path.normpath may alter the meaning of a path if it contains
...
symbolic links. This has been documented in a comment since 1992, but is now in
the library reference as well.
2004-08-14 14:41:32 +00:00
83e259a2c2
Another microburst of snail-like progress.
2004-08-13 21:55:21 +00:00
41a65ea7fe
Doctest has new traceback gimmicks in 2.4. While trying to document
...
them (which they are now), I had to rewrite the code to understand
it. This has got to be the most DWIM part of doctest -- but in context
is really necessary.
2004-08-13 03:55:05 +00:00
2e56c8a260
SF #1005913 , Patch to allow building of paper-*/dist.pdf by Jeff Epler
...
There were subsections without sections, so drop a sub.
2004-08-13 02:56:16 +00:00
ee6511b309
Fix the version number in which changes were made
2004-08-13 02:34:06 +00:00
2603960525
Markup fiddling.
2004-08-13 01:49:12 +00:00
8a3b69ca8f
Excruciatingly slow progress on the docs. Option flags / directive names
...
are documented now, and ripped out a bunch of "private name" convolutions.
2004-08-12 22:31:25 +00:00
5e897959db
This is my patch
...
[ 1004703 ] Make func_name writable
plus fixing a couple of nits in the documentation changes spotted by MvL
and a Misc/NEWS entry.
2004-08-12 18:12:44 +00:00
568671fc0f
avoid version numbers in the text where possible
2004-08-10 21:20:10 +00:00
ba100c98ad
clarify the behavior of the .first() and .last() methods for empty
...
databases
this should be backported to the release23-maint branch
2004-08-10 19:22:48 +00:00
f54ac7e0ee
Spelling fix
2004-08-10 19:01:50 +00:00
d62d507b9a
added missing documentation for UseForeignDTD() (new in 2.3)
...
someone should backport to the release23-maint branch
2004-08-10 17:18:32 +00:00
fb568ca52a
add descriptions for many of the new error codes
2004-08-10 16:47:18 +00:00
9d92d5a9ac
minor changes to make this format again
2004-08-10 15:41:03 +00:00
c2388a2b9c
Start rewriting doctest's LaTeX docs. Damn, this is slow going!
2004-08-10 01:41:28 +00:00
24884a5ccc
[Patch #1005465 ] Markup tweaks
2004-08-09 17:36:56 +00:00
7f203b847b
Add item
2004-08-09 14:48:28 +00:00
151df0794d
- make a module reference a hyperlink
...
- wrap a long line
2004-08-09 14:12:05 +00:00
830d8b8b80
fix markup nit
2004-08-09 14:06:58 +00:00
9dc19c2515
Ooops - for some reason I had the wrong versionadded...
2004-08-09 05:59:09 +00:00
331708b226
Patch #1003700 : Add socketpair function to socket module.
2004-08-09 04:51:41 +00:00
feec4533e2
Bug 1003935: xrange overflows
...
Added XXX comment about why the undocumented PyRange_New() API function
is too broken to be worth the considerable pain of repairing.
Changed range_new() to stop using PyRange_New(). This fixes a variety
of bogus errors. Nothing in the core uses PyRange_New() now.
Documented that xrange() is intended to be simple and fast, and that
CPython restricts its arguments, and length of its result sequence, to
native C longs.
Added some tests that failed before the patch, and repaired a test that
relied on a bogus OverflowError getting raised.
2004-08-08 07:17:39 +00:00
7219cbea8d
Remove MacOS 9 ref
2004-08-07 21:35:06 +00:00
c16affa811
Remove MacOS 9 refs
2004-08-07 21:33:44 +00:00
67ca703aca
[Patch #862531 ] Update version numbers.
2004-08-07 21:30:13 +00:00
2ee6a7027a
[Patch #999280 ] Update kwargs in pickle docs to match implementations
2004-08-07 20:25:55 +00:00
4eb1a00cc1
[Patch #1003861 from Dima Dorfman] Fix markup in concrete.tex:
...
PyObject* o -> PyObject *o to be consistent with the
rest of the file
- Correct markup for Py_True
- Remove duplicate description of PyBool_Check
2004-08-07 20:19:24 +00:00
672d2ba773
Use LaTeX markup
2004-08-07 20:17:48 +00:00
17e33e4c93
[Bug #914375 ] Crude modulefinder docs, but the module's code is very hard to read and it's not clear which bits are public and which aren't. The module's author should really be doing this (and using docstrings in the code, too)
2004-08-07 20:13:34 +00:00
32dbddafd5
Remove various modules that have been documented
2004-08-07 19:21:59 +00:00
cbd81556bb
[Bug #827209 ] Add footnote from Alex M. about listcomps leaking their index variables
2004-08-07 19:16:32 +00:00
59a27f1d6e
Various minor edits
2004-08-07 19:10:36 +00:00
Peter Astrand
Andrew M. Kuchling
Michael W. Hudson
Fred Drake
Raymond Hettinger
Tim Peters
Marc-André Lemburg
Facundo Batista
Greg Ward
Vinay Sajip
Johannes Gijsbers
Armin Rigo
Skip Montanaro
Barry Warsaw
Hye-Shik Chang
Brett Cannon
Neal Norwitz
Fredrik Lundh
Anthony Baxter
David Goodger
Edward Loper
Nicholas Bastin
Martin v. Löwis
Walter Dörwald
Gustavo Niemeyer
Dave Cole
Matthias Klose