b3cc29b493
Note that the mimetypes.MimeTypes class was added in Python 2.2.
2001-08-04 00:48:49 +00:00
d5efb17086
Add documentation for the new aspects of the mimetypes module.
...
This closes the SF bug (feature request) #439710 .
2001-08-03 21:03:14 +00:00
d86038d1be
Apply the new \mailheader macro where appropriate, and fix a few small
...
markup inconsistencies.
2001-08-03 18:39:36 +00:00
7eac0cb04c
Define the \mailheader macro and document conventions for using it.
2001-08-03 18:36:17 +00:00
30cf118cf7
Minor markup nits and slight style-guide conformance changes.
2001-08-03 17:11:33 +00:00
cb60dae6a1
Documented the runtimemodel attribute.
2001-08-03 13:19:56 +00:00
5d54879647
Fix some of the example code; the reference objects do not support a
...
get() method; just calling them is sufficient. (There was a get() method
for this in an early version of the implementation.)
Reported by Mats Wichmann.
2001-08-03 03:50:28 +00:00
8dd6ffd0ec
User-defined methods *can* contain things other than user-defined functions
...
as the callable, so use more flexible language.
2001-08-02 21:34:53 +00:00
51629c245a
Add a caveat about boundary conditions and RE concatenation, so that the
...
documents do not make an overly-strong assertion about the properties of
RE concatenation.
Add an example of RE{m,} syntax and what it will and will not match.
2001-08-02 20:52:00 +00:00
f90490ef94
Move away from apply() to using extended call syntax for some example
...
fragments when discussing equivalence of thhe C API to what a Python
programmer sees.
Added descriptions of PyEval_SetProfile() and PyEval_SetTrace().
2001-08-02 18:00:28 +00:00
044bb4d22a
Explain that __init__() methods do not get to return values.
2001-08-02 15:53:05 +00:00
388f37e6f6
Add anentry for the distutils.sysconfig module docs.
2001-08-02 15:13:58 +00:00
ab70b38367
Update some incorrect comments about the bdist commands that exist.
...
Add an entry for the distutils.sysconfig module docs.
2001-08-02 15:13:15 +00:00
25376c4f8b
Documentation for the distutils.sysconfig module.
2001-08-02 15:12:07 +00:00
905dc558f1
Cleaned up the description of readline.set_completer().
...
Thanks to Nathaniel Gray for reporting the confusion.
2001-08-01 21:42:45 +00:00
236ddd6834
Added more names.
2001-08-01 17:19:11 +00:00
20c94913de
Minor re-wording in the exaplantion of sequence comparisons.
...
This closes SF bug #445749 .
2001-08-01 17:17:13 +00:00
e74f8de385
Added an example of a string value for the replacement parameter to
...
re.sub().
This closes SF bug #446136 .
Fixed description of RE modifiers so that RE{#} and RE{#,} are more
clearly described and disambiguated (plain RE{#} had not been described
at all). Reported by Jeremy Craven via email.
2001-08-01 16:56:51 +00:00
630a63cafd
Fix description of buffer_info(), and add a note that there is a better
...
way...
This closes SF bug #444842 .
2001-08-01 16:50:49 +00:00
77707673f4
Move C-level changes into a section of their own
...
Add string.ascii_letters
Remove duplicate MBCS paragraph
2001-07-31 15:51:16 +00:00
f4ccf587f6
Rewrite MBCS paragraph following MH's suggestions, and credit him
...
Note new Windows installer
2001-07-31 01:11:36 +00:00
43211ecda2
Make some adjustments to the markup, and fix up some style-guide issues.
2001-07-29 03:41:23 +00:00
66b6e192b9
Patch #416224 : add readline completion to cmd.Cmd.
2001-07-28 14:44:03 +00:00
54f65094c3
Typo fix.
2001-07-26 21:01:21 +00:00
7321ec437b
SF bug #444510 : int() should guarantee truncation.
...
It's guaranteed now, assuming the platform modf() works correctly.
2001-07-26 20:02:17 +00:00
4f1cd8bdcb
Patch #411138 : Rename config.h to pyconfig.h. Closes bug #231774 .
2001-07-26 13:41:06 +00:00
41d7d58cc4
trivial rewording in footnote 5.
2001-07-25 16:18:19 +00:00
d61e3eab44
Add entry for the new distutils section.
2001-07-24 16:20:13 +00:00
4fefcc3ce4
Overview comments for the distutils package, with links to the distutils
...
manuals for more information. This is being added to make it easier to
find the documentation for the distutils code.
2001-07-24 16:19:24 +00:00
f1b3de8d5c
Add labels to all \section and \subsection headings for use in references.
2001-07-24 14:38:34 +00:00
c547b46c06
Be more specific about corner cases in the description of the $ RE syntax,
...
and include an example where the MULTILINE flag makes a real difference.
This closes SF bug #441600 .
2001-07-23 21:14:59 +00:00
6fd3b22847
When explaining the enterabs() method, using the modern spelling of apply(),
...
and relax the type of the argument list from tuple to sequence.
2001-07-23 19:28:09 +00:00
6fdb90c0ca
Remove self-reference from the anydbm module.
...
This closes SF patch #443788 .
2001-07-23 19:22:42 +00:00
8a2adcf812
Typo: Added missing "if".
...
This is part of SF patch #442788 .
2001-07-23 19:20:56 +00:00
c046e97dc2
Add StopIteration to the list of exceptions *not* derived from StandardError.
...
Slightly re-word discussion of SystemExit and fork().
This is part of SF patch #443788 .
2001-07-23 19:19:39 +00:00
63bc2e0fcb
Convert the use of apply(f, args) to the new spelling: f(*args).
...
This is part of SF patch #443788 .
2001-07-23 19:16:22 +00:00
3332778f35
Corrected a section reference (title was wrong).
...
Added information on the return values of PyArg_ParseTuple() and
PyArg_ParseTupleAndKeywords().
2001-07-20 20:59:49 +00:00
88fdaa7c9e
Typo: PyArgs_ParseTuple --> PyArg_ParseTuple
...
Moved the PyArg_Parse*(), Py_BuildValue() functions to the Utilities
chapter, added a minimal description and reference to the Extending
manual for Py_BuildValue().
2001-07-20 20:56:11 +00:00
6d988559a3
Added information on Py_BuildValue().
2001-07-20 20:55:31 +00:00
f69868f304
Add a missing "\" to the markup.
2001-07-20 19:03:44 +00:00
960fdf9ac3
Added the constants ascii_letters, ascii_lowercase, and ascii_uppercase
...
to the string module. This was determined to be the right approach in
SF bug #226706 .
2001-07-20 18:38:26 +00:00
a6d2a04065
More Unicode corrections from MAL to match a post-2.2a1 change
...
Mention additional new imaplib.py features
(Don't expect to see an updated version of the Web page until around the 28th
of July. Vacation time!)
2001-07-20 18:34:34 +00:00
9079164bdf
Removed unnecessary section "Unicode literals"; all the discussion is
...
already present in the "String literals" section, including comments on
the "u" prefix and the additional escape sequences used for Unicode.
This relates to SF bug #442526 .
2001-07-20 15:33:23 +00:00
0825dc2427
Fix typo in description of raw strings: "value" --> "valid"
...
This closes SF bug #443059 .
2001-07-20 14:32:28 +00:00
a3a1668904
apply patch item #416254
2001-07-20 11:04:19 +00:00
5120eac6c6
Bump release number to 1.00, while I'm at it
2001-07-20 03:22:00 +00:00
acd32d3be5
Added function xml.sax.saxutils.quoteattr().
...
This closes SF bug #440351 . It should not be moved to Python 2.1.1.
2001-07-19 16:10:15 +00:00
ab01087109
Revise the Unicode section after getting comments from MAL, GvR, and others.
...
Add new low-level API for interpreter introspection
Bump version number.
2001-07-19 14:59:53 +00:00
53d285a9af
Remove some false statements.
2001-07-19 03:49:33 +00:00
f5fec3c88a
Fill out the Unicode section, somewhat uncertainly
2001-07-19 01:48:08 +00:00
8cfa9055cf
Finish the "Other changes" section
...
Bump version number
Insert a few blank lines here and there
2001-07-19 01:19:59 +00:00
28bafb8b5d
Fix a few typos
2001-07-19 01:17:15 +00:00
b39fa8a75b
Remove note about this being a draft document.
...
Note the actual date of 2.1's release
2001-07-19 00:29:48 +00:00
5afb5e5c9c
Look to the future: bump the version number.
...
Do more to ensure we don't do any more formatting than we need to.
Use separate targets for the distribution packages for paper-based and
non-paper-based formats; this avoids some extra packaging when a complete
distribution is being built with both paper sizes.
2001-07-18 21:17:29 +00:00
413bfb766e
2.2a1 is out; look to the future.
2001-07-18 21:06:06 +00:00
cb417c0724
Ignore all .tar files in the top directory; we're about to generate
...
more of them.
2001-07-18 21:04:35 +00:00
6c29926587
Lots of small updates, some long overdue.
2001-07-18 20:01:15 +00:00
01815526e0
Add a more substantial example startup file for the interactive shell;
...
sample startup script provided by Itamar Shtull-Trauring.
This closes SF patch #410890 .
Add some logical markup where it was missing.
2001-07-18 19:21:12 +00:00
1ca78b6b70
Change the command lines to use a similar "phrasing" to that used in the
...
other documentation makefiles. This is probably not sufficient to run
the conversion on Windows, but goes at least part way.
2001-07-18 18:32:38 +00:00
72182027a8
"Make small changes, but carry a big diff."
...
Minor local consistency adjustments.
A couple of small tweaks to the setdlopenflags() description.
For setprofile() and settrace(), convert some references to become
hyperlinks in the HTML version.
2001-07-18 17:52:58 +00:00
1a2302b3b2
Add some symbolic names to support hyperlinked references.
2001-07-18 17:40:19 +00:00
5d808fba00
Made a few minor style & markup changes to the new {get,set}dlopenflags()
...
descriptions; added availability notes.
2001-07-18 16:35:05 +00:00
f0473d511b
Patch #412229 : Add functions sys.getdlopenflags and sys.setdlopenflags.
...
Add dlopenflags to PyInterpreterState, and use it in dlopen calls.
2001-07-18 16:17:16 +00:00
b311ad5bcb
Ignore the html-*.tar file that can now be generated as an intermediate.
2001-07-17 23:36:31 +00:00
8f65aeffbd
Revise the rules for building the distribution files for the HTML format.
...
These work again.
2001-07-17 23:35:46 +00:00
0068e9c1eb
Mirror Guido's latest changes to the license file.
2001-07-17 23:08:24 +00:00
5e06b84092
Be more specific about some of the dependencies, to avoid re-building when
...
some of the mostly-general files get changed.
2001-07-17 23:07:03 +00:00
f269e59232
Define new markup for 5-column tables.
2001-07-17 23:05:57 +00:00
3a3bb211c8
Kill another merge zombie.
2001-07-17 21:05:22 +00:00
c4fefb19cf
Kill a merge zombie.
2001-07-17 21:04:18 +00:00
efaef13c81
Update the availability information for os.tempnam(), os.tmpfile(), and
...
os.tmpnam().
2001-07-17 20:39:18 +00:00
68db730324
Adding what's done of the documentation for the new profiling &
...
tracing interface. Incomplete, but better to check it in since I've
been including it in my updates.
2001-07-17 19:48:30 +00:00
c32cc7c11d
Delete sentence fragment (noted by Fred Bremmer)
2001-07-17 18:25:01 +00:00
1385a57b85
Bump the release number.
...
Make the syntax of compound command lines more portable (nmake, CygWin).
These changes are an adaptation of SF patch #429611 .
Use the new tools/rewrite.py instead of grep/date/sed to transform
html/index.html.in into html/index.html; this is required for portability.
2001-07-17 16:53:19 +00:00
16649a803b
Make the syntax for compound command lines more portable (nmake, CygWin).
...
This is probably not sufficient by itself for the info generation, and is
being done mostly to keep the style consistent with additional patches
that will be applied to Doc/Makefile.
2001-07-17 16:48:55 +00:00
3cae66bdbc
Script to re-write @FOO@-style marks with values, initializing the
...
replacement for @DATE@ from a TeX file containing a \date{...} mark
(such as texinputs/boilerplate.tex).
This will be used to re-write the html/index.html.in file instead of
a combination of grep, date, and sed -- this is more portable to non-Unix
platforms.
This solves part of the problem reported in SF patch #429611 , but does
not use the suggested patch.
2001-07-17 16:46:14 +00:00
63d1d264d1
Update the release information.
2001-07-17 16:28:50 +00:00
f8a17b14c4
Now we're picking nits: get my name right! ;-)
2001-07-17 14:54:07 +00:00
6ea9f0bb20
Add FLD to credit list
...
Correct grammatical error
2001-07-17 14:50:31 +00:00
aebbca3b61
Job.__init__(): Only create the builddir directory if it will be used (by
...
building the HTML or text documentation). There is no need to create
it for other formats.
Job.build_html(): The builddir parameter is always passed in, so it need
not be optional.
2001-07-17 14:46:09 +00:00
0d00254cc1
Cleaned up a number of minor nits, use markup a little more consistently.
2001-07-17 13:55:33 +00:00
4cf52a9a80
Minor rewrites to iterator and generator sections
...
Credit both Neil and Tim for generators
Fix indentation of a few paragraphs
2001-07-17 12:48:48 +00:00
e78661bf90
Fix a couple of minor markup nits.
...
Footnotes should be added *after* punctuation, not before.
(Yes, this should be merged with the descr branch. Sorry, Tim!)
2001-07-17 05:17:58 +00:00
95400a28e4
Updated the documentation in several respects:
...
- This module, despite its name, now should conform to RFC 2822, the
update to RFC 822.
- This module doesn't just represent "email headers", but entire email
messages.
- Added documentation for other useful public functions such as
quote(), unquote(), praseaddr(), and dump_address_pair().
2001-07-16 20:47:58 +00:00
687a17deaa
Revise the description of time.clock() so that it correctly describes the
...
Windows version of the function as well as the Unix flavor.
This fixes SF bug #441357 .
2001-07-16 15:40:57 +00:00
ddeb1358a4
Use \longprogramopt, as suggested by FLD
2001-07-16 14:35:52 +00:00
ced2366a05
Use \verb for configure switches, because inside \code multiple dashes
...
are merged to a single hyphen.
Delete forgotten CVS conflict marker
2001-07-16 13:45:31 +00:00
2cd712b812
Write some entries in the "Other changes" section
...
Write description of .encode()/.decode for the Unicode section
Bump version number
2001-07-16 13:39:08 +00:00
4dbf87152e
Began actually writing:
...
* iterators
* generators
* copied the nested scopes section from the 2.1 article
* standard library changes
2001-07-16 02:17:14 +00:00
44845ba67d
Change the target name for \kbd.
2001-07-14 03:10:20 +00:00
9725fd8c26
Add another name.
2001-07-14 03:09:29 +00:00
755c23dcc4
Oops, one more caret.
2001-07-14 03:05:53 +00:00
377fb1e1f6
Fix the markup of the caret charater in a couple of places; LaTeX's
...
special character bite us again. ;-(
This fixes SF bug #440911 .
2001-07-14 03:01:48 +00:00
8ee679f0ce
Minor changes to match the style guide.
2001-07-14 02:50:55 +00:00
4124a0b343
Correct a couple of errors noted by Alex Martelli.
2001-07-14 02:46:01 +00:00
7fc8abb396
Remove comments about XML and HTML; those sections are no
...
longer part of this chapter.
Minor change to match the style guide.
2001-07-14 02:44:43 +00:00
9120df388c
Add a little more information about the usage of some terms where the
...
style guide can use a little clarification, and present some minor
specific markup.
Make a few adjustments to conform to the style guide.
2001-07-14 02:34:12 +00:00
7a889ceb1e
Minor change to match the style guide.
2001-07-14 02:27:22 +00:00
17f690f96b
Minor changes to match the style guide.
2001-07-14 02:14:42 +00:00
6e5e1d924c
Minor change to match the style guide.
2001-07-14 02:12:27 +00:00
8da359bdc0
Minor changes to match the style guide.
...
Make the reference to the python-docs email address a hyperlink; we want to
encourage responses to the plea for help!
2001-07-14 02:09:32 +00:00
3d97e35a20
Add entry for xmlrpclib documentation.
2001-07-12 23:40:13 +00:00
5ddf7adf84
Several markup adjustments so this will format and be more consistent with
...
the rest of the documnentation.
2001-07-12 23:39:24 +00:00
602cf584be
Generate a more meaningful message regarding the type of the documentation
...
release being discussed.
2001-07-12 21:50:10 +00:00
f4bdb57e15
Fix return value for m.group() for groups not in the part of the RE that
...
matched; reported by Paul Moore.
Wrapped several long lines.
2001-07-12 14:13:43 +00:00
bf5a774bcb
On int/long to the negative int/long power, let float handle it
...
instead of raising an error. This was one of the two issues that the
VPython folks were particularly problematic for their students. (The
other one was integer division...) This implements (my) SF patch
#440487 .
2001-07-12 11:27:16 +00:00
e304bb9eec
First version of xmlrpclib docs. Probably has markup errors; is not complete,
...
could probably stand to have some of the internal things like Marshaller
documented. But I think it does a decent job on the entry points and
externally visible things.
Fred and Fredrik, do your stuff! You both need to proof this.
2001-07-12 02:39:45 +00:00
682d5f3cda
Follow the recommended practices for keystroke representation; this
...
improves internal consistency in the documentation.
2001-07-12 02:09:51 +00:00
07178d237a
For \kbd, be more prescriptive regarding how keystrokes should be
...
written.
2001-07-12 02:08:29 +00:00
fa774872b8
Move the section on concrete numeric objects before the section on
...
concrete sequence objects, since their API is simpler.
This is in response to a comment in SF bug #440037 .
2001-07-11 20:35:37 +00:00
7bf8277e98
Note addition of xmlrpclib
...
Comment out descr-branch section
Update e-mail address
(Time to begin writing this...)
2001-07-11 18:54:26 +00:00
9bbc933fcb
Added information about the timeout parameter to the poll() method for
...
polling objects. This closes SF bug #439823 .
Fixed a minor markup bug.
2001-07-11 18:48:39 +00:00
d854831ddd
Corrected the refcount information for PyList_SET_ITEM().
2001-07-10 16:19:13 +00:00
bab2965c7c
Document PyObject_New(), PyObject_NewVar(), PyObject_Init(),
...
PyObject_InitVar(), PyObject_Del(), PyObject_NEW(),
PyObject_NEW_VAR(), and PyObject_DEL().
Add notes to PyMem_Malloc() and PyMem_New() about the memory buffers
not being initialized.
This fixes SF bug #439012 .
Added explicit return value information for PyList_SetItem(),
PyDict_SetItem(), and PyDict_SetItemString(). Corrected return type
for PyList_SET_ITEM().
Fixed index entries in the descriptions of PyLong_AsLong() and
PyLong_AsUnignedLong().
This fixes the API manual portion of SF bug #440037 .
Note that the headers properly declare everything as 'extern "C"' for
C++ users.
Document _Py_NoneStruct.
Added links to the Extending & Embedding manual for PyArg_ParseTuple()
and PyArg_ParseTupleAndKeywords().
Added note that PyArg_Parse() should not be used in new code.
Fix up a few style nits -- avoid "e.g." and "i.e." -- these make
translation more difficult, as well as reading the English more
difficult for non-native speakers.
2001-07-10 16:10:08 +00:00
12060e5ed3
Added descriptions for some modules that previously did not have any
...
information about them, based on comments from Jack Jansen.
2001-07-10 14:19:45 +00:00
67f193faab
Add a little bit more about the XML migration plan. This still needs a lot
...
of work, but mostly it needs time spent doing the work to make the
generated XML useful.
2001-07-09 16:04:03 +00:00
03e88da81b
Add conversion information for the grammar production support (preliminary).
2001-07-09 15:00:42 +00:00
e30ac57038
Fix for SF bug #436525 , reported by Greg Kochanski:
...
The block/unblock thread macros are called 'Py_BLOCK_THREADS' and
'Py_UNBLOCK_THREADS', not 'Py_BEGIN_BLOCK_THREADS' and
'Py_BEGIN_UNBLOCK_THREADS'.
2001-07-09 14:35:01 +00:00
44835d8e7a
Move & update a comment.
...
Add support for the \ulink macro.
2001-07-07 06:00:36 +00:00
de6dc1e11c
Change the way notification mails are sent so people who respond to the
...
update announcements do not get bounces from trying to send mail to my
laptop, which has an identity crisis due to constant relocation.
2001-07-06 23:45:16 +00:00
8e0c09da62
More reference count information.
2001-07-06 23:31:49 +00:00
cb4638a278
Change the grammar productions to use the new productionlist environment;
...
this supports a hyperlinked version of the grammar that can make tracking
down details and definitions a little easier.
2001-07-06 22:49:53 +00:00
b2d1006272
Update the description of how to start an interpreter and determine the
...
installation prefix and exec_prefix for Windows.
2001-07-06 22:46:52 +00:00
b4b64daa5e
Add \ulink, grammar production markup.
2001-07-06 22:44:48 +00:00
77602f2e32
Add support for \ulink and hyperlink grammars.
...
do_cmd_verbatiminput(): Write out a text file containing the content of the
input file with a .txt extension, and add a link to it at the bottom of
the presentation. This easier retrieval of example source code for
copy & paste use.
2001-07-06 22:43:02 +00:00
bde8d1c8af
Revise a comment about styles I don't think LaTeX2HTML can generate,
...
but which came from their default stylesheet.
Add styles for the new hyperlinked grammar productions.
2001-07-06 22:37:36 +00:00
432cef0d0b
Add new material on some markup that will be checked in shortly. This
...
includes some minor new inline markup and markup to generate hyperlinked
grammar productions.
Adopt a "style guide" document -- this beats writing our own and means
we'll have a chance at consistency, without having to make it all up
ourselves.
2001-07-06 22:34:33 +00:00
238858fc51
Packaged versions of the HTML format need to include any .txt files that
...
were generated by the use of the productionlist environment or the
\verbatiminput macro.
2001-07-06 22:28:47 +00:00
7e79b9e1cc
More names, yay!
2001-07-06 22:27:04 +00:00
0a650d77d5
Add entries for recently defined markup.
2001-07-06 21:13:51 +00:00
dde993c15d
Simplification to mirror a better conversion specification and more
...
powerful latex2esis.py.
2001-07-06 21:03:30 +00:00
b5fc0ab099
Allow optional arguments to LaTeX macros to span lines. This is legal in
...
LaTeX and we have at least one occurance of that in the content, so this
script needs to support it as well.
2001-07-06 21:01:19 +00:00
907e76b620
Fix up a few style nits -- avoid "e.g." and "i.e." -- these make
...
translation more difficult, as well as reading the English more
difficult for non-native speakers.
2001-07-06 20:30:11 +00:00
ab1df4fe88
Fix up a few style nits -- avoid "e.g." and "i.e." -- these make
...
translation more difficult, as well as reading the English more
difficult for non-native speakers.
Add an index entry for the Telnet protocol.
Always refer to the protocol as Telnet instead of telnet.
2001-07-06 20:23:02 +00:00
91f2f26d75
Fix up a few style nits -- avoid "e.g." and "i.e." -- these make
...
translation more difficult, as well as reading the English more
difficult for non-native speakers.
2001-07-06 19:28:48 +00:00
ed51494666
Fix up a few style nits -- avoid "e.g." and "i.e." -- these make
...
translation more difficult, as well as reading the English more
difficult for non-native speakers.
2001-07-06 17:28:39 +00:00
45c23e61d8
Explain the exit code for the wait() method, including a reference to
...
the os.W*() functions used to interpret the return value.
This fixes SF bug #429361 .
2001-07-06 17:17:12 +00:00
15e33d828c
Fix up a few style nits -- avoid "e.g." and "i.e." -- these make
...
translation more difficult, as well as reading the English more
difficult for non-native speakers.
2001-07-06 06:49:32 +00:00
bcd1df746d
The fpectl module does not work on Windows, so remove Windows from the
...
\platform statement.
Also fix a minor style consistency nit in an example.
2001-07-05 21:17:08 +00:00
a939911345
Fix a markup error: do not omit a method's parameter list if it is
...
empty.
2001-07-05 21:14:03 +00:00
25211f5724
Added more information on the differences between the htmllib and HTMLParser
...
modules.
2001-07-05 16:34:36 +00:00
5fe2c139d5
List constraints on xrange() objects.
2001-07-05 15:27:19 +00:00
3f56166b1a
Rip out the fancy behaviors of xrange that nobody uses: repeat, slice,
...
contains, tolist(), and the start/stop/step attributes. This includes
removing the 4th ('repeat') argument to PyRange_New().
2001-07-05 13:27:48 +00:00
20006b2d51
Marked the parameters to Stats.print_*() as optional.
...
This closes SF bug #438032 .
2001-07-02 21:22:39 +00:00
cb9be93955
Add another name.
2001-07-02 17:16:07 +00:00
4efb6e9643
Turns out Neil didn't intend for *all* of his gen-branch work to get
...
committed.
tokenize.py: I like these changes, and have tested them extensively
without even realizing it, so I just updated the docstring and the docs.
tabnanny.py: Also liked this, but did a little code fiddling. I should
really rewrite this to *exploit* generators, but that's near the bottom
of my effort/benefit scale so doubt I'll get to it anytime soon (it
would be most useful as a non-trivial example of ideal use of generators;
but test_generators.py has already grown plenty of food-for-thought
examples).
inspect.py: I'm sure Ping intended for this to continue running even
under 1.5.2, so I reverted this to the last pre-gen-branch version. The
"bugfix" I checked in in-between was actually repairing a bug *introduced*
by the conversion to generators, so it's OK that the reverted version
doesn't reflect that checkin.
2001-06-29 23:51:08 +00:00
88e66254f9
Use the more conventional "self" as the name of the self parameter in an
...
example. It actually confused a reader.
2001-06-29 17:50:57 +00:00
0c209047ba
Correct a markup error for an accented character.
...
Reported by Milan Zamazal <pdm@zamazal.org>.
2001-06-29 16:25:07 +00:00
58c95391fa
Removed some stray periods, and fix up a number of visible markup
...
consistency errors (mostly omitted "()" at the end of function and
method names).
Reported by Milan Zamazal <pdm@zamazal.org>.
2001-06-29 16:21:47 +00:00
9c3c5e406d
Two more names.
2001-06-29 15:42:20 +00:00
f29ca18df3
SourceForge bug #437041 :
...
Use a portable format in the example that creates a timestamp suitable for
use in email, also updating it and the footnote from RFC 822 to RFC 2822.
2001-06-29 15:39:53 +00:00
9f9bd6af78
Simplify an example based on comment from Thomas Holenstein <thomas@hex.ch>:
...
Do not use an extra flag variable to test only once in one subsequent if
statement.
2001-06-29 14:59:01 +00:00
a43e70396e
Add more items that need to be written about
2001-06-27 20:32:12 +00:00
69940973db
Remove duplicate ', ' in dbhash.open()'s argument list.
2001-06-27 13:49:59 +00:00
e9218a1a8e
Remove the restriction on a mapping's .update() method.
2001-06-26 20:32:59 +00:00
3e7b1a04a0
Teach the types module about generators. Thanks to James Althoff on the
...
Iterators list for bringing it up!
2001-06-25 19:46:25 +00:00
b037d33245
Updated link to zlib's home page.
2001-06-25 15:30:13 +00:00
e7e03cd0cf
Fix typo
2001-06-23 16:26:44 +00:00
ff00fdae23
Correct erroneous description of precmd.
2001-06-23 14:42:43 +00:00
be9d10edbb
Remove some bogus trailing whitespace.
2001-06-23 06:16:52 +00:00
93852ef3c8
Fix minor markup nits.
2001-06-23 06:06:52 +00:00
deda9f3420
Use a named reference to another chapter instead of hard coding the
...
chapter number. This also makes the reference a hyperlink in the HTML
version.
2001-06-23 06:06:21 +00:00
2829f1cf99
Fix a very minor (but annoying when looking for things!) markup nit.
2001-06-23 05:27:20 +00:00
f5eae668a8
Add "yeild" to the list of keywords.
...
Fix a very minor (but annoying when looking for things!) markup nit.
2001-06-23 05:26:52 +00:00
1ab1f71ec3
Consistently use semi-colons after the last property for each selector.
2001-06-23 04:53:43 +00:00
f015d9a5f6
Give the pattern used to pick out a source anchor a more specific pattern.
2001-06-23 04:35:09 +00:00
5962eb0d89
Added several names.
2001-06-23 03:17:02 +00:00
8058bfa6fc
Contributed updates from Harald Hanche-Olsen, giving details of the branch
...
cuts for the complex math functions. Includes a brief description of
what branch cuts are.
2001-06-23 03:16:29 +00:00
6fe4660f61
Added support for our new \infinity and \plusminus macros, and the
...
standard \textbar macro (not supported in many versions of LaTeX2HTML).
Added newline to error message.
2001-06-23 03:13:30 +00:00
5445e5e305
\infinity,
...
\plusminus: New macros to allow us to avoid math mode for these symbols.
2001-06-23 03:11:45 +00:00
bfd80dd8c0
Miscellaneous code cleanups.
...
Make sure we do not lose track of the build directory -- convert a user-
supplied directory to an absolute path.
2001-06-23 03:06:01 +00:00
1bf198e946
Remove an extra tab character.
2001-06-22 18:36:07 +00:00
307cb05764
Re-organize a little, clean up some markup.
...
Added some comments about sys.exit(), SystemExit, and preventing restricted
code from exiting the interpreter.
This closes SF bug #434743 .
2001-06-22 18:21:53 +00:00
f66cb5d0eb
Corrected an error in the information on supporting weak references in
...
extension types (the docs reflected a development version of the API).
This closes SF bug #435066 .
2001-06-22 17:20:29 +00:00
9ca78ac57f
Adjust to understand use of either single- or double-quotes to quote
...
attribute values, and make the logic surrounding the platform
annotations just a little easier to read. Also make the platform
notes appear in the generated page; they were supposed to, but did not.
2001-06-22 17:11:30 +00:00
aff8837740
Add the new texinputs/license.tex to the shared dependencies.
2001-06-22 17:07:02 +00:00
93438bf0a2
Fix & clean up the information about building Python with large file support
...
for Linux.
This closes SF bug #434975 .
2001-06-22 16:01:20 +00:00
490d34dbad
Move license information to a less annoying location in the document.
...
Add documentation for PyErr_SetFromErrnoWithFilename().
2001-06-20 21:39:12 +00:00
d5df09cfb6
Update to include the license information in a less annoying place.
2001-06-20 21:37:34 +00:00
852f7951a2
Separate the copyright statements and license text; include some new
...
comments regarding the history of Python licensing from Guido.
2001-06-20 21:34:35 +00:00
f911a84d5a
Separate the version number and release status into two separate values.
2001-06-20 21:33:13 +00:00
dce975c820
Update to use the newly separated values $PACKAGE_VERSION and $RELEASE_INFO.
...
Normalize all HTML attributes to be written as name="value" instead of
name='value'.
2001-06-20 21:31:36 +00:00
f1927a6d80
Added support for new \setreleaseinfo macro.
...
Normalize all generated HTML so that attribute names come out as
name="value" instead of name='value'.
Changed the target of RFC links to point to the hypertext RFCs at
www.faqs.org instead of the plain text RFCs at www.ietf.org.
2001-06-20 21:29:30 +00:00
c65218e1fd
Add a little more support for describing version information. This
...
is not pretty, but does what is needed.
2001-06-20 21:17:09 +00:00
6016e39250
Document the new encodestring() and decodestring() functions. Also,
...
add some description of what the quotetabs argument does for the
encode*() functions. Finally, add a "see also" pointing to the base64
module.
2001-06-19 19:44:42 +00:00
66eed24415
Add some information on the use of \verbatiminput to display sources from
...
an external file.
2001-06-18 14:59:58 +00:00
fa9e273442
Clarification in the fp appendix suggested on c.l.py by Michael Chermside.
...
Also replaced a *star* style emphasis in the Representation Error section
with an \emph{} thingie.
2001-06-17 21:57:17 +00:00
918f2c722a
Document that filter is added in 2.2.
2001-06-16 08:14:04 +00:00
57e52ef076
Implement the \verbatiminput LaTeX macro; this contains more magic than
...
it should, but only enough that LaTeX2HTML doesn't bite us.
2001-06-15 21:31:57 +00:00
54d10fd2cd
Add a version annotation for the Q and q format codes.
2001-06-15 14:13:07 +00:00
8fcd4b5ab3
Fix an improperly placed comma.
2001-06-14 13:57:16 +00:00
66a0a0a9b6
Make the option processing more robust.
...
Add a -F option similar to "cvs commit -F <file>".
Add a -t option to allow specifying the prefix to the directory into which
the docs should be unpacked (useful when I start trying out new styles for
the presentation).
2001-06-12 13:31:37 +00:00
4a6c5c568f
Fixed reference to table notes for {}.keys() and {}.items() -- these
...
references did not get updated when the notes were renumbered in a
previous update.
This fixes SF bug #432208 .
2001-06-12 03:31:56 +00:00
7a3bfc3a47
Added q/Q standard (x-platform 8-byte ints) mode in struct module.
...
This completes the q/Q project.
longobject.c _PyLong_AsByteArray: The original code had a gross bug:
the most-significant Python digit doesn't necessarily have SHIFT
significant bits, and you really need to count how many copies of the sign
bit it has else spurious overflow errors result.
test_struct.py: This now does exhaustive std q/Q testing at, and on both
sides of, all relevant power-of-2 boundaries, both positive and negative.
NEWS: Added brief dict news while I was at it.
2001-06-12 01:22:22 +00:00
0b9bc20e66
Add the appropriate availability annotations for the popen*() family of
...
functions -- these are not available on traditional Mac OS platforms.
Corrected the version annotations for the spawn*() functions and related
constants; these were added in Python 1.6, not 1.5.2.
2001-06-11 18:25:34 +00:00
046f4d810d
Fixed parameter order for os.popen2(), os.popen3(), and os.popen(4). Added
...
a reference to these functions and popen() from the "Process Management"
section.
Based on a suggestion from comp.lang.python.
2001-06-11 15:21:48 +00:00
c115835457
Fix recent changes so that this section will format again.
2001-06-11 14:55:01 +00:00
7b9542a3f7
Initial support for 'q' and 'Q' struct format codes: for now, only in
...
native mode, and only when config #defines HAVE_LONG_LONG. Standard mode
will eventually treat them as 8-byte ints across all platforms, but that
likely requires a new set of routines in longobject.c first (while
sizeof(long) >= 4 is guaranteed by C, there's nothing in C we can rely
on x-platform to hold 8 bytes of int, so we'll have to roll our own;
I'm thinking of a simple pair of conversion functions, Python long
to/from sized vector of unsigned bytes; that may be useful for GMP
conversions too; std q/Q would call them with size fixed at 8).
test_struct.py: In addition to adding some native-mode 'q' and 'Q' tests,
got rid of unused code, and repaired a non-portable assumption about
native sizeof(short) (it isn't 2 on some Cray boxes).
libstruct.tex: In addition to adding a bit of 'q'/'Q' docs (more needed
later), removed an erroneous footnote about 'I' behavior.
2001-06-10 23:40:19 +00:00
7bc50714fe
Fix the attributions for the new floating point text.
2001-06-08 17:09:01 +00:00
8c27d99941
Added credits in the right places.
2001-06-08 16:28:53 +00:00
417d667dd9
Text from Tim & Guido discussing floating point arithmetic and what users
...
need to understand about the binary & decimal fp, so that representation
weirdness is documented somewhere. This makes it easier to repond to "bug"
reports caused by user confusion & ignorance of the issues.
This closes SF patch #426208 .
2001-06-08 16:24:58 +00:00
1dc98c44fe
add warning about situation where code may be executed twice, once when
...
module is __main__ and once when module is imported.
2001-06-08 14:40:28 +00:00
62f9d7c021
In the section on extending the profiler, add some additional discussion
...
about setting up the dispatch table, and update the OldProfile and
HotProfile classes to the current implementations, showing the adjusted
construction for the dispatch table.
2001-06-08 05:04:19 +00:00
e2ccb89513
Document filter.
2001-06-07 19:01:24 +00:00
2a9bda9223
Typo: "descrition" --> "description"
...
Add reference to the documentation for the Python documentation markup.
Fixed up a couple of descriptions.
This closes SF bug #430627 .
2001-06-06 16:02:47 +00:00
9ccc0df52f
Add references to the documentation for the Python documentation markup.
...
Suggested by the comments in SF bug #430627 .
2001-06-06 15:59:04 +00:00
e24fef0dd2
Fix bug #422702 : Make flag argument to open optional, and document it that way.
2001-06-05 05:33:19 +00:00
88382696f4
Update a "Programmer's note" about lambda forms and scoping to reflect
...
the availability of nested scoping in Python 2.1 and 2.2.
2001-06-05 02:17:02 +00:00
b9d973dac5
is -> if in rename description
2001-06-04 15:31:17 +00:00
00d0cb6ec3
Explained more differences between PyList_SetItem() and PyList_SET_ITEM().
...
In particular, the affect on existing list content was not sufficiently
explained.
This closes SF bug #429554 .
2001-06-03 03:12:57 +00:00
81e142b907
Document os.getenv().
...
This closes SF bug #429059 .
2001-05-31 20:27:46 +00:00
c19f39272e
Some general cleanup of the threading module documentation, including
...
fixing the reference to Thread.getDeamon() (should be isDaemon()).
This closes SF bug #429070 .
2001-05-31 20:24:07 +00:00
6cba3d0e64
Added entry for HTMLParser documentation.
2001-05-30 04:59:50 +00:00
3b755d43ac
Michel Pelletier <michel@digicool.com>:
...
Documentation for the HTMLParser module, with small changes by FLD.
2001-05-30 04:59:00 +00:00
9a374186fc
New solution to the "Someone stuck a colon in that filename!" problem:
...
Allow colons in the labels used for internal references, but do not
expose them when generating filename.
2001-05-29 19:53:46 +00:00
96a2a80065
Users of PySequence_GET_FAST() should get the length of the sequence using
...
PySequence_Size(), not PyObject_Size(): the later considers the mapping
methods as well as the sequence methods, which is not needed here. Either
should be equally fast in this case, but PySequence_Size() offers a better
conceptual match.
2001-05-29 18:51:41 +00:00
dc9e7e42c8
readlink() description: Added note that the return value may be either
...
absolute or relative.
remove(), rename() descriptions: Give more information about the cross-
platform behavior of these functions, so single-platform developers
can be aware of the potential issues when writing portable code.
This closes SF patch #426598 .
2001-05-29 18:13:06 +00:00
964c074a62
Hack to make this play nicer with *old* versions of Python: os.path.abspath()
...
was not available in Python 1.5.1. (Yes, a user actually tried to use this
with that version of Python!)
2001-05-29 16:10:07 +00:00
597bc1d46f
Bring the notes on the relationship between __cmp__(), __eq__(), and
...
__hash__() up to date (re: use of objects which define these methods
as dictionary keys).
This closes SF bug #427698 .
2001-05-29 16:02:35 +00:00
b9879e1020
Fix typo reported in SF bug #427783 .
2001-05-29 15:44:27 +00:00
c80d4dd695
The parameter to the listen() method is not optional, but was marked as
...
optional in the documentation.
This closes SF bug #427985 .
2001-05-29 15:37:45 +00:00
b2625eb10e
Removed information on the old third parameter to _PyTuple_Resize().
...
Added information on PyIter_Check(), PyIter_Next(),
PyObject_Unicode(), PyString_AsDecodedObject(),
PyString_AsEncodedObject(), and PyThreadState_GetDict().
2001-05-29 15:34:06 +00:00
404ac97207
If the input line does not contain enough fields, raise a meaningful
...
error.
2001-05-29 15:25:51 +00:00
fac312ff88
Do not start API descriptions with "Does the same, but ..." -- actually
...
state *which* other function the current one is like, even if the
descriptions are adjacent.
Revise the _PyTuple_Resize() description to reflect the removal of the
third parameter.
2001-05-29 15:13:00 +00:00
56a71eee65
Add a version annotation for splitdrive(); old, but as long as I managed
...
to end up with the information, it is better recorded than lost.
2001-05-25 16:21:00 +00:00
c6d8f8d2ac
Add descriptions of {}.iteritems(), {}.iterkeys(), and {}.itervalues()
...
in the table of mapping object operations. Re-numbered the list of
notes to reflect the move of the "Added in version 2.2." note to the list
of notes instead of being inserted into the last column of the table.
2001-05-25 04:24:37 +00:00
98cfab6523
One more update related to the new get() and setdefault() methods on the
...
Message object.
2001-05-22 22:00:40 +00:00
6b4593e338
Update to add get() and setdefault() as supported mapping operations, and
...
add a list of the mapping methods which are not supported (per Barry's
comments).
2001-05-22 15:12:46 +00:00
706314909b
Add some clarifications about the mapping interface presented by
...
rfc822.Message objects, based on comments from Barry.
2001-05-22 14:36:30 +00:00
bd695a716d
Changed all the examples with ugly platform-dependent float output to use
...
numbers that display nicely after repr(). From much doctest experience
with the same trick, I believe people find examples with simple fractions
easier to understand too: they can usually check the results in their
head, and so feel confident about what they're seeing. Not even I get a
warm feeling from a result that looks like 70330.345024097141 ...
2001-05-22 06:54:14 +00:00
1400baa5d6
Add a "See also" section with useful links. More should be added giving
...
pointers to information about the other mailbox formats; if anyone can
provide the information needed, please let me know!
2001-05-21 21:23:01 +00:00
8b0b8409ae
Update output to reflect additional precision produced by the repr() of
...
floating point numbers in an interactive example.
Added comment to help explain control flow in the example code showing
how to check if a number is prime.
This closes SF bugs 419434 and 424552.
2001-05-21 16:55:39 +00:00
24e621918b
Add documentation for Py_Main() and PyThreadState_GetDict().
2001-05-21 15:56:55 +00:00
fc43d00c17
Typo: "that" --> "than"
...
This closes SF bug #425320 .
2001-05-21 15:03:35 +00:00
e9719fe1a7
Fix bug in smtplib example: the prompt said to end the message with ^D,
...
but doing so raised EOFError. This makes it work as advertised and
converts to string methods where reasonable.
This closes SF bug #424776 .
2001-05-20 12:26:04 +00:00
09daff4596
Get Aahz listed correctly using his legal/professional name.
2001-05-20 05:29:01 +00:00
3b923fcff5
Add another item
2001-05-19 19:35:46 +00:00
c0dac1a58c
Beef up the unicode() description a bit, based on material from AMK's
...
"What's New in Python ..." documents.
2001-05-15 15:27:53 +00:00
2d9204199f
This patch changes the way the string .encode() method works slightly
...
and introduces a new method .decode().
The major change is that strg.encode() will no longer try to convert
Unicode returns from the codec into a string, but instead pass along
the Unicode object as-is. The same is now true for all other codec
return types. The underlying C APIs were changed accordingly.
Note that even though this does have the potential of breaking
existing code, the chances are low since conversion from Unicode
previously took place using the default encoding which is normally
set to ASCII rendering this auto-conversion mechanism useless for
most Unicode encodings.
The good news is that you can now use .encode() and .decode() with
much greater ease and that the door was opened for better accessibility
of the builtin codecs.
As demonstration of the new feature, the patch includes a few new
codecs which allow string to string encoding and decoding (rot13,
hex, zip, uu, base64).
Written by Marc-Andre Lemburg. Copyright assigned to the PSF.
2001-05-15 12:00:02 +00:00
b3384d3555
Make sure we include all of Python's numeric types in the data model
...
description, so that the introduction of complex is not a surprise.
This closes SF bug #423429 .
2001-05-14 16:04:22 +00:00
ba7e2c8a27
Add some text to make the dircmp object section more readable, and move
...
some stuff around.
2001-05-11 17:01:32 +00:00
886f113ba9
--sigh--
...
Finish the last set of changes to these files so the conversion does not
break.
2001-05-11 15:49:19 +00:00
47852467f5
Markup adjustments to avoid getting junk in the index.
2001-05-11 15:46:45 +00:00
96d7a70630
Replace "\begin{classdesc}{SomeClass}{\unspecified}" with
...
"\begin{classdesc*}{SomeClass}" -- the rendering of \unspecified was
identical to \moreargs, so this helps clarify things just a little.
2001-05-11 01:08:13 +00:00
9f2376de7a
Document the new classdesc* environment, and the previously undocumented
...
excclassdesc environment.
2001-05-11 01:01:12 +00:00
06a01e84b9
Define a new environment, classdesc*, which can be used to document a
...
class without providing any information about the constructor. This
should be used for classes which only exist to act as containers rather
than as factories for instances.
2001-05-11 01:00:30 +00:00
986badae1e
Write a better synopsis for the Scrap module, and provide a link to
...
useful documentation on the Scrap Manager.
2001-05-10 22:37:38 +00:00
0eeca6342f
Actually include a synopsis line for the ColorPicker module.
2001-05-10 22:36:13 +00:00
e7ec1efe50
Fix typo in weakref.proxy() documentation.
...
This closes SF bug #423087 .
2001-05-10 17:22:17 +00:00
791c351b3d
Update example to no longer use the FCNTL module.
2001-05-10 15:57:17 +00:00
Fred Drake
Jack Jansen
Andrew M. Kuchling
Martin v. Löwis
Greg Ward
Tim Peters
Skip Montanaro
Piers Lauder
Barry Warsaw
Guido van Rossum
Eric S. Raymond
Thomas Wouters
Marc-André Lemburg