Fred Drake
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
Fred Drake
d86038d1be
Apply the new \mailheader macro where appropriate, and fix a few small
...
markup inconsistencies.
2001-08-03 18:39:36 +00:00
Fred Drake
7eac0cb04c
Define the \mailheader macro and document conventions for using it.
2001-08-03 18:36:17 +00:00
Fred Drake
30cf118cf7
Minor markup nits and slight style-guide conformance changes.
2001-08-03 17:11:33 +00:00
Jack Jansen
cb60dae6a1
Documented the runtimemodel attribute.
2001-08-03 13:19:56 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
044bb4d22a
Explain that __init__() methods do not get to return values.
2001-08-02 15:53:05 +00:00
Fred Drake
388f37e6f6
Add anentry for the distutils.sysconfig module docs.
2001-08-02 15:13:58 +00:00
Fred Drake
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
Fred Drake
25376c4f8b
Documentation for the distutils.sysconfig module.
2001-08-02 15:12:07 +00:00
Fred Drake
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
Fred Drake
236ddd6834
Added more names.
2001-08-01 17:19:11 +00:00
Fred Drake
20c94913de
Minor re-wording in the exaplantion of sequence comparisons.
...
This closes SF bug #445749 .
2001-08-01 17:17:13 +00:00
Fred Drake
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
Fred Drake
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
Andrew M. Kuchling
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
Andrew M. Kuchling
f4ccf587f6
Rewrite MBCS paragraph following MH's suggestions, and credit him
...
Note new Windows installer
2001-07-31 01:11:36 +00:00
Fred Drake
43211ecda2
Make some adjustments to the markup, and fix up some style-guide issues.
2001-07-29 03:41:23 +00:00
Martin v. Löwis
66b6e192b9
Patch #416224 : add readline completion to cmd.Cmd.
2001-07-28 14:44:03 +00:00
Greg Ward
54f65094c3
Typo fix.
2001-07-26 21:01:21 +00:00
Tim Peters
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
Martin v. Löwis
4f1cd8bdcb
Patch #411138 : Rename config.h to pyconfig.h. Closes bug #231774 .
2001-07-26 13:41:06 +00:00
Skip Montanaro
41d7d58cc4
trivial rewording in footnote 5.
2001-07-25 16:18:19 +00:00
Fred Drake
d61e3eab44
Add entry for the new distutils section.
2001-07-24 16:20:13 +00:00
Fred Drake
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
Fred Drake
f1b3de8d5c
Add labels to all \section and \subsection headings for use in references.
2001-07-24 14:38:34 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
6fdb90c0ca
Remove self-reference from the anydbm module.
...
This closes SF patch #443788 .
2001-07-23 19:22:42 +00:00
Fred Drake
8a2adcf812
Typo: Added missing "if".
...
This is part of SF patch #442788 .
2001-07-23 19:20:56 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
6d988559a3
Added information on Py_BuildValue().
2001-07-20 20:55:31 +00:00
Fred Drake
f69868f304
Add a missing "\" to the markup.
2001-07-20 19:03:44 +00:00
Fred Drake
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
Andrew M. Kuchling
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
Fred Drake
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
Fred Drake
0825dc2427
Fix typo in description of raw strings: "value" --> "valid"
...
This closes SF bug #443059 .
2001-07-20 14:32:28 +00:00
Piers Lauder
a3a1668904
apply patch item #416254
2001-07-20 11:04:19 +00:00
Andrew M. Kuchling
5120eac6c6
Bump release number to 1.00, while I'm at it
2001-07-20 03:22:00 +00:00
Fred Drake
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
Andrew M. Kuchling
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
Fred Drake
53d285a9af
Remove some false statements.
2001-07-19 03:49:33 +00:00
Andrew M. Kuchling
f5fec3c88a
Fill out the Unicode section, somewhat uncertainly
2001-07-19 01:48:08 +00:00
Andrew M. Kuchling
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
Andrew M. Kuchling
28bafb8b5d
Fix a few typos
2001-07-19 01:17:15 +00:00
Andrew M. Kuchling
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
Fred Drake
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
Fred Drake
413bfb766e
2.2a1 is out; look to the future.
2001-07-18 21:06:06 +00:00
Fred Drake
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
Fred Drake
6c29926587
Lots of small updates, some long overdue.
2001-07-18 20:01:15 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
1a2302b3b2
Add some symbolic names to support hyperlinked references.
2001-07-18 17:40:19 +00:00
Fred Drake
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
Martin v. Löwis
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
Fred Drake
b311ad5bcb
Ignore the html-*.tar file that can now be generated as an intermediate.
2001-07-17 23:36:31 +00:00
Fred Drake
8f65aeffbd
Revise the rules for building the distribution files for the HTML format.
...
These work again.
2001-07-17 23:35:46 +00:00
Fred Drake
0068e9c1eb
Mirror Guido's latest changes to the license file.
2001-07-17 23:08:24 +00:00
Fred Drake
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
Fred Drake
f269e59232
Define new markup for 5-column tables.
2001-07-17 23:05:57 +00:00
Fred Drake
3a3bb211c8
Kill another merge zombie.
2001-07-17 21:05:22 +00:00
Fred Drake
c4fefb19cf
Kill a merge zombie.
2001-07-17 21:04:18 +00:00
Fred Drake
efaef13c81
Update the availability information for os.tempnam(), os.tmpfile(), and
...
os.tmpnam().
2001-07-17 20:39:18 +00:00
Fred Drake
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
Andrew M. Kuchling
c32cc7c11d
Delete sentence fragment (noted by Fred Bremmer)
2001-07-17 18:25:01 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
63d1d264d1
Update the release information.
2001-07-17 16:28:50 +00:00
Fred Drake
f8a17b14c4
Now we're picking nits: get my name right! ;-)
2001-07-17 14:54:07 +00:00
Andrew M. Kuchling
6ea9f0bb20
Add FLD to credit list
...
Correct grammatical error
2001-07-17 14:50:31 +00:00
Fred Drake
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
Fred Drake
0d00254cc1
Cleaned up a number of minor nits, use markup a little more consistently.
2001-07-17 13:55:33 +00:00
Andrew M. Kuchling
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
Fred Drake
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
Barry Warsaw
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
Fred Drake
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
Andrew M. Kuchling
ddeb1358a4
Use \longprogramopt, as suggested by FLD
2001-07-16 14:35:52 +00:00
Andrew M. Kuchling
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
Andrew M. Kuchling
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
Andrew M. Kuchling
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
Fred Drake
44845ba67d
Change the target name for \kbd.
2001-07-14 03:10:20 +00:00
Fred Drake
9725fd8c26
Add another name.
2001-07-14 03:09:29 +00:00
Fred Drake
755c23dcc4
Oops, one more caret.
2001-07-14 03:05:53 +00:00
Fred Drake
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
Fred Drake
8ee679f0ce
Minor changes to match the style guide.
2001-07-14 02:50:55 +00:00
Fred Drake
4124a0b343
Correct a couple of errors noted by Alex Martelli.
2001-07-14 02:46:01 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
7a889ceb1e
Minor change to match the style guide.
2001-07-14 02:27:22 +00:00
Fred Drake
17f690f96b
Minor changes to match the style guide.
2001-07-14 02:14:42 +00:00
Fred Drake
6e5e1d924c
Minor change to match the style guide.
2001-07-14 02:12:27 +00:00
Fred Drake
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
Fred Drake
3d97e35a20
Add entry for xmlrpclib documentation.
2001-07-12 23:40:13 +00:00
Fred Drake
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
Fred Drake
602cf584be
Generate a more meaningful message regarding the type of the documentation
...
release being discussed.
2001-07-12 21:50:10 +00:00
Fred Drake
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
Guido van Rossum
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
Eric S. Raymond
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
Fred Drake
682d5f3cda
Follow the recommended practices for keystroke representation; this
...
improves internal consistency in the documentation.
2001-07-12 02:09:51 +00:00
Fred Drake
07178d237a
For \kbd, be more prescriptive regarding how keystrokes should be
...
written.
2001-07-12 02:08:29 +00:00
Fred Drake
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
Andrew M. Kuchling
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
Fred Drake
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
Fred Drake
d854831ddd
Corrected the refcount information for PyList_SET_ITEM().
2001-07-10 16:19:13 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
03e88da81b
Add conversion information for the grammar production support (preliminary).
2001-07-09 15:00:42 +00:00
Thomas Wouters
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
Fred Drake
44835d8e7a
Move & update a comment.
...
Add support for the \ulink macro.
2001-07-07 06:00:36 +00:00
Fred Drake
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
Fred Drake
8e0c09da62
More reference count information.
2001-07-06 23:31:49 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
b4b64daa5e
Add \ulink, grammar production markup.
2001-07-06 22:44:48 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
7e79b9e1cc
More names, yay!
2001-07-06 22:27:04 +00:00
Fred Drake
0a650d77d5
Add entries for recently defined markup.
2001-07-06 21:13:51 +00:00
Fred Drake
dde993c15d
Simplification to mirror a better conversion specification and more
...
powerful latex2esis.py.
2001-07-06 21:03:30 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
25211f5724
Added more information on the differences between the htmllib and HTMLParser
...
modules.
2001-07-05 16:34:36 +00:00
Guido van Rossum
5fe2c139d5
List constraints on xrange() objects.
2001-07-05 15:27:19 +00:00
Guido van Rossum
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
Fred Drake
20006b2d51
Marked the parameters to Stats.print_*() as optional.
...
This closes SF bug #438032 .
2001-07-02 21:22:39 +00:00
Fred Drake
cb9be93955
Add another name.
2001-07-02 17:16:07 +00:00
Tim Peters
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
Fred Drake
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
Fred Drake
0c209047ba
Correct a markup error for an accented character.
...
Reported by Milan Zamazal <pdm@zamazal.org>.
2001-06-29 16:25:07 +00:00
Fred Drake
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
Fred Drake
9c3c5e406d
Two more names.
2001-06-29 15:42:20 +00:00
Fred Drake
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
Fred Drake
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
Andrew M. Kuchling
a43e70396e
Add more items that need to be written about
2001-06-27 20:32:12 +00:00
Thomas Wouters
69940973db
Remove duplicate ', ' in dbhash.open()'s argument list.
2001-06-27 13:49:59 +00:00
Barry Warsaw
e9218a1a8e
Remove the restriction on a mapping's .update() method.
2001-06-26 20:32:59 +00:00
Tim Peters
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
Fred Drake
b037d33245
Updated link to zlib's home page.
2001-06-25 15:30:13 +00:00
Andrew M. Kuchling
e7e03cd0cf
Fix typo
2001-06-23 16:26:44 +00:00
Eric S. Raymond
ff00fdae23
Correct erroneous description of precmd.
2001-06-23 14:42:43 +00:00
Fred Drake
be9d10edbb
Remove some bogus trailing whitespace.
2001-06-23 06:16:52 +00:00
Fred Drake
93852ef3c8
Fix minor markup nits.
2001-06-23 06:06:52 +00:00
Fred Drake
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
Fred Drake
2829f1cf99
Fix a very minor (but annoying when looking for things!) markup nit.
2001-06-23 05:27:20 +00:00
Fred Drake
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
Fred Drake
1ab1f71ec3
Consistently use semi-colons after the last property for each selector.
2001-06-23 04:53:43 +00:00
Fred Drake
f015d9a5f6
Give the pattern used to pick out a source anchor a more specific pattern.
2001-06-23 04:35:09 +00:00
Fred Drake
5962eb0d89
Added several names.
2001-06-23 03:17:02 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
5445e5e305
\infinity,
...
\plusminus: New macros to allow us to avoid math mode for these symbols.
2001-06-23 03:11:45 +00:00
Fred Drake
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
Fred Drake
1bf198e946
Remove an extra tab character.
2001-06-22 18:36:07 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
aff8837740
Add the new texinputs/license.tex to the shared dependencies.
2001-06-22 17:07:02 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
d5df09cfb6
Update to include the license information in a less annoying place.
2001-06-20 21:37:34 +00:00
Fred Drake
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
Fred Drake
f911a84d5a
Separate the version number and release status into two separate values.
2001-06-20 21:33:13 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Barry Warsaw
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
Fred Drake
66eed24415
Add some information on the use of \verbatiminput to display sources from
...
an external file.
2001-06-18 14:59:58 +00:00
Tim Peters
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
Martin v. Löwis
918f2c722a
Document that filter is added in 2.2.
2001-06-16 08:14:04 +00:00
Fred Drake
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
Fred Drake
54d10fd2cd
Add a version annotation for the Q and q format codes.
2001-06-15 14:13:07 +00:00
Fred Drake
8fcd4b5ab3
Fix an improperly placed comma.
2001-06-14 13:57:16 +00:00
Fred Drake
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
Fred Drake
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
Tim Peters
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
Fred Drake
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
Fred Drake
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
Fred Drake
c115835457
Fix recent changes so that this section will format again.
2001-06-11 14:55:01 +00:00
Tim Peters
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
Fred Drake
7bc50714fe
Fix the attributions for the new floating point text.
2001-06-08 17:09:01 +00:00
Fred Drake
8c27d99941
Added credits in the right places.
2001-06-08 16:28:53 +00:00
Fred Drake
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
Skip Montanaro
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
Fred Drake
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
Martin v. Löwis
e2ccb89513
Document filter.
2001-06-07 19:01:24 +00:00
Fred Drake
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
Fred Drake
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
Martin v. Löwis
e24fef0dd2
Fix bug #422702 : Make flag argument to open optional, and document it that way.
2001-06-05 05:33:19 +00:00
Fred Drake
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
Skip Montanaro
b9d973dac5
is -> if in rename description
2001-06-04 15:31:17 +00:00
Fred Drake
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
Fred Drake
81e142b907
Document os.getenv().
...
This closes SF bug #429059 .
2001-05-31 20:27:46 +00:00
Fred Drake
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
Fred Drake
6cba3d0e64
Added entry for HTMLParser documentation.
2001-05-30 04:59:50 +00:00
Fred Drake
3b755d43ac
Michel Pelletier <michel@digicool.com>:
...
Documentation for the HTMLParser module, with small changes by FLD.
2001-05-30 04:59:00 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
b9879e1020
Fix typo reported in SF bug #427783 .
2001-05-29 15:44:27 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
404ac97207
If the input line does not contain enough fields, raise a meaningful
...
error.
2001-05-29 15:25:51 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
98cfab6523
One more update related to the new get() and setdefault() methods on the
...
Message object.
2001-05-22 22:00:40 +00:00
Fred Drake
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
Fred Drake
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
Tim Peters
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
Fred Drake
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
Fred Drake
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
Fred Drake
24e621918b
Add documentation for Py_Main() and PyThreadState_GetDict().
2001-05-21 15:56:55 +00:00
Fred Drake
fc43d00c17
Typo: "that" --> "than"
...
This closes SF bug #425320 .
2001-05-21 15:03:35 +00:00
Fred Drake
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
Fred Drake
09daff4596
Get Aahz listed correctly using his legal/professional name.
2001-05-20 05:29:01 +00:00
Andrew M. Kuchling
3b923fcff5
Add another item
2001-05-19 19:35:46 +00:00
Fred Drake
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
Marc-André Lemburg
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
47852467f5
Markup adjustments to avoid getting junk in the index.
2001-05-11 15:46:45 +00:00
Fred Drake
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
Fred Drake
9f2376de7a
Document the new classdesc* environment, and the previously undocumented
...
excclassdesc environment.
2001-05-11 01:01:12 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
0eeca6342f
Actually include a synopsis line for the ColorPicker module.
2001-05-10 22:36:13 +00:00
Fred Drake
e7ec1efe50
Fix typo in weakref.proxy() documentation.
...
This closes SF bug #423087 .
2001-05-10 17:22:17 +00:00
Fred Drake
791c351b3d
Update example to no longer use the FCNTL module.
2001-05-10 15:57:17 +00:00
Fred Drake
7c116d7acb
Fix typo reported by David Goodger. This closes SF patch #422383 .
2001-05-10 15:09:36 +00:00
Fred Drake
e9735ac215
Remove all mentions of the strop module -- it has been pronounced Evil.
...
(The string "strop" is found in the rexec documentation, but that should
not be changed until strop is actually removed or rexec no longer allows
it.)
2001-05-10 15:05:03 +00:00
Fred Drake
d0de57cfbb
Update the fcntl module documentation.
2001-05-09 21:09:57 +00:00
Fred Drake
bda3a59a93
Itamar Shtull-Trauring <python@itamarst.org>:
...
Updates zipfile.ZipFile docs to mention the fact that you can create a
ZipFile instance from an arbitrary file-like object.
This closes patch #418011 .
2001-05-09 19:57:37 +00:00
Fred Drake
b8ac0096b2
Fix the operator precedence table: exponentiation binds tighter than
...
negation.
This closes SF bug #421999 .
2001-05-09 16:51:49 +00:00
Fred Drake
251ebe7d30
Remove items that have been done or are being tracked in the SourceForge
...
bug tracker.
2001-05-09 16:43:47 +00:00
Fred Drake
283b352d48
Update the directory names to match changes at SourceForge.
2001-05-09 16:33:34 +00:00
Fred Drake
c116b82b77
Work around limitations of the module synopsis table generation to avoid
...
leaking LaTeX2HTML's internal string munging.
This fixes SF bug #420399 .
2001-05-09 15:50:17 +00:00
Fred Drake
caa79a9ee4
Minor adjustments to HTML for the module synopsis tables.
2001-05-09 15:32:14 +00:00
Fred Drake
af922187ae
Job.build_html(): Be more robust in ensuring about.html exists; copying
...
the right HTML file to the name about.html is needed even if the
--numeric option was not given -- some other name may have been
assigned due to some non-determinism in the algorithm use to perform
name allocation. ;-(
This closes the "About..." portion of SF bug #420216 .
2001-05-09 04:03:16 +00:00
Fred Drake
a7c9ac6544
There is no IMAP class in the imaplib module; the class is IMAP4.
...
There is no imap module; refer to imaplib instead, since it exists.
Move the "See Also:" section in front of the sub-sections, for
consistency with other portions of the library reference.
This closes the library reference portion of SF bug #420216 .
2001-05-09 03:49:48 +00:00
Fred Drake
1ef24e1b30
Note that when inplace=1 existing backup files will be removed silently.
...
Closes SF bug #420230 .
2001-05-09 03:24:55 +00:00
Fred Drake
a6140be7b3
Michael Hudson <mwh21@cam.ac.uk>:
...
Documentation update to reflect changes to the termios module (noting
that the termios functions can take a file object as well as a file
descriptor).
This closes the documentation portion of SF patch #417081 .
2001-05-08 05:37:52 +00:00
Fred Drake
a8e0827614
Hmm... better add a version annotation for the Iterator Protocol section.
2001-05-07 17:47:07 +00:00
Fred Drake
dbcaeda79a
Added documentation for PyIter_Check() and PyIter_Next().
...
Wrapped a long line.
2001-05-07 17:42:18 +00:00
Andrew M. Kuchling
a8defaae04
Skeletal version; I'm checking this in now so I can keep a list of changes,
...
but don't plan on actually writing any text until, ooh, say, July or
thereabouts.
2001-05-05 16:37:29 +00:00
Fred Drake
f42cc45f1b
The general iteration support is part of 2.2, not 2.1 -- fixed the version
...
annotations!
Also fixed a typo noted by Neil S.
2001-05-03 04:39:10 +00:00
Fred Drake
9cfe1824c2
Add documentation for the StopIteration exception.
2001-05-03 04:30:45 +00:00
Fred Drake
287c4cb43a
State that Mailbox objects are iterator objects.
2001-05-02 20:22:12 +00:00
Fred Drake
eacdec6b38
Update the filter() and list() descriptions to include information about
...
the support for containers and iteration.
2001-05-02 20:19:19 +00:00
Fred Drake
93656e76f9
Added section describing the iterator protocol.
2001-05-02 20:18:03 +00:00
Marc-André Lemburg
6f15e5796e
Added new parser markers 'et' and 'et#' which do not recode string
...
objects but instead assume that they use the requested encoding.
This is needed on Windows to enable opening files by passing in
Unicode file names.
2001-05-02 17:16:16 +00:00
Fred Drake
9188b2194a
Correct two floating-point representations printed by the interpreter in
...
interactive examples. Error noted by Dinu Gherman.
2001-04-25 21:03:20 +00:00
Marc-André Lemburg
8155e0e541
This patch originated from an idea by Martin v. Loewis who submitted a
...
patch for sharing single character Unicode objects.
Martin's patch had to be reworked in a number of ways to take Unicode
resizing into consideration as well. Here's what the updated patch
implements:
* Single character Unicode strings in the Latin-1 range are shared
(not only ASCII chars as in Martin's original patch).
* The ASCII and Latin-1 codecs make use of this optimization,
providing a noticable speedup for single character strings. Most
Unicode methods can use the optimization as well (by virtue
of using PyUnicode_FromUnicode()).
* Some code cleanup was done (replacing memcpy with Py_UNICODE_COPY)
* The PyUnicode_Resize() can now also handle the case of resizing
unicode_empty which previously resulted in an error.
* Modified the internal API _PyUnicode_Resize() and
the public PyUnicode_Resize() API to handle references to
shared objects correctly. The _PyUnicode_Resize() signature
changed due to this.
* Callers of PyUnicode_FromUnicode() may now only modify the Unicode
object contents of the returned object in case they called the API
with NULL as content template.
Note that even though this patch passes the regression tests, there
may still be subtle bugs in the sharing code.
2001-04-23 14:44:21 +00:00
Guido van Rossum
8b3d6ca3df
At the suggestion of Peter Funk, document 'key in dict' and 'key not
...
in dict' after has_key(), with a \versionadded{2.2} note.
2001-04-23 13:22:59 +00:00
Fred Drake
34b48e844e
Update publish-to-SourceForge scripts to automatically determine if the
...
branch is the head (development) branch or a maintenance brach, and use
the appropriate target directory for each.
2001-04-22 06:20:31 +00:00
Fred Drake
82f93c693d
Only document <file>.xreadlines() once; added version annotation.
...
This closes SF bug #417943 .
2001-04-22 01:56:51 +00:00
Fred Drake
e99b97e58a
encode(): Handle Latin-1 input characters better.
2001-04-21 06:01:53 +00:00
Fred Drake
bda05564de
Add support for <memberline/> (needs markup improvement!).
...
Update <versionadded/> to recent addition of optional explanatory text;
make the explanation text take the same attribute name for both
<versionadded/> and <versionchanged/>.
2001-04-21 06:00:51 +00:00
Fred Drake
4cacec5393
Fix a number of minor markup errors.
2001-04-21 05:56:06 +00:00
Fred Drake
056a71da76
The (fairly recent) \textasciicircum is not supported by LaTeX2HTML; add
...
support for it here.
2001-04-21 05:48:07 +00:00
Guido van Rossum
0dbb4fba4c
Implement, test and document "key in dict" and "key not in dict".
...
I know some people don't like this -- if it's really controversial,
I'll take it out again. (If it's only Alex Martelli who doesn't like
it, that doesn't count as "real controversial" though. :-)
That's why this is a separate checkin from the iterators stuff I'm
about to check in next.
2001-04-20 16:50:40 +00:00
Fred Drake
1aec3a16f3
Add versioning notes: many of the signatures changed to allow the time
...
used to be omitted (meaning use the current time) as of Python 2.1.
Users who need cross-version portability need to know things like this.
2001-04-19 04:55:23 +00:00
Fred Drake
bc524c4e9f
Cut-&-paste-o noted by Wolfgang Teschner: decompressobj() returns
...
*DE*compression objects, not compression objects!
2001-04-18 20:16:51 +00:00
Fred Drake
895aa9da4c
Suggestion from Keith Briggs: refer to RE objects consistently instead of
...
introducing a new term ("regex") without defining it.
2001-04-18 17:26:20 +00:00
Fred Drake
f3848322ff
Sync version number with the current CVS version.
...
(Note that the docs are also being maintained on the 2.1.1 maintenance
branch, so users interested only in corrections and clarifications
can get that.)
2001-04-18 05:22:24 +00:00
Fred Drake
3151f44d49
Add description of the "explanation" optional parameter added to the
...
\versionadded macro.
Note: this should not be merged into the 2.1 maintenance branch.
2001-04-18 05:19:06 +00:00
Fred Drake
4c6f17a537
Make a number of small clarifications and correct a whole bunch of typos,
...
all reported by Bruce Smith.
2001-04-18 05:12:47 +00:00
Fred Drake
635a7cfcbb
Sync version number with the current CVS version.
...
(Note that the docs are also being maintained on the 2.1.1 maintenance
branch, so users interested only in corrections and clarifications
can get that.)
2001-04-18 05:02:01 +00:00
Fred Drake
293f77af6f
Add note about the version in which GetoptError was added -- this can
...
bite people interested in 1.5.2 compatibility.
2001-04-18 03:18:57 +00:00
Fred Drake
c2b29d0fee
Added support for optional explanation parameter to the \versionadded
...
macro.
Refactored do_cmd_versionadded() and do_cmd_versionchanged() to do most
of the work in a helper function, with the do_cmd_*() wrappers just supplying
a portion of the replacement text.
2001-04-18 03:11:04 +00:00
Fred Drake
fdfb05bb0b
\versionadded: Add support for including an explanatory note along with
...
the versioning information, similar to \versionchanged.
2001-04-18 03:08:54 +00:00
Andrew M. Kuchling
1fcd438956
Update document for the actual 2.1rc1
2001-04-16 02:27:53 +00:00
Fred Drake
3fee30407e
Bump version number and set date.
2001-04-14 18:36:03 +00:00
Fred Drake
fc4ee0a296
Add convenience targets that build all archive types for single formatting
...
versions.
2001-04-13 18:00:23 +00:00
Fred Drake
8d00a0ffc3
Michael Hudson:
...
Update docs for PyDict_Next() based on the most recent changes to the
dictionary code.
This closes SF patch #409864 .
2001-04-13 17:55:02 +00:00
Fred Drake
0c4d468e39
Fixup some platform annotations.
2001-04-13 17:37:00 +00:00
Fred Drake
2441366930
Work around the conversion of ">>" and "<<" to guillemets. Reported by Ping.
2001-04-13 17:32:49 +00:00
Fred Drake
c054c75582
Work around the conversion of ">>" and "<<" to guillemets. Reported by Ping.
2001-04-13 17:25:38 +00:00
Fred Drake
62effc1127
Work around the conversion of ">>" and "<<" to guillemets. Reported by Ping.
2001-04-13 15:55:25 +00:00
Fred Drake
fb8ffe6b5e
Work around the conversion of ">>" and "<<" to guillemets. Reported by Ping.
...
Wrap some long lines and fix some markup nits.
2001-04-13 15:54:41 +00:00
Fred Drake
d20d8b319c
Work around the conversion of ">>" and "<<" to guillemets. Reported by Ping.
2001-04-13 14:52:39 +00:00
Fred Drake
a3e56a6ceb
Minor markup adjustments.
...
Turn reference to the cmd module into a hyperlink.
2001-04-13 14:34:58 +00:00
Fred Drake
e1f3ed6b58
Update the helper scripts that push development docs to SourceForge;
...
this version avoids having to build a separate authenticated connection
to push the update-docs.sh script to SF.
2001-04-13 05:13:55 +00:00
Fred Drake
3de33697ef
Add entry for ColorPicker documentation as well.
2001-04-13 04:50:01 +00:00
Fred Drake
b6bdcb23df
Documentation for Just's ColorPicker module, so the Mac OS guys get
...
something out of this documentation release as well. ;-)
2001-04-13 04:49:30 +00:00
Eric S. Raymond
4f3980d3cb
Added a test main to the pstats library that can help you browse profile dumps.
2001-04-13 00:23:01 +00:00
Fred Drake
47f11ce591
Added warning that FancyURLopener prompts the user on the terminal when
...
basic authentication is needed.
Added documentation for FancyURLopener.prompt_user_passwd(), explaining
that subclasses should provide more appropriate behavior for the hosting
environment.
2001-04-12 20:26:49 +00:00
Fred Drake
62a26699c4
Added module synopsis for the chapter summary.
...
Added documentation for TestCase.assertRaises().
Added text for "Mapping concepts to classes", and merged it into the
front matter instead of separating it into a new section.
Removed use of "assert" in examples.
Update the descriptions to reflect further changes from discussions on
the pyunit-interest list.
Added documentation for the defaultTestLoader object and the
TestLoader methods.
Added the assert*() names for the TestCase helper methods.
2001-04-12 19:34:38 +00:00
Fred Drake
e20bd19f86
Convert several \seetext references to \seerfc and \seetitle versions.
...
These format somewhat better and include more semantic information in the
source.
2001-04-12 16:47:17 +00:00
Fred Drake
24e7a29292
Work around the conversion of ">>" and "<<" to guillemets. Reported by
...
Ping on the Doc-SIG mailing list.
2001-04-12 12:37:03 +00:00
Fred Drake
0056a427bb
Added a lot of text from Steve Purcell's HTML documentation.
...
Updated reference material substantially based on discussions on the
pyunit-interest mailing list (not all changes are in the code in CVS
yet).
2001-04-12 04:50:06 +00:00
Fred Drake
c790e08ac1
Use "2.1c1" since that is what Guido used for the Python version number.
2001-04-12 04:34:26 +00:00
Fred Drake
0c14961872
Update to reflect the new string repr -- \n instead of \012. This is the
...
only documentation file that appears to be affected by the change!
2001-04-12 04:26:24 +00:00
Fred Drake
9ad526fac3
Markup nit: use \envvar to mark environment variables.
2001-04-12 04:11:21 +00:00
Fred Drake
e0197bfaeb
When forming the <A> tag for a \seepep or \seerfc, make sure we strip
...
HTML markup from the string used as the title in the TITLE attribute.
This fixes formatting in the "What's New in Python 2.1" document.
2001-04-12 04:03:22 +00:00
Andrew M. Kuchling
db7657d4e0
Explain popitem()
...
Add Unixware 7 port
Ready for RC1
Minor rewrites
2001-04-12 03:37:19 +00:00
Fred Drake
b942c2f788
Fixed bug in example.
...
This closes SF bug #415522 .
Also fix markup error in text following the example.
2001-04-11 21:33:47 +00:00
Barry Warsaw
c3cbbaf513
Added some additional documentation describing how BabylMailbox
...
actually works (it returns a message containing the visible headers,
not the original headers). Doc change approved by Fred; closes SF bug
#412230 .
2001-04-11 20:12:33 +00:00
Fred Drake
eedf985056
Include a synopsis for the chapter overview.
2001-04-11 19:17:11 +00:00
Moshe Zadka
2bd0d88360
Fixing bug 405999 -- clarifying differences between Python's
...
getopt and GNU getopt -- Python is like classical UNIX getopt.
2001-04-11 07:33:08 +00:00
Fred Drake
5d6e402e0c
Based on a comment by Konrad Hinsen on python-list:
...
Change "EOF" to "end-of-file", on the premise that it is easier for
new programmers to understand (at least a little).
This does not attempt to explain "file or device attached to standard
input."
2001-04-11 04:38:34 +00:00
Fred Drake
29be70195a
Added definition of "test fixture".
...
Added description of optional parameter to the TestSuite constructor.
Added descriptions of the TestLoader and TextTestRunner classes.
Added method descriptions for the TestCase class.
2001-04-10 22:25:06 +00:00
Fred Drake
8875c86a12
Typo: "BuildApple" --> "BuildApplet"
...
Added reference to the webbrowser module from the nsremote description.
2001-04-10 20:32:16 +00:00
Fred Drake
c5287ac66a
Bump version numbers for upcoming release candidate.
2001-04-10 20:19:25 +00:00
Fred Drake
20931fb3f4
Update the XML conversion specification.
2001-04-10 19:59:31 +00:00
Fred Drake
ac154a17a3
Remove the mapping() function from the documentation.
...
Add a description of the ReferenceError exception.
2001-04-10 19:57:58 +00:00
Fred Drake
da00cda9fa
Add note that difflib was added in Python 2.1.
2001-04-10 19:56:09 +00:00
Fred Drake
cfac6d23fd
Normalize tabs to spaces.
...
Update the attribution for the "Curses Programming with Python" How-To.
Change the way the reference to the Demo/curses/ directory is marked up.
2001-04-10 18:49:09 +00:00
Fred Drake
6fda3ac474
Add reference to the DDJ article discussing a similar algorithm.
2001-04-10 18:41:16 +00:00
Fred Drake
86333606f6
Add corresponding support for the alltt environment to the HTML generator.
2001-04-10 17:13:39 +00:00
Fred Drake
b5309a956e
Import the alltt package and wrap that environment in a similar way to
...
the way we handle verbatim, so that it picks up the same indentation and
minipage behavior.
2001-04-10 15:53:06 +00:00
Fred Drake
90a72f8dcd
Add documentation for getmoduleinfo() and getmodulename().
2001-04-10 15:12:34 +00:00
Fred Drake
697c9c9c71
In the typeset versions, the legal notices had grown past the one-page
...
size. This constrains them to fit in one page again.
2001-04-10 05:26:29 +00:00
Fred Drake
819815abea
Fix typo in example (\b should be \n in string literal).
...
This closes SF bug #414279 .
2001-04-09 15:57:06 +00:00
Fred Drake
9c846366ee
Fix a number of bugs and omissions in the AddressList documentation, most
...
noted by Steve Holden.
This closes SF bug #413876 .
2001-04-09 15:42:56 +00:00
Greg Stein
4d4d0034c0
Correct the documentation for getreadbufferproc and getwritebufferproc.
...
Fixes bug #233308 from Travis Oliphant.
2001-04-07 16:14:49 +00:00
Fred Drake
501d90471d
Add entry for unittest documentation.
2001-04-07 05:42:14 +00:00
Fred Drake
b9ad228798
Start of documentation for the unittest module. Some of this comes from
...
Steve Purcell's documentation, and a lot of it is written based on
using PyUnit and reading the implementation.
There is more to come, but I want to get this check in before I have a
disk crash or anything else bad happens.
2001-04-07 05:41:39 +00:00
Fred Drake
4cf1227e56
Change {\em ...} to \emph{...} for consistency with the rest of the Python
...
documentation.
2001-04-05 18:31:27 +00:00
Fred Drake
f459d852e5
Add some information about what to expect of the DocumentType's
...
.internalSubset attribute based on a clarification from the www-dom
list.
2001-04-05 18:30:04 +00:00
Fred Drake
c6a3cb4baf
Document PySequence_Size(), and describe PySequence_Length() as simply an
...
alternate name for the same function.
2001-04-04 01:25:17 +00:00
Fred Drake
979d041b6f
Make reference to the Library Reference in the "What Now?" chapter a
...
hyperlink.
Fix two English usage errors caught by Jan Wells: Changed "subsequence"
to "sub-sequence" in two places, and avoid improper use of "hopefully" in
the first paragraph of the "What Now?" chapter.
2001-04-03 17:41:56 +00:00
Fred Drake
c81d470648
Allow the <author/> element to appear before a paragraph without being
...
made a part of the paragraph.
2001-03-29 23:31:22 +00:00
Fred Drake
659f377ed9
Add entry for curses.panel documentation.
2001-03-29 22:23:19 +00:00
Fred Drake
14631f674f
Fix serious markup errors.
2001-03-29 22:22:23 +00:00
Fred Drake
c612a14e9e
Remove the spurious space of uncertain origin from the output for function,
...
method and constructor signatures. Suggested by Peter Funk on the Doc-SIG
mailing list.
2001-03-29 18:24:08 +00:00
Fred Drake
cb83988151
Added example use of weak references, contributed by Tim Peters.
2001-03-28 21:15:41 +00:00
Fred Drake
58c8f9f631
Added documentation for PyObject_IsInstance() and PyObject_IsSubclass().
2001-03-28 21:14:32 +00:00
Fred Drake
e2645775d1
Typo: "ariables" --> "variables"
...
This fixes SF bug #411118 .
2001-03-28 16:55:53 +00:00
Fred Drake
2bbc6974d0
Fix a number of small issues; this closes SF bug #411063 .
2001-03-28 16:51:20 +00:00