mirrors/cpython
0
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2024-11-26 03:14:27 +08:00
Code Issues Packages Projects Releases Wiki Activity
21,410 Commits 6 Branches 593 Tags 2.6 GiB
a0af63b242
Commit Graph

4600 Commits

Author SHA1 Message Date
Fred Drake
806d332f02 Remove extra period. 2001-11-06 22:10:47 +00:00
Andrew M. Kuchling
1f774b062e Update obsolete e-mail address, and remove myself as a module author 2001-11-05 21:34:36 +00:00
Andrew M. Kuchling
4794f0b234 Update obsolete e-mail address 2001-11-05 21:31:33 +00:00
Andrew M. Kuchling
47ccfe2d8f Remove obsolete e-mail address 2001-11-05 21:31:15 +00:00
Andrew M. Kuchling
f010df4ee5 Update URL, and remove e-mail address reference (readers can get it from 
the Web page)
 2001-11-05 21:30:10 +00:00
Andrew M. Kuchling
10f9c075b9 Remove obsolete e-mail address 2001-11-05 21:25:42 +00:00
Barry Warsaw
2bb077f630 Finally fleshed out the examples section with 4 code samples! Some of 
my own doing, some originally written by Matthew Dixon Cowles.
 2001-11-05 17:50:53 +00:00
Andrew M. Kuchling
c44403995e Remove email*.tex subsections; they're all \input by email.tex 2001-11-05 01:55:43 +00:00
Andrew M. Kuchling
43dc1fc926 Minor grammar and typo fixes 2001-11-05 01:55:03 +00:00
Tim Peters
169ded0d68 Finish SF patch 477059: __del__ on new classes vs. GC. 
Just doc and NEWS here, about the change in gc.garbage meaning.
 2001-11-03 19:57:21 +00:00
Tim Peters
7533587d43 Improved error msg when a symbolic group name is redefined. Added docs 
and NEWS.  Bugfix candidate?  That's a dilemma for Anthony <wink>:  /F
did fix a longstanding bug here, but the fix can cause code to raise an
exception that previously worked by accident.
 2001-11-03 19:35:43 +00:00
Andrew M. Kuchling
bc4a1c2588 [Patch #476612] Change docs to describe PEP247 interface 2001-11-02 21:44:09 +00:00
Fred Drake
622087a3ed Fix stupid bug recently introduced for DVI version of the docs (used to 
generate PostScript).
 2001-11-02 20:53:19 +00:00
Fred Drake
d9272d6f11 Add deprecation notice to statcache. 2001-11-02 20:20:19 +00:00
Fred Drake
67bd68392c Make sure there are no weird nesting behaviors; the PDF version will not 
format if there are (building the "bookmarks" for the reader breaks).
 2001-11-02 19:41:23 +00:00
Fred Drake
3808045d00 Correct misspelling of "separate" in two places. 
This closes SF bug #476898.
 2001-11-01 19:48:01 +00:00
Andrew M. Kuchling
2dab9c7d9b Fix markup typo 2001-10-31 13:16:10 +00:00
Andrew M. Kuchling
bbde5880a5 Add paragraph about difflib suggested by David Goodger 
Bump version number
 2001-10-31 13:13:36 +00:00
Andrew M. Kuchling
72a7fb78cb Fix grammar error 2001-10-30 22:18:21 +00:00
Andrew M. Kuchling
433b5c4d34 Rewrites and additions resulting from today's feedback 2001-10-30 21:36:04 +00:00
Fred Drake
345b8df2c4 Always use --dvips-safe when generating HTML for the standard documentation 
since we do not have anything that causes dvips to be run except when
PostScript is specifically requested, which is a separate target.
 2001-10-30 16:28:46 +00:00
Fred Drake
3ce28e4bd0 Add a new option, --dvips-safe, which sets the $DVIPS_SAFE option in 
LaTeX2HTML.  This is not safe to do in general (for the reasons LaTeX2HTML
protects against dvips to begin with), but is safe if we do not actually
need to run dvips.  Note that we also assume it is safe if the user
specifically requests PostScript generation.  See the comments for further
explanation.
 2001-10-30 16:09:51 +00:00
Andrew M. Kuchling
7aa63c245f Various minor rewrites 
Bump version number
 2001-10-30 14:35:03 +00:00
Andrew M. Kuchling
7cc13de554 Corrections noted by Michael McLay 2001-10-30 14:22:11 +00:00
Fred Drake
99de218cfc Promote file objects out of the "Other Objects" category, so they become 
visible in the table of contents.
 2001-10-30 06:23:14 +00:00
Fred Drake
b4ea9d0502 Promote built-in functions to come before built-in types. 2001-10-30 06:22:02 +00:00
Tim Peters
003047a5f2 Mention the new file() builtin in the section on file objects. 2001-10-30 05:54:04 +00:00
Tim Peters
a427a2b8d0 Rename "dictionary" (type and constructor) to "dict". 2001-10-29 22:25:45 +00:00
Fred Drake
e59feb5edc Revise the PDF support in the LaTeX style sheet. This still isn't quite 
right, but the tests for whether we are generating PDF are a bit more
readable, and some unnecessary indirection has been removed.
 2001-10-29 21:02:28 +00:00
Andrew M. Kuchling
1117d930fa dictionary -> dict 2001-10-29 20:37:47 +00:00
Andrew M. Kuchling
4f9e220e7f Fix two typos noted by Jens Quade 
Bump version number
 2001-10-29 18:09:42 +00:00
Fred Drake
589abb7212 Add additional information on exceptions from time.mktime() and related to 
improper time tuples passed to various functions.  Based on comments from
Andreas Jung.
 2001-10-29 18:01:24 +00:00
Fred Drake
1b58bff8a0 More refcount information. 2001-10-29 17:43:14 +00:00
Fred Drake
b0109ffb3b Ignore all *.tex files in the typesetting output directories since there are 
a bunch of them now.
 2001-10-29 17:42:17 +00:00
Fred Drake
520b0093db Make sure we generate versions of each file in the Python/C API manual with 
reference-count annotations; this is needed for the typeset forms of the
manuals.
 2001-10-29 17:40:40 +00:00
Andrew M. Kuchling
2836907bbb Fix some markup errors noted by MH 
Use attribute assignment to illustrate __slots__ raising an error
 2001-10-29 15:47:33 +00:00
Fred Drake
b0c079e3e5 PyObject_CallFunctionObArgs() ---> PyObject_CallFunctionObjArgs() 
PyObject_CallMethodObArgs() ---> PyObject_CallMethodObjArgs()
 2001-10-28 02:39:03 +00:00
Andrew M. Kuchling
cf31d5d5d0 Fill in remaining XXX spots 
- Describe UnpackTuple()
        - Credit __unicode__ to MAL
Use \pep macro everywhere in body text.
   (Listening to "The Great Gate of Kiev" -- appropriately triumphal
    music for this check-in...)
 2001-10-26 20:37:55 +00:00
Fred Drake
e21e2bb121 Fix up a number of small problems with the DOM documentation. 
There's still a lot to do, but it's better now.
 2001-10-26 20:09:49 +00:00
Andrew M. Kuchling
b83769cb82 Finish off the type/class section; I don't think there's much else 
to be covered in an overview article like this.
 2001-10-26 20:07:03 +00:00
Fred Drake
41cf5e0069 Remove unused variable. 2001-10-26 19:50:26 +00:00
Fred Drake
ef428a292a Explain what [].insert() does when the target index is negative. 2001-10-26 18:57:14 +00:00
Fred Drake
d5be3b75dd Add notes pointing out that these classes are kept for backward compatibility 
and suggeest that new code that does not require compatibility with older
Python versions subclass dictionary, list, or str.
 2001-10-26 18:37:27 +00:00
Fred Drake
7408da54e2 Many, many small fixes and improvements, most suggested by Detlef Lannert. 2001-10-26 17:40:22 +00:00
Fred Drake
c44e9eca66 Added docs for PyObject_CallFunctionObArgs() and PyObject_CallMethodObArgs(). 
Minor cleanups & markup consistency fixes.
 2001-10-26 16:38:38 +00:00
Fred Drake
81c7aa2c7b Added refcount data for PyObject_CallFunctionObArgs() and 
PyObject_CallMethodObArgs().
 2001-10-26 16:29:22 +00:00
Fred Drake
ef7d08a661 Some style changes and typo fixes. 2001-10-26 15:04:33 +00:00
Fred Drake
fb6499fd9c Clean up the tables of child links generated by stock LaTeX2HTML so we get 
consistent (lack of) vertical space between sections, and remove some of the
unnecessary cruft that was added in (finally we get to *remove* something
that got generated!).
 2001-10-26 14:16:23 +00:00
Fred Drake
de3d060eb2 Typo: destuction --> destruction 
Reported by Thomas Heller.
 2001-10-26 11:27:54 +00:00
Tim Peters
1fc240e851 Generalize dictionary() to accept a sequence of 2-sequences. At the 
outer level, the iterator protocol is used for memory-efficiency (the
outer sequence may be very large if fully materialized); at the inner
level, PySequence_Fast() is used for time-efficiency (these should
always be sequences of length 2).

dictobject.c, new functions PyDict_{Merge,Update}FromSeq2.  These are
wholly analogous to PyDict_{Merge,Update}, but process a sequence-of-2-
sequences argument instead of a mapping object.  For now, I left these
functions file static, so no corresponding doc changes.  It's tempting
to change dict.update() to allow a sequence-of-2-seqs argument too.

Also changed the name of dictionary's keyword argument from "mapping"
to "x".  Got a better name?  "mapping_or_sequence_of_pairs" isn't
attractive, although more so than "mosop" <wink>.

abstract.h, abstract.tex:  Added new PySequence_Fast_GET_SIZE function,
much faster than going thru the all-purpose PySequence_Size.

libfuncs.tex:
- Document dictionary().
- Fiddle tuple() and list() to admit that their argument is optional.
- The long-winded repetitions of "a sequence, a container that supports
  iteration, or an iterator object" is getting to be a PITA.  Many
  months ago I suggested factoring this out into "iterable object",
  where the definition of that could include being explicit about
  generators too (as is, I'm not sure a reader outside of PythonLabs
  could guess that "an iterator object" includes a generator call).
- Please check my curly braces -- I'm going blind <0.9 wink>.

abstract.c, PySequence_Tuple():  When PyObject_GetIter() fails, leave
its error msg alone now (the msg it produces has improved since
PySequence_Tuple was generalized to accept iterable objects, and
PySequence_Tuple was also stomping on the msg in cases it shouldn't
have even before PyObject_GetIter grew a better msg).
 2001-10-26 05:06:50 +00:00
Fred Drake
af07b2c34f Add yet more markup that let's a stylesheet pick out a small bit of the 
presentation.  This is acceptable since it only occurs in the formatted
output and does not affect the document markup.
 2001-10-26 03:09:27 +00:00
Fred Drake
7f10cce4c1 Enforce a bit of markup consistency. 
When describing a Boolean return value, use "true" and "false" instead of
"1" and "0".
Style-guide conformance:  no "iff" -- to obscure for many readers.  ;-(
 2001-10-26 03:04:23 +00:00
Fred Drake
3a2c462436 Minor textual adjustment, and style-guide conformance (no use of "iff"). 2001-10-26 03:00:39 +00:00
Barry Warsaw
107771a228 Applying proposed patch for bug #474583, optional support for 
non-standard but common types.  Including Martin's suggestion to add
rejected non-standard types from patch #438790.  Specifically,

guess_type(), guess_extension(): Both the functions and the methods
grow an optional "strict" flag, defaulting to true, which determines
whether to recognize non-standard, but commonly found types or not.

Also, I sorted, reformatted, and culled duplicates from the big
types_map dictionary.  Note that there are a few non-equivalent
duplicates (e.g. .cdf and .xls) for which the first will just get
thrown away.  I didn't remove those though.

Finally, use of the module as a script as grown the -l and -e options
to toggle strictness and to do guess_extension(), respectively.

Doc and unittest updates too.
 2001-10-25 21:49:18 +00:00
Fred Drake
61f794918f Typo: NamedNodeList --> NamedNodeMap 2001-10-25 20:42:57 +00:00
Fred Drake
847c51a181 Slightly better conformance to the Python C style guide. 2001-10-25 15:53:44 +00:00
Fred Drake
af876d77e0 One more LaTeX-ism that we'd rather ignore. 2001-10-25 15:14:57 +00:00
Fred Drake
a281665972 No need to run make twice here. 2001-10-25 15:13:30 +00:00
Fred Drake
0099d8f8fb Update the rules so that changes to the HTML stylesheet cause appropriate 
work to be done, but do not require the HTML to be re-built.
 2001-10-25 15:12:31 +00:00
Fred Drake
bc006af3d0 Make the deprecation notice use the same form as other such notices. 
This has sat around in a deprecated state for a *long* time!
 2001-10-24 21:56:59 +00:00
Fred Drake
0559d95fd6 Minor revision of the text. 2001-10-24 21:10:52 +00:00
Fred Drake
08fd51509c When describing "import *", add a level of indirection between "*" and the 
set of names imported (the "public names"), adding a definition of "public
names" that describes the use of __all__.
This closes SF bug #473986.

Flesh out the vague reference to __import__().
 2001-10-24 19:50:31 +00:00
Fred Drake
c84f2c5068 Documentation for the new PyArg_UnpackTuple() function. 2001-10-23 21:10:18 +00:00
Andrew M. Kuchling
4855b02554 Fill out section on how to write a new-style class 2001-10-23 20:26:16 +00:00
Tim Peters
98791affc8 Doc and NEWS changes due to Jeremy adding traceback objects to gc. 2001-10-23 01:59:54 +00:00
Barry Warsaw
d05e051aa7 Fixed an example in the use of email.Utils.getaddresses(). The 
failobj has to be a list or the `+' can fail.
 2001-10-22 20:53:45 +00:00
Fred Drake
a219b411af Add better support for Mozilla's use of <link> elements. 2001-10-22 16:57:49 +00:00
Andrew M. Kuchling
32e3232a55 Update bug/patch counts 2001-10-22 15:32:05 +00:00
Fred Drake
f10584cb11 Do a little bit more to try and add <link> elements to the header, not that 
Mozilla 0.9.5 can make intelligent use of them.  Specifically, this causes
the "Acknowledgements" and "Global Module Index" pages to acquire "up"
links in the Mozilla "Site Navigation Bar".
This partially responds to SF bug #469772.
 2001-10-22 15:07:16 +00:00
Fred Drake
5d9a6b575c Clarify that the resource module does not attempt to mask platform 
differences by defining symbols not defined on particular platforms.
This closes SF bug #473433.
 2001-10-22 14:18:23 +00:00
Andrew M. Kuchling
beb385568c Add correction from /F about SRE 
\filename{} should be \file{}
 2001-10-22 14:11:06 +00:00
Andrew M. Kuchling
279e744573 Partly fill out the PEP 252 section 2001-10-22 02:03:40 +00:00
Andrew M. Kuchling
8b42f01667 A bunch of minor rewordings 2001-10-22 02:00:11 +00:00
Andrew M. Kuchling
9dbc0bcf9d Update description of border() 2001-10-20 16:07:41 +00:00
Fred Drake
0aa811c527 Use the \note and \warning macros where appropriate. 2001-10-20 04:24:09 +00:00
Fred Drake
64a5aaf05c Describe the content given as the parameter to the \note and \warning macros 
in more detail, and use them where appropriate.
 2001-10-20 04:18:14 +00:00
Fred Drake
0c77cf15c0 Additional rules to support the iSilo conversion. 2001-10-19 21:12:57 +00:00
Fred Drake
5a4bdb7be8 Hush up CVS. 2001-10-19 21:09:19 +00:00
Fred Drake
cc2e306592 Support for the iSilo conversion. 2001-10-19 21:08:36 +00:00
Fred Drake
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
Marc-André Lemburg
b5507ecd3c Additional test and documentation for the unicode() changes. 
This patch should also be applied to the 2.2b1 trunk.
 2001-10-19 12:02:29 +00:00
Barry Warsaw
e736d93eab Added a note about the somewhat kludgey behavior of the message 
epilogue, based on the discussion in this SF bug report:

https://sourceforge.net/tracker/index.php?func=detail&aid=472481&group_id=25568&atid=384678
 2001-10-19 04:34:42 +00:00
Guido van Rossum
b6c1d5239c SF patch #443759: Add Interface to readline's add_history 
This was submitted by Moshe, but apparently he's too busy to check it
in himself.  He wrote:

    Here is a function in GNU readline called add_history,
    which is used to manage the history list. Though Python
    uses this function internally, it does not expose it to
    the Python programmer. This patch adds direct interface
    to this function with documentation.

    This could be used by friendly modules to "seed" the
    history with commands.
 2001-10-19 01:18:43 +00:00
Fredrik Lundh
a5e616510e changed misleading argument name 2001-10-18 20:58:25 +00:00
Barry Warsaw
91b81c4802 Some minor clarifications for find()'s arguments based on SF bug 
#463572.  Closing.
 2001-10-18 19:41:48 +00:00
Fred Drake
db7287c0f5 Straighten out the exec*() function descriptions a bit, and clarify a few 
points in the spawn*() description.
 2001-10-18 18:58:30 +00:00
Fred Drake
9ae09947f4 Bump version number. 
Remove inconsistent use of HTMLDIR.
 2001-10-18 18:46:22 +00:00
Fred Drake
77165d039f Bump release information. 2001-10-18 18:41:12 +00:00
Fred Drake
316141b333 Fix typo reported by Michael Soulier. 2001-10-18 15:22:23 +00:00
Fred Drake
ca836f7e65 Function descriptions must end as well as start! 2001-10-18 14:26:08 +00:00
Martin v. Löwis
c405133fce Elaborate on types and meaning of the setgroups arguments. 2001-10-18 14:07:12 +00:00
Martin v. Löwis
61c5edf6fc Expose setgroups. Fixes feature request #468116. 2001-10-18 04:06:00 +00:00
Tim Peters
61acf067ac SF bug [#471111] inspect.getframeinfo() needs docs. 
TeX-ified its docstring.
 2001-10-16 23:01:06 +00:00
Guido van Rossum
3c28863e08 Partial patch from SF #452266, by Jason Petrone. 
This changes Pythread_start_thread() to return the thread ID, or -1
for an error.  (It's technically an incompatible API change, but I
doubt anyone calls it.)
 2001-10-16 21:13:49 +00:00
Jeremy Hylton
511e2cacc4 [ #403753 ] zlib decompress; uncontrollable memory usage 
Mostly by Toby Dickenson and Titus Brown.

Add an optional argument to a decompression object's decompress()
method.  The argument specifies the maximum length of the return
value.  If the uncompressed data exceeds this length, the excess data
is stored as the unconsumed_tail attribute.  (Not to be confused with
unused_data, which is a separate issue.)

Difference from SF patch: Default value for unconsumed_tail is ""
rather than None.  It's simpler if the attribute is always a string.
 2001-10-16 20:39:49 +00:00
Guido van Rossum
7a59445e37 Document required return values -1, 0, 1 for tp_compare handler, as 
suggested in SF patch #424475.  Also document exception return.
 2001-10-16 20:32:05 +00:00
Fred Drake
5bf1ecd503 Update the description of PyTrace_EXCEPT. 2001-10-16 19:23:55 +00:00
Fred Drake
ab9b238ced Fix a few usage and style-guide conformance issues. 2001-10-16 19:22:51 +00:00
Fred Drake
64d7863797 Added information about setprofile() and settrace() hooks being thread- 
specific, and updated some of the comments about the profile hook.
This closes SF bug #471725.
 2001-10-16 14:54:22 +00:00
Fred Drake
a815916472 Fix thinko in a comment about seeking with a file object. 
Reported by Francesco Trentini.
 2001-10-16 03:25:00 +00:00
Fred Drake
327798ca4a Added notes to clarify that binascii.crc32(), zlib.crc32(), and 
zlib.adler32() are not suitable as general hash functions.
 2001-10-15 13:45:49 +00:00
Fred Drake
0fae49fc7b Added documentation for the functions listed in marshal.h. 
Prompted by Jim Ahlstrom.  This closes SF patch #470614.
 2001-10-14 04:45:51 +00:00
Fred Drake
c65b3d95b6 Add entries for the newly split C API manual. 2001-10-12 19:02:35 +00:00
Fred Drake
3adf79e3e2 Break the Python/C API manual into smaller files by chapter. This manual 
has grown beyond what font-lock will work with using the default (X)Emacs
settings.

Indentation of the description has been made consistent, and a number of
smaller markup adjustments have been made as well.
 2001-10-12 19:01:43 +00:00
Jeremy Hylton
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
Barry Warsaw
c7f8b86307 Describe the HeaderParser class. 2001-10-11 15:45:05 +00:00
Tim Peters
8cd015c701 A copy-and-paste job forget the "paste" half. 2001-10-09 20:54:23 +00:00
Tim Peters
659a60311d Allow the profiler's calibration constant to be specified in the constructor 
call, or via setting an instance or class vrbl.
Rewrote the calibration docs.
Modern boxes are so friggin' fast, and a profiler event does so much work
anyway, that the cost of looking up an instance vrbl (the bias constant)
per profile event just isn't a big deal.
 2001-10-09 20:51:19 +00:00
Barry Warsaw
dca939899d Fix minor cut-and-paste typo. 2001-10-09 19:37:51 +00:00
Fred Drake
e0063d20a7 Update the documentation for the isinstance() function to reflect recent 
changes in the implementation.
Indented all descriptions consistently.
 2001-10-09 19:31:08 +00:00
Barry Warsaw
a55d132f08 Add documentation for the MIMEAudio class/module, contributed by 
Anthony Baxter.
 2001-10-09 19:14:17 +00:00
Fred Drake
938a8d723c Improve the documentation for the os.P_* constants used with the os.spawn*() 
functions to include information about how they affect the operation of
those functions when used as the "mode" parameter.
This closes SF bug #468384.

Added warnings to the os.tempnam() and os.tmpnam() functions regarding their
security problem.  These warning mirror the warnings added to the runtime
by Skip Montanaro.
 2001-10-09 18:07:04 +00:00
Fred Drake
92350b3a1f New markup: \note{...} and \warning{...} 2001-10-09 18:01:23 +00:00
Fred Drake
6959a2fcd7 Note that the values for Boolean options are case-insensitive. 2001-10-09 14:58:24 +00:00
Fred Drake
b35f0ce2b8 Update the description of getboolean() to reflect the changes made by 
SF patch #467580.
 2001-10-08 16:03:20 +00:00
Tim Peters
0a1fc4e389 Remove code and docs for the OldProfile and HotProfile classes: code 
hasn't worked in years, docs were wrong, and they aren't interesting
anymore regardless.
 2001-10-07 03:12:08 +00:00
Fred Drake
8c2c3d301b Update the documentation to reflect the changes to ReferenceError. 2001-10-06 06:10:54 +00:00
Fred Drake
bf88b68f38 Add documentation for the public API for weak reference objects. 2001-10-05 22:03:58 +00:00
Tim Peters
9835206268 A regexp example was rendered as 
foo\d
when it was clearly intended to render as
    foo$
Fred, is this a right way to fix it?  If not, the earlier place in the
same paragraph that does render as
    foo$
is also wrong.
 2001-10-05 20:06:47 +00:00
Fred Drake
e8f47bb93a Remove some long-unsupported Mac OS modules. 
This closes SF patch #460737.
 2001-10-05 16:49:31 +00:00
Martin v. Löwis
244edc8985 Add chroot call. Implements feature #459267. 2001-10-04 22:44:26 +00:00
Fred Drake
fcc16330a4 Update a couple of old addresses that point to CNRI. 2001-10-04 20:40:07 +00:00
Tim Peters
3899d74c10 Make clear that tuple() accepts the same kind of arguments as list(). 2001-10-04 06:53:20 +00:00
Fred Drake
6f3d82693a Expand the documentation of the low-level tracing/profiling interface. 
This reflects what is currently in CVS, which may change before 2.2 is final.
 2001-10-03 21:52:51 +00:00
Tim Peters
0481d24dd5 CVS patch [#466628] Doc changes for doctest patch (#466616), from 
Tim Hochberg.  Doctest no longer searches imported objects.
 2001-10-02 21:01:22 +00:00
Fred Drake
d90f509b8f Fredrik tells me the truefalse parameter for boolean() is not part of the 
public interface, so we can simplify the documentation.
 2001-10-01 21:05:30 +00:00
Tim Peters
1350c07de3 Removed stray backslash (a typo -- my fault). 2001-10-01 20:25:26 +00:00
Tim Peters
20524dbf36 The description of dictionary comparison was out of date. Rather than 
try to explain the complex general scheme we actually use now, I decided
to spell out only what equality means (which is easy to explain and
intuitive), leaving the other outcomes unspecified beyond consistency.
 2001-10-01 20:22:45 +00:00
Fred Drake
6c81e2a44f "boolean" --> "Boolean" (per the style guide). 2001-10-01 17:04:10 +00:00
Fred Drake
0f0380a25f Fix some minor style-guide conformance bugs. 2001-10-01 17:04:10 +00:00
Fred Drake
fe95e65668 Straighten out some markup. 
"boolean" --> "Boolean" (per the style guide).
 2001-10-01 17:03:48 +00:00
Fred Drake
73921b0eec Refer to the objects which define __len__(), __*item__(), and __iter__() 
as container objects rather than as mapping objects (in the index entries).
Change the section heading and intro sentence to be a little more general,
since that's how things have actually evolved.
 2001-10-01 16:32:13 +00:00
Fred Drake
e9ba525c2b Clarify comments about mailbox objects being iterable. 2001-10-01 15:49:56 +00:00
Guido van Rossum
e7877df595 Docs for SF patch #462628 2001-10-01 13:50:15 +00:00
Martin v. Löwis
0daad598d0 Patch #462122: add readline startup and pre_event hooks. 2001-09-30 21:09:59 +00:00
Martin v. Löwis
16dc7f44b1 Patch #462190, patch #464070: Support quoted printable in the binascii module. 
Decode and encode underscores for header style encoding. Fixes bug #463996.
 2001-09-30 20:32:11 +00:00
Tim Peters
af5910f025 The execfile() docs imply it acts on locals same as exec. But in truth 
it acts more like assigning to keys in locals(), i.e. modifications to
function locals aren't reflected in the locals when execfile() returns.
 2001-09-30 06:32:59 +00:00
Tim Peters
1c33daf143 Correct docs for long(float). 2001-09-30 06:18:26 +00:00
Tim Peters
d38b1c74f3 SF [#466125] PyLong_AsLongLong works for any integer. 
Generalize PyLong_AsLongLong to accept int arguments too.  The real point
is so that PyArg_ParseTuple's 'L' code does too.  That code was
undocumented (AFAICT), so documented it.
 2001-09-30 05:09:37 +00:00
Fred Drake
ac1af8093e Handle PEP references the same way RFC references. 2001-09-29 19:07:22 +00:00
Guido van Rossum
0d68246f01 Fix two typos in the text about compile(), and add two caveats from 
recent user feedback: you must end the input with \n and you must use
\n, not \r\n to represent line endings.
 2001-09-29 14:28:52 +00:00
Skip Montanaro
a1c3662e84 forgot to mark use of StringType and UnicodeType in the text. 2001-09-29 13:53:21 +00:00
Skip Montanaro
c7ba0c4c24 added description of StringTypes object 2001-09-29 13:49:41 +00:00
Fred Drake
583061a10f Fix up whitespace in <args> elements; reduce sequences of consecutive 
whitespace characters to a single space.
Small changes elsewhere, mostly to clean up the code a little.
 2001-09-29 05:05:25 +00:00
Fred Drake
2b05ca3454 Minor markup improvement. 2001-09-29 05:01:59 +00:00
Tim Peters
599db7de63 The list.sort() docs require a function that returns -1, 0 or +1. That's 
never been true, and in particular implies cmp() can't be used(!).  Get
closer to the truth.
 2001-09-29 01:08:19 +00:00
Fred Drake
7988e0249c Move XML-RPC-related docs to the "Internet Protocols" chapter. 
Add entry for the SimpleXMLRPCServer module.
 2001-09-28 22:03:40 +00:00
Fred Drake
06c61b14fe Add entry for the SimpleXMLRPCServer module. 2001-09-28 22:02:49 +00:00
Fred Drake
e486e0d066 Preliminary documentation for the SimpleXMLRPCServer module. 2001-09-28 22:02:21 +00:00
Andrew M. Kuchling
d4707e3b62 Minor additions and rewrites. 
Bump version number.
 2001-09-28 20:46:46 +00:00
Fred Drake
3c171d1b9f Convert to string methods. 
For the real document element, make sure the prolog is migrated into
the document element so it isn't left stranded.

Make fixup_trailing_whitespace() whitespace do what was really intended.

Add the *desc environments used in the C API manual to the list of
things that can exist at the paragraph level so they don't get wrapped
in <para>...</para>.
 2001-09-28 17:14:35 +00:00
Fred Drake
3c10c68c0e Use consistent version annotations instead of something ad hoc. 2001-09-28 16:57:16 +00:00
Fred Drake
0f9bfd3dda Convert most uses of the string module to string methods. 
(string.join() lives!)
 2001-09-28 16:26:13 +00:00
Fred Drake
bbf7a407e8 Added note about non-support of UNC paths on Windows. 
This fixes SF bug #465447.
 2001-09-28 16:14:18 +00:00
Fred Drake
b387860c70 State that encode() and encodestring() append a newline to the input data 
if it does not already end with a newline.
This fixes SF bug #463330.
 2001-09-28 16:01:46 +00:00
Fred Drake
33f4d6d1db Add entries for the email and compiler packages. 2001-09-27 20:11:07 +00:00
Fred Drake
90e687863b Markup adjustments. 2001-09-27 20:09:39 +00:00
Fred Drake
d443d8cc00 Added dependencies for the compiler and email packages. 
(Migrate to branch, along with new files compiler.tex and asttable.tex.)
 2001-09-27 20:08:20 +00:00
Fred Drake
e2f9917f9f Migrate the compiler documentation from the Tools/compiler/doc/ directory. 
Changes made to make it work in the new location.
 2001-09-27 20:06:07 +00:00
Fred Drake
876389e5d8 Do not distinguish \refmodule from \module in the generated output; 
whether or not a link will be generated will depend on the link database.
Add a couple of explanatory comments for one of the stranger constructs
(giving input an empty name).
 2001-09-27 17:01:59 +00:00
Fred Drake
9213b7a961 Re-write <ulink> elements as described in the conversion spec. 2001-09-27 16:52:22 +00:00
Fred Drake
baacc08ead Turn \input, \include, and \verbatiminput into XInclude elements instead 
of something ad-hoc.
 2001-09-27 15:49:23 +00:00
Fred Drake
b6fa78930e Add support for some more markup that had slipped in. 
Fixed a typo in a comment.
 2001-09-27 04:18:39 +00:00
Fred Drake
3fc291a1d7 Fix some markup errors. 2001-09-27 04:17:20 +00:00
Fred Drake
b802a1e7fa Markup adjustment: \[...\] is math markup and does not translate well when 
used with text as was done here.  Fixed so that the typeset version wraps
the warning text and the HTML version does not create images of the warning
text.
 2001-09-27 04:16:27 +00:00
Fred Drake
3ab0ac7cd4 Remove comment that no longer applies. 2001-09-26 22:26:45 +00:00
Barry Warsaw
c5f8fe3a27 Updates do email package documentation for markup, style, and 
organization.
 2001-09-26 22:21:52 +00:00
Fred Drake
479384e1ff Move the styling for the HTML version of \mailheader into the CSS file. 
In both the HTML and typeset versions of the documentation, add a colon
after the name of a mail header so that it is more easily distinguished
from other text.
 2001-09-26 18:46:36 +00:00
Fred Drake
203d91a461 Note that the colon following a mail header name should not be included 
when using the \mailheader markup.
Change a couple of inline examples to show the markup rather than the
result.
 2001-09-26 18:43:20 +00:00
Greg Ward
e22871e9ed Typo fix. 2001-09-26 18:12:49 +00:00
Fred Drake
8b3a7b58b9 Move the \mailheader description to the right place. 
Clarify the \mimetype description; it can be used to refer to a part of a
MIME type name, so \mimetype{text} or \mimetype{plain} can be used, not
just \mimetype{text/plain}.
 2001-09-26 17:01:58 +00:00
Fred Drake
a6a885b6aa Start making some markup adjustments; Barry has indicated he will work on 
this before we finish the integration, along with some restructuring.
 2001-09-26 16:52:18 +00:00
Barry Warsaw
5e634638e6 The email package documentation, currently organized the way I think 
Fred prefers.  I'm not sure I like this organization, so it may change.
 2001-09-26 05:23:47 +00:00
Fred Drake
29a67ced72 Update to support \mailheader and 5-column tables. 2001-09-25 20:58:13 +00:00
Fred Drake
9eda3aebb8 Simplify a helper by returning fewer values. 2001-09-25 20:57:36 +00:00
Fred Drake
5055545fc0 Clarified some points about the interface to the mmap() function. 
This closes SF bug #448918.
 2001-09-25 19:00:08 +00:00
Fred Drake
c0765c2381 Minor changes. 2001-09-25 16:32:02 +00:00
Fred Drake
c825280ea5 Revise the example to be more resiliant in the face of continued use after 
the object has been pickled; don't mutate the instance dict in the
__getstate__() method.  Other minor changes for style.  Broke up the
displayed interactive session to get better page-breaking behavior for
typeset versions, and to point out an important aspect of the example.

This closes SF bug #453914.
 2001-09-25 16:29:17 +00:00
Fred Drake
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
Fred Drake
74f1a563ff Fix a URL (closing SF patch #462195). 
Cleaned up a bunch of XXX comments containing links to additional
information, replacing them with proper references.
Replaced "MacOS" with "Mac OS", since that's what the style guide says.
 2001-09-25 15:12:41 +00:00
Fred Drake
f244b2e47c Add more signature information and some descriptions for the new APIs 
introduced in Python 2.2.
Add documentation for the slice object interface (not complete).
Added version annotations for several of the Python 2.2 APIs already
documented.
 2001-09-24 15:31:50 +00:00
Fred Drake
23a78cf1c1 Add more reference count information. 2001-09-24 15:29:47 +00:00
Andrew M. Kuchling
1497b62827 Add link to Unix Review's 2.2 article 
Fix two errors
 2001-09-24 14:51:16 +00:00
Tim Peters
2c9aa5ea8d Generalize file.writelines() to allow iterable objects. 2001-09-23 04:06:05 +00:00
Fred Drake
d61d0d3f6d Added API information for the PyCallIter_*() and PySeqIter_*() functions. 
Added signatures for some new PyType_*() functions.
 2001-09-23 02:05:26 +00:00
Tim Peters
8a9c284437 Make difflib.ndiff() and difflib.Differ.compare() generators. This 
restores the 2.1 ability of Tools/scripts/ndiff.py to start producing
output before the entire comparison is complete.
 2001-09-22 21:30:22 +00:00
Tim Peters
e0b2d7ac9a Add a function to compute a class's method resolution order. This is 
easy for 2.2 new-style classes, but trickier for classic classes, and
different approaches are needed "depending".  The function will allow
later code to treat all flavors of classes uniformly.
 2001-09-22 06:10:55 +00:00
Fred Drake
038d26410d Note that files are iterable; describe what the iterator returns. 
This closes SF bug #463738.
 2001-09-22 04:34:48 +00:00
Fred Drake
56dd35bd44 Bump version number. 2001-09-21 21:18:16 +00:00
Fred Drake
c69205526a Added reference to Tutorial section on user-defined exceptions for 
information on defining new exceptions.
This closes SF bug #443559.
 2001-09-21 21:12:30 +00:00
Fred Drake
13af42822c Exceptions in interactive examlpes did not always include the indication of 
the source file using "in ?".

Added a description of the bare "raise" statement.

Added more description and examples for user-defined exceptions; this
is part of a response to SF bug #443559.
 2001-09-21 21:10:05 +00:00
Fred Drake
e0af35eb69 Fill in a few more descriptions for xml.parsers.expat. 2001-09-20 20:43:28 +00:00
Tim Peters
2e29bfbe1a Document new file() constructor, with the body of open()'s text, plus a 
"new in 2.2" blurb at the end.  Replace open()'s text by pointing back
to file().
 2001-09-20 19:55:29 +00:00
Fred Drake
f47d8ef683 Document all the Py*_CheckExact() functions. 
Document many more of the PyLong_{As,From}*() functions.
 2001-09-20 19:18:52 +00:00
Marc-André Lemburg
494f2aea8e Docs and News item for the codecs.py additions. 2001-09-19 11:33:31 +00:00
Fred Drake
18d8d5a708 Fix minor usage and consistency nits. 2001-09-18 17:58:20 +00:00
Guido van Rossum
83eeef4b06 SF patch #461781 by Chris Lawrence: os.path.realpath - Resolve symlinks: 
Once upon a time, I put together a little function
   that tries to find the canonical filename for a given
   pathname on POSIX. I've finally gotten around to
   turning it into a proper patch with documentation.
   On non-POSIX, I made it an alias for 'abspath', as
   that's the behavior on POSIX when no symlinks are
   encountered in the path.

   Example:
   >>> os.path.realpath('/usr/bin/X11/X')
   '/usr/X11R6/bin/X'
 2001-09-17 15:16:09 +00:00
Tim Peters
5b7759f9db Fixed typo in new 'p' description. 2001-09-15 18:16:27 +00:00
Tim Peters
88091aae7e SF bug [#461674] struct 'p' format doesn't work (maybe) 
Rewrote the 'p' description.
 2001-09-15 18:09:22 +00:00
Tim Peters
ad2dc3fc44 Update the warning about transporting marshals across boxes with different 
ideas about sizeof(long).
 2001-09-14 20:40:13 +00:00
Fred Drake
f2a5f3f721 Markup adjustments for consistency. 2001-09-14 17:48:41 +00:00
Andrew M. Kuchling
1efd7ad88e Add support for SMTP TLS 2001-09-14 16:19:27 +00:00
Guido van Rossum
f7fcf5eea6 SF patch #461413 (Gerhard Häring): Add STARTTLS feature to smtplib 
This patch adds the features from RFC 2487 (Secure SMTP
   over TLS) to the smtplib module:

   - A starttls() function
   - Wrapper classes that simulate enough of sockets and
     files for smtplib, but really wrap a SSLObject
   - reset the list of known SMTP extensions at each call
     of ehlo(). This should have been the case anyway.
 2001-09-14 16:08:44 +00:00
Fred Drake
b9a96282f1 Admit that we'll never add the args for a "call" event to the profile 
and trace functions; this now declares that None will be passed for the
"call" event.
This closes SF bug/suggestion #460315.
 2001-09-13 16:56:43 +00:00
Fred Drake
ee0fe0b743 Add missing "}". 2001-09-12 00:43:13 +00:00
Jack Jansen
95fefc7a7a These modules now live under the Carbon package. 
Added a few new toolbox modules.
Noted machine dependencies for some modules.
Moved waste to undoc.tex.
 2001-09-11 21:25:10 +00:00
Jack Jansen
945bf5f627 Added applesingle, macresource, Nav and videoreader. 
Moved icopen to its alphabetical place.
Moved waste here (from toolbox).
 2001-09-11 21:24:07 +00:00
Jack Jansen
827713a660 Added a note that these are not available under Carbon (or 
OSX MachO Python).
 2001-09-11 20:18:04 +00:00
Fred Drake
85ddfbc4cb Another documentation contributor. 2001-09-11 19:58:51 +00:00
Fred Drake
098d7fae39 Document clearly that the only way to retrieve the return code from the 
child processes is to use the Popen3 and Popen4 classes.
This fixes SF bug #460512.
 2001-09-11 19:56:51 +00:00
Fred Drake
1c66f8965a Added entry for the hmac module. 2001-09-11 16:59:42 +00:00
Fred Drake
aae8da18fd Documentation for the new login() method of the smtplib.SMTP class, 
contributed by Gerhard Häring.
This is part of SF patch #460112.
 2001-09-11 16:58:00 +00:00
Fred Drake
42706803cd Documentation for the new hmac module, contributed by Gerhard Häring. 
This is part of SF patch #460112.
 2001-09-11 16:56:09 +00:00
Fred Drake
2732cb4269 Added documentation on the getfirst() and getlist() methods of the 
cgi.FieldStorage class.
This closes SF patch #453691.
 2001-09-11 16:27:03 +00:00
Fred Drake
3ae5726625 Updated infomation about libraries for alternate compilers on Windows. 
This closes SF patch #459441.
 2001-09-11 15:10:42 +00:00
Andrew M. Kuchling
d6e40e24f8 Remove some XXX markers 
Update the patch and bug counts
 2001-09-10 16:18:50 +00:00
Fred Drake
ed5a7ca5ee Work around a LaTeX2HTML bug that caused the "m" in "mutable" to be dropped 
in one place.
 2001-09-10 15:16:08 +00:00
Jack Jansen
fda3058827 Removed an erronous comment about alias files. 2001-09-10 08:55:25 +00:00
Andrew M. Kuchling
26c39bf1b5 Add section on long integer changes 
Add removal of 3-arg pow() for floats
Rewrite introduction a bit
 2001-09-10 03:20:53 +00:00
Fred Drake
2872e8a654 Do not rebuild html-$(RELEASE).tar every time we need to use it. 2001-09-06 19:35:02 +00:00
Fred Drake
c93cf676da Bump version number. 2001-09-06 19:28:06 +00:00
Fred Drake
05a73b1f9a Update link to the PyOpenGL project in the "gl" module docs. 
This closes SF bug #459256.
 2001-09-06 19:23:03 +00:00
Fred Drake
00bb329521 Document the built-in iter() function. 2001-09-06 19:04:29 +00:00
Fred Drake
7feae2d28c Bump version number. 2001-09-06 19:02:57 +00:00
Fred Drake
a20c265aba Added an additional link to NIST information on secure hashing. 
This closes SF bug #458785.
 2001-09-06 18:59:43 +00:00
Fred Drake
ba5c41d4c5 Clarified the interaction between string literals and continuation lines. 
Fixes bug reported as SF bug #453728.
 2001-09-06 18:41:15 +00:00
Fred Drake
8b09f4985c Make the examples for "Default Argument Values" more presentable and 
less hostile to newbie use at the interactive prompt.
This is in response to SF bug #458654.
 2001-09-06 18:21:30 +00:00
Fred Drake
9c75ff785a Fix parameter for PyInt_Check(). 
Add refcount information for other recently documented APIs.
 2001-09-06 18:06:46 +00:00
Fred Drake
f8d7a5d391 Document the PyMethod_* type object, functions, and macros. 2001-09-06 17:12:44 +00:00
Fred Drake
396ca574dd Document the rule that Python.h must be included before any standard 
headers.  This is the final checkin for SF bug #458768.
 2001-09-06 16:30:30 +00:00
Fred Drake
9b88b4c9e8 Do not #include <stdio.h> since Python.h already does that. 2001-09-06 16:20:33 +00:00
Fred Drake
adaca02f9e Use the standard argument convention for main(), and conform to the 
Python/C style guide.
 2001-09-06 16:17:24 +00:00
Fred Drake
4d17b303bb Several updates to cover omissions noted by Rich Salz. 
This closes SF bug #458771.
 2001-09-06 15:51:56 +00:00
Fred Drake
f5072b9314 Document the "unixfrom" attribute of the rfc822.Message class. 
Based on a patch by Skip Montanaro, this closes SF bug #458885.
 2001-09-06 15:07:55 +00:00
Martin v. Löwis
b0162f9afc Patch #416079: fix the debug string output when receiving telnet commands. 
added all the telnet options known to arpa/telnet.h
added all the options registered with IANA as of today
added the possibility for the user to have it's own option negotiation callback
 2001-09-06 08:51:38 +00:00
Skip Montanaro
bb5a465ca9 typo... 2001-09-05 19:27:13 +00:00
Martin v. Löwis
7c82a3e0fc Patch #449815: Set filesystemencoding based on CODESET. 2001-09-05 17:09:48 +00:00
Andrew M. Kuchling
2f0047af3b Note some changes that I need to write about 2001-09-05 14:53:31 +00:00
Martin v. Löwis
44f8696171 Patch #428326: New class threading.Timer. 2001-09-05 13:44:54 +00:00
Tim Peters
7eea37e831 At Guido's suggestion, here's a new C API function, PyObject_Dir(), like 
__builtin__.dir().  Moved the guts from bltinmodule.c to object.c.
 2001-09-04 22:08:56 +00:00
Andrew M. Kuchling
33a3b63e21 Correction: the Borland C port isn't fully operational yet 2001-09-04 21:25:58 +00:00
Fred Drake
757f7809e1 Add more detail to the descriptions of the shutil functions. 
This closes SF bug #458223.
 2001-09-04 18:26:27 +00:00
Fred Drake
c05fc7dd9d Added documentation for sys.maxunicode and sys.warnoptions. 
Fixed a markup error which caused an em dash to be presented as a minus sign.
This closes SF bug #458350.
 2001-09-04 18:18:36 +00:00
Tim Peters
32f453eaa4 New restriction on pow(x, y, z): If z is not None, x and y must be of 
integer types, and y must be >= 0.  See discussion at
http://sf.net/tracker/index.php?func=detail&aid=457066&group_id=5470&atid=105470
 2001-09-03 08:35:41 +00:00
Fred Drake
b86677079d Move the long minidom example to a separate file; \verbatiminput does the 
right thing with page breaks in long examples, while the verbatim
environment does not.  This causes the example to wrap to the next page
instead of overwriting the page footer and bottom margin.
 2001-09-02 06:07:36 +00:00
Fred Drake
481cf2c064 Added the "Host" header to the "GET" example. 
This closes SF bug #457100.
 2001-09-01 02:35:23 +00:00
Andrew M. Kuchling
0e03f588f5 Add Jack Jansen's explanation of the MacOS X changes 2001-08-30 21:30:16 +00:00
Tim Peters
d507dab91f SF patch #455966: Allow leading 0 in float/imag literals. 
Consequences for Jython still unknown (but raised on Jython-Dev).
 2001-08-30 20:51:59 +00:00
Neil Schemenauer
55cdc88c09 Update documentation for GC API. Closes SF patch #421893. 2001-08-30 15:24:17 +00:00
Fred Drake
3c0fc84b15 Update the links to the FIPS document that defines the Secure Hash 
Algorithm.  This closes SF bug #454917.
 2001-08-30 14:42:40 +00:00