93fe96a3c8
Py_BuildValue(): Add "D" conversion to create a Python complex value from
...
a Py_complex C value.
Patch by Walter Dörwald.
This closes SF patch #407148 .
2001-03-12 21:06:31 +00:00
45bbda2593
Fix a further markup problem noted by FLD
2001-03-10 16:49:07 +00:00
f0ebbe0bd0
Re-order some method descriptions for a more logical grouping.
...
(Based on reader comment!)
2001-03-08 22:46:41 +00:00
9eb41557ef
Add more font flavors for <var> elements; the previous incarnation caused
...
some NT/IE5.5 users to see only boxes for these characters. This might be
specific to NT Service Pack 6.
2001-03-08 22:17:54 +00:00
859eb62108
Do not refer to "sub-modules" since that is not a defined term.
2001-03-06 07:34:00 +00:00
ac79e95167
Re-word the explanation of the in/not in operators for increased content
...
and clarity.
Add a footnote to the information on the possibility of shadowing builtins
with locals & module globals.
2001-03-06 07:32:11 +00:00
ce7129ea4e
Turn "Python Documentation Central" into just "Documentation Central"; some
...
Web browsers tried to wrap lines in bad ways, so we avoid the problem by
putting fewer words on the page.
2001-03-06 07:28:20 +00:00
2636572d76
Make sure the README files that contain page count information land in
...
the right directory (which actually exists).
2001-03-06 07:22:16 +00:00
67fdaa4883
Correct typos in Ping's email address.
...
Remove premature use of negative indexes in string operation examples;
negative indexes have not been explained at that point, and the use of
negative indexes are not necessary for the examples.
2001-03-06 07:19:34 +00:00
990b0fec1a
Update documentation to reflect the shift to NetrcParseError instead of
...
SyntaxError.
2001-03-06 06:55:18 +00:00
0c8f6643c6
Remove debugging "set -x".
2001-03-03 19:57:26 +00:00
42119e49a9
Fix a few minor markup nits.
2001-03-03 19:47:24 +00:00
6be838a0c0
Rene Liebscher <R.Liebscher@gmx.de>:
...
Added information on using non-Microsoft compilers on Windows.
[Minor edits for markup consistency. --FLD]
2001-03-03 19:18:01 +00:00
61af5605fa
Discuss PEP 236.
...
Update nested scope section.
2001-03-03 03:25:04 +00:00
81df7be2a2
Update estimate bug and patch counts
2001-03-02 21:19:38 +00:00
3f4e717c31
Revise the scripts I use to update the documentation on the SourceForge
...
site. These now seem (slightly) more reliable, and easier to work with
since update-docs.sh no longer needs to be installed ahead of time on
my account at SF.
2001-03-02 21:05:58 +00:00
93c867139f
Lots of organizational changes for consistency with the rest of the
...
documentation.
Fix a few small markup nits.
2001-03-02 20:39:34 +00:00
80d4c07775
There was a real leak in the "export a C API" example; fix that one.
...
(There are too many initspam() functions; they need to be renamed
post-beta.)
2001-03-02 19:48:06 +00:00
ab357ecf7f
Label classes and exceptions explicitly in the documentation (for their
...
*desc environments).
2001-03-02 18:57:05 +00:00
0539bfaaa4
There is no longer a -X option to the interpreter, so remove the comments
...
on how PyErr_NewException() behaves in that case.
Clarify why an owned reference is kept in an extension module's
variable that refers to the result of PyErr_NewException(); one reader
thought that was a leak.
Clean up some tabs and simplify some markup.
2001-03-02 18:15:11 +00:00
043d5e5514
For copyfile(), be explicit that src and dst are file names; that was only
...
implied.
2001-03-02 16:46:42 +00:00
cfef0096f9
Job.build_html(): When formatting HTML into more than one HTML page, and
...
not doing the \label{foo} --> foo.html transformation (--numeric was
specified on the command line), still look to see if there is an
"About this document..." node and copy that to "about.html", since the
page footers use that as the target.
2001-03-02 16:26:45 +00:00
7606e4d00e
Added entry for urllib2 documentation.
2001-03-01 19:54:29 +00:00
8c011580ff
Use larger chunks for the HTML version of the Distutils documentation.
2001-03-01 18:38:56 +00:00
a9a83e9ee3
Comment out section titles for sections that have not been written yet;
...
there is no need to clutter a reader's life with those useless things.
Suppress the "Contents" page for HTML; it is not needed for small documents
in the online environment since LaTeX2HTML generates lots of tables of links
anyway.
Various markup consistency nits.
2001-03-01 18:37:52 +00:00
a09262e860
Comment out section titles for sections that have not been written yet;
...
there is no need to clutter a reader's life with those useless things.
Make the snippets of Python code conform to the standard style.
Suppress the "Contents" page for HTML; it is not needed for small documents
in the online environment since LaTeX2HTML generates lots of tables of links
anyway.
Various markup consistency nits.
2001-03-01 18:35:43 +00:00
f89ad5ed6b
Document configuration flags to compile for large file support on
...
certain Linux systems.
2001-03-01 18:29:57 +00:00
8a18e99008
Checking in patch 404826 -- urllib2 enhancements and documentations.
...
(please not that the library reference does *not* include the
urllib2 documnetation -- that will wiat for Fred)
2001-03-01 08:40:42 +00:00
baee0d42c9
Bump the release number to 2.1b1.
2001-03-01 06:01:20 +00:00
694e1816c2
Fix markup nit pointed out by FLD
2001-03-01 01:02:52 +00:00
1874c8f23b
Document PyErr_WarnExplicit().
2001-02-28 23:46:44 +00:00
56ba72a563
Document warn_explicit().
2001-02-28 23:34:21 +00:00
7840a9cb99
Add entry for the inspect module.
2001-02-28 23:02:20 +00:00
6dbd382ec8
Clean up some of the markup for consistency, wrap some long lines.
2001-02-28 23:01:38 +00:00
bca60c07b3
Fix some rules broken by typos, others by the flattening of the makefile.
2001-02-28 22:59:37 +00:00
8bad993dd3
Add description of PEP235
...
Remove references to 2.1alpha
Update description of PEP229
2001-02-28 22:39:15 +00:00
74d18ed076
Cover pydoc
...
Update reference Python version to beta1
Rip out PEP 232 section
Add placeholders for PEP 236 and 235
Fix erroneous \filename references
2001-02-28 22:22:40 +00:00
bf140147d8
Document the object allocator
...
Minor sentence change
2001-02-28 22:10:07 +00:00
58177b9975
added description of NL token
2001-02-28 22:05:41 +00:00
969ab2710a
Update documentation for termios module; do not refer to the TERMIOS module
...
for constant definitions.
Add a deprecation to the TERMIOS module.
2001-02-27 22:01:15 +00:00
5e1633365d
Patch #403985 : Add support for weak-keyed dictionaries
2001-02-27 18:36:56 +00:00
6397c7c9a9
inspect: a module for getting information out of live Python objects
2001-02-27 14:43:21 +00:00
7a5e80e801
Updates to describe function attributes.
2001-02-27 03:36:30 +00:00
d4614e8371
Updates to the semantics of function and method attributes.
2001-02-27 03:32:35 +00:00
07e6c505ad
Minor adjustments, including markup corrections.
2001-02-23 19:15:56 +00:00
447f545322
Fix extra backslash in example.
2001-02-23 19:13:07 +00:00
3538c93f1a
Another name.
2001-02-23 19:11:45 +00:00
afdc8fc0ad
Fix up the markup in some recently-added portions of the text.
2001-02-23 19:10:41 +00:00
19f3c52347
Work around the broken formatting of sys.ps1 prompts in running text.
...
Move sample sessions to the left margin of the file for consistency;
formatting can adjust the margin if needed.
This closes SF bug #133213 .
2001-02-22 23:15:05 +00:00
2f55b11bf7
cd to the html/ directory to generate the global module index so the links
...
to the module sections are right.
This was also broken when converting to a flat Makefile.
2001-02-22 23:12:37 +00:00
d27ed858c3
The ACKS file is in the current directory when converted to HTML; this was
...
broken when converting to a flat Makefile. ;-(
2001-02-22 23:06:21 +00:00
cb45bfd956
Remove entry for soundex module!
2001-02-22 23:00:20 +00:00
230d17d0d1
Sequence indexes are non-negative, not natural (0 is not a natural number).
...
Reported by Daniel May <mayds@ecn.purdue.edu>.
De-tabified everywhere.
2001-02-22 21:28:04 +00:00
7c30de65f4
Remove documentation for the soundex module; the module is no longer
...
included with Python.
2001-02-22 21:25:20 +00:00
7edbd4ffb4
Patch #103885 : Add dynamic registration and lookup of DOM implementations.
2001-02-22 14:05:50 +00:00
754ba589b7
Improve accuracy. In the .tex file, note the new "% BUG:" comments: an
...
extra backslash is getting displayed in the generated HTML.
2001-02-20 11:24:35 +00:00
f0768c822b
Added missing \item. See also bug 133213, about damaged HTML generated
...
for \code(">>>"); don't know how to fix that one.
2001-02-20 10:57:30 +00:00
e79af273e8
Flesh out PlaySound() docs enough so that SND_ALIAS isn't hopelessly confusing.
...
If someone knows how to turn the new table of guaranteed-registered system
sounds into a LaTeX table, be my guest.
2001-02-20 10:02:21 +00:00
5b0705d266
ConfigParser.optionxform(): Document this since it is available for
...
sub-classes and application code to override.
2001-02-19 22:37:24 +00:00
f6a9617ba0
Michael Hudson <mwh21@cam.ac.uk>:
...
New material on defining extension types. Thanks!
(Small markup adjustments made, but this is mostly as received.)
2001-02-19 19:22:00 +00:00
842ab38d3d
No longer needed since the main Makefile is "flat".
2001-02-19 19:20:17 +00:00
f6bfe8e342
Convert to a "flat" Makefile.
2001-02-19 19:19:26 +00:00
50d1fcf61c
Add an option allowing the user to determine where the output HTML is built.
...
Provide a way to set the paper size by name instead of only supporting
separate options for each size.
2001-02-19 19:18:09 +00:00
f2502adfc1
Fix markup so this document will format.
2001-02-19 19:14:50 +00:00
c07012360e
This never saw much use, so remove it.
2001-02-19 19:11:12 +00:00
653809c122
Make the top-level index.html depend on the individual document index.html
...
files so that the date is properly updated on the front page.
2001-02-19 17:52:07 +00:00
5f52f7230c
Checked in with Andrew's blessing, I leave the comments with which
...
this was posted to distutils-sig in.
Here is what I've hacked together over some spare time
at the weekend. I would appreciate feedback, as I've told
before I'm neither a great author, nor native english speaker,
nor anything else.
Mostly I've completed (and written) docs for bdist_wininst
(where I'm an experert for), also I've started some stuff
for the data_files and scripts option.
Should I continue in this way? Would others like to jump in?
2001-02-19 17:48:03 +00:00
15bc404ca8
Added entries for difflib documentation.
2001-02-19 16:32:40 +00:00
baf71422b8
Documentation for the difflib module, converted from the module docstrings.
2001-02-19 16:31:02 +00:00
373d151666
More typos. libwinsound.tex typo noted by Peter Funk (thanks!).
2001-02-19 08:36:41 +00:00
25a9ce371c
Take a tour of hell's seedier neighborhoods to try to make winsound.Beep()
...
do something non-useless on Win9X boxes. WinME unknown to me. Someone with
NT/2000 make sure it still works there!
2001-02-19 07:06:36 +00:00
c4089d84d8
In the example showing the irrelevance of start columns, restore that the
...
start columns differ (editing had pushed them all into column 0).
2001-02-17 18:03:25 +00:00
f3262b72ca
Add entries for the doctest documentation.
2001-02-17 17:33:25 +00:00
7eb1463bb3
Make a variety of minor markup adjustments.
...
Close some environments so that this will actually format.
2001-02-17 17:32:41 +00:00
7688229f7c
SF patch #103808 : doctest.py docs
...
Checking in Moshe's patch after rewrapping some paragraphs (to consume
fewer columns) and repairing that I/2.**J lost the I.
2001-02-17 05:58:44 +00:00
30537da0ec
Fix typo
...
Makefile.pre.in was added in 1.4
2001-02-17 00:42:56 +00:00
da23c4fef9
Fix two typos, and add some omitted \option{} markup
2001-02-17 00:38:48 +00:00
04f1d37471
mention the use of the maxtries attribute of FancyURLopener in bounding
...
redirection recursion.
2001-02-15 17:00:40 +00:00
bf416fa0dd
Document default blocksize for storbinary().
2001-02-15 13:53:40 +00:00
523ec5709b
Make some clarifications and corrections based on comments from Guido.
...
Fix a few markup nits.
Work around a LaTeX2HTML nuisance.
2001-02-15 05:37:51 +00:00
e4f1c3276a
Be more careful to avoid spurious output from the shell script that
...
unpacks the development version of the docs on SF.
2001-02-14 21:26:31 +00:00
8bcc4e8446
Commit this so CVS doesn't keep noticing the next version number.
2001-02-14 20:53:07 +00:00
15862f50e5
Add a note to Node.isSameNode() that it is based on the DOM Level 3 working
...
draft. I'm not sure that's important, but Uche thinks it is.
2001-02-14 20:39:15 +00:00
1d8ad2b1de
Updated to reflect the additional information and interfaces exported in
...
pyexpat.c revision 2.40.
2001-02-14 18:54:32 +00:00
7530208d8b
Feeble attempt to repair obsolete info about hex escapes.
2001-02-14 04:03:51 +00:00
162c6a637a
Reflect change in traceback format:
...
"innermost last" --> "most recent call last"
2001-02-14 03:20:18 +00:00
15ad28cf89
Finished the section on weak references
...
Mentioned doctest, difflib, sys._getframe(), and the change to use
PyImport_ImportModule() everywhere in C code
No more XXX!
2001-02-14 02:44:18 +00:00
e7d7e6c879
Fix two typos
2001-02-14 02:39:11 +00:00
5401996638
Update to properly explain that the default Unicode encoding is ASCII, &c.
2001-02-13 22:20:22 +00:00
498cb15306
Jon Nelson <jnelson@users.sourceforge.net>:
...
Make the documentation tools work with Python 1.5.2.
[Slightly modified from submitted patch. --FLD]
This closes SF bug #132005 .
2001-02-12 19:12:55 +00:00
a05460c148
PyTuple_*() functions take PyObject* parameters, not PyTupleObject* values.
...
This closes SF bug #131304 .
2001-02-12 17:38:18 +00:00
e38d481e77
Add a "description" meta tag that includes a version number.
2001-02-12 16:04:24 +00:00
b258bedb13
Jon Nelson <jnelson@users.sourceforge.net>:
...
Make the documentation tools compatibile with Python 2.0.
2001-02-12 15:30:22 +00:00
81b6ae7ef7
Create separate section for changes to the standard library
...
Make note about difflib and doctest
Bump version number
2001-02-11 16:55:39 +00:00
5ed1dac4c0
Update documentation for pyexpat (xml.parsers.expat), to reflect the new
...
support for Expat 1.95.*.
2001-02-08 15:40:33 +00:00
6a360bd3a7
Wrote section on nested scopes, and moved it to the front
...
Began a section on weak references
Various rewrites and paragraph refills
Added: non-recursive makefiles, repr() of strings now uses \n, raw socket I/O
Bumped version number
2001-02-05 02:47:52 +00:00
4e3f2752c5
Improve diagnostic output when an external command returns a non-zero exit
...
code, showing the transcript for that command.
This closes SF bug #129740 .
2001-02-04 15:20:26 +00:00
cf2636696d
Fix markup typo in a {verbatim} environment (there should not be any!);
...
caught by Eric Raymond.
2001-02-03 14:35:38 +00:00
40e43bfaf7
Document Node.isSameNode().
2001-02-03 01:20:01 +00:00
f891404e1a
Move the whrandom section back to the documented modules section; this
...
gives people a chance to see the depracation notice.
2001-02-03 01:17:41 +00:00
269625f67a
Revise the deprecation note for the whrandom module to be correct and a
...
little more formal.
2001-02-03 01:12:44 +00:00
f0e08ef9cb
Remove an now-false statement about there being only one type flag
...
defined.
2001-02-03 01:11:26 +00:00
24da47708d
Do not pass names of individual files to shutil.rmtree(); use os.unlink()
...
for that.
2001-02-02 15:48:00 +00:00
6270031f4e
Adjustments to the text of the UnixMailbox description. Added
...
PortableUnixMailbox as a separate class as well (this also generates
the right index entry).
2001-02-02 03:51:05 +00:00
57d943ad38
Move the whrandom entry to the "Obsolete Modules" appendix.
2001-02-02 02:45:08 +00:00
667c9e46ca
Minor markup adjustments.
...
Move some index entries next to what they are referring to for better
"targetting".
2001-02-02 02:43:18 +00:00
844bd5b4a9
Minor markup adjustments.
2001-02-02 02:42:31 +00:00
68b6417c5a
Added a warning at the top saying that user code should not use the
...
whrandom module directly.
2001-02-02 02:41:17 +00:00
3faa52ecc4
Allow 'continue' inside 'try' clause
...
SF patch 102989 by Thomas Wouters
2001-02-01 22:48:12 +00:00
d0946da701
Fix some markup breakage that prevented formatting; re-wrapped a couple of
...
wide paragraphs.
2001-02-01 15:53:24 +00:00
c2e35e6f37
Remove spurious "\end{description}" that caused formatting to fail.
2001-02-01 15:37:56 +00:00
36154b2dbf
Added entry for weakref documentation.
...
Moved commented-out entries for obsolete module to an appendix, still
commented out.
2001-02-01 05:21:46 +00:00
0d0e64861b
Add entry for weakref documentation.
2001-02-01 05:20:52 +00:00
ebcf6a8573
Documentation for the weakref module.
2001-02-01 05:20:20 +00:00
0de88fc4b1
Change random.seed() so that it can get at the full range of possible
...
internal states. Put the old .seed() (which could only get at about
the square root of the # of possibilities) under the new name .whseed(),
for bit-level compatibility with older versions. This occurred to me
while reviewing effbot's book (he found himself stumbling over .seed()
more than once there ...).
2001-02-01 04:59:18 +00:00
0eb107068a
update section 4.1 to describe nested scopes
2001-02-01 03:50:59 +00:00
30dbd1429a
Document the two changes to the mailbox.py module:
...
- All constructors grow an optional argument `factory' which is a
callable used when new message instances are created by the next()
methods. Defaults to the rfc822.Message class.
- A new subclass of UnixMailbox is added, called PortableUnixMailbox.
It's identical to UnixMailbox, but uses a more portable test for
From_ delimiter lines. With PortableUnixMailbox, any line that
starts with "From " is considered a delimiter (this should really
check for two newlines before the F, but it doesn't.
2001-01-31 22:14:01 +00:00
b416290d5d
Some rewriting of the "Internationalizing your programs and modules"
...
subsection to include a discussion of the msgfmt.py program.
2001-01-31 21:21:45 +00:00
5599441bbf
Make HTML the default output format, since that is what people actually
...
want most of the time.
2001-01-30 22:30:01 +00:00
10f8ba4fc6
Remove note about the compiler not checking for two kinds of illegal
...
imports. It checks for them now.
2001-01-30 01:25:15 +00:00
4308d3c4b5
Add note about non-recursive Makefiles
...
Get Fred's name right
Add some XXX items that need to be written
2001-01-29 17:36:53 +00:00
3229b859fb
More on noutrefresh() and scroll().
2001-01-29 06:39:33 +00:00
4fda21ba6b
updated to document use of sequences of two-element tuples as inputs
2001-01-28 21:18:16 +00:00
c37f5b3296
Adjust documentation for new.instance() to reflect that the second
...
parameter may be omitted or None.
2001-01-28 17:23:05 +00:00
5838d0fc84
Document the PyInstance_*() functions and data.
2001-01-28 06:39:35 +00:00
9ca35ec97a
Instructive example for strftime(); how to generate RFC822 dates.
2001-01-28 00:56:54 +00:00
e7213c7a80
Emphasis that instantiating this class doesn't consume the message body.
...
Fix some unclear language in the description of the addrlist member.
2001-01-27 10:56:14 +00:00
66f98b45cd
Fix a number of typos found by Guido.
2001-01-26 20:51:32 +00:00
8c071d4388
Massively improved documentation for string formatting operations,
...
primarily from Evelyn Mitchell (thanks!).
This closes SF patch #103412 .
2001-01-26 20:48:35 +00:00
2f4453af6a
Typo: coplete --> complete
...
This closes SF bug #129759 .
2001-01-26 15:27:35 +00:00
e360d9507a
The combo of getstate/setstate/jumpahead is very powerful, but needs
...
examples to flesh it out for the uninitiated. Here they are.
2001-01-26 10:00:39 +00:00
8863460490
Add bzip2 archives back to the set of generated archives; we had way too
...
many reasonable requests to keep them around.
Bump version number.
2001-01-25 17:32:51 +00:00
29052482d1
Removed references to Python 1.5.3; that was a "tentative" number I used
...
in the docs to indicate the next version before we decided on 1.6.
Adjusted winsound.Beep() description slightly as well.
2001-01-25 17:29:18 +00:00
cf069da57d
Update link to LaTeX2HTML web site.
2001-01-25 17:25:28 +00:00
517ce23183
Clarify winsound.beep docs, in response to c.l.py beep brouhahalet.
2001-01-25 09:33:48 +00:00
d52269bfd0
Fix bugs introduced by rewrite (in particular, time-based initialization
...
got broken). Also added new method .jumpahead(N). This finally gives us
a semi-decent answer to how Python's RNGs can be used safely and efficiently
in multithreaded programs (although it requires the user to use the new
machinery!).
2001-01-25 06:23:18 +00:00
d7b5e88e8e
Reworked random.py so that it no longer depends on, and offers all the
...
functionality of, whrandom.py. Also closes all the "XXX" todos in
random.py. New frequently-requested functions/methods getstate() and
setstate(). All exported functions are now bound methods of a hidden
instance. Killed all unintended exports. Updated the docs.
FRED: The more I fiddle the docs, the less I understand the exact
intended use of the \var, \code, \method tags. Please review critically.
GUIDO: See email. I updated NEWS as if whrandom were deprecated; I
think it should be.
2001-01-25 03:36:26 +00:00
83125775e0
A \begin{funcdesc} was closed with an \end{methoddesc}.
2001-01-25 00:39:16 +00:00
21f37e1b88
Fixed a bug where \& was needed.
2001-01-25 00:38:15 +00:00
8ee1a4bdeb
Provide a much better (and complete!) description of the lockf()
...
function, based on an eyeballing of the code.
2001-01-25 00:36:54 +00:00
902446a28d
Supply long-missing docs for random.seed(). Extensive rewrite of module
...
intro docs.
*************** Fred: check my LaTeX! Also, the docs for whrandom should
*************** be moved into Obsolete Modules.
2001-01-24 23:06:53 +00:00
9368a12011
Fix an obvious usage nit I should have caught myself on the previous
...
change to this file. Thanks, /F!
2001-01-24 18:19:40 +00:00
fa004ad36c
Show '\011', '\012', and '\015' as '\t', '\n', '\r' in strings.
...
Switch from octal escapes to hex escapes for other nonprintable characters.
2001-01-24 17:19:08 +00:00
0bbaa515a1
Remove evil "sec:" prefix from some \label markups; this is bad for
...
filenames on Windows (& Mac?) platforms.
2001-01-24 16:39:35 +00:00
b1b6a11b28
AttributeList --> NamedNodeMap
...
Since there is no such thing as an AttributeList, don't say "attributes"
is one.
2001-01-24 16:17:15 +00:00
0110d3b2ad
new unicodedata functions (name, lookup)
2001-01-24 08:10:07 +00:00
eda28445c0
documented (new) optional doseq parameter to urlencode.
2001-01-24 06:36:06 +00:00
1ae43c4341
Add names of people who've pointed out broken links and images
...
Bump version number
2001-01-24 01:11:26 +00:00
d975196d57
Fredrik pointed out that the database shrank more than 55K
2001-01-24 00:52:56 +00:00
26e94a8822
Jeremy didn't write PEP 205, Fred did!
2001-01-23 15:21:05 +00:00
f79cb2db3e
Expose the autoraise capability. Improve the documentation.
2001-01-23 13:49:44 +00:00
aeb5532ca0
Oops...finish a mangled sentence.
2001-01-23 13:22:28 +00:00
f7f185116a
Rewrite webbrowser.py to fix various bugs following Ka-Ping Yee's
...
complaints. The new version moves most of its initialization to
package load time; it's simpler, faster, smaller, and adds support for
Mozilla and Links. Interpretation of the BROWSER variable now works
and is documented. The open_new entry point and methods are marked
"deprecated; may be removed in 2.1".
2001-01-23 13:16:32 +00:00
f33c118869
Add introductory note about this article's draft status
...
Grammatical and typographic fixes from David Goodger
Expanded notes about PEP 229
Removed user-visible XXXes; they're in comments now
2001-01-23 02:48:26 +00:00
da6daee439
A variety of updates of out-of-date information.
2001-01-22 21:38:09 +00:00
bc3974c03b
When generating the source package, copy in the LICENSE file from the main
...
source directory.
2001-01-22 21:34:20 +00:00
9c3b9b76c1
Never mind ignoring a copied LICENSE file; let's do this another way.
2001-01-22 21:31:38 +00:00
e94b9f9d3c
Ignore the generated LICENSE file needed for the documentation source
...
package.
2001-01-22 21:07:36 +00:00
3a045e8993
Change the main targets to generate HTML instead of PostScript.
...
Update the comments at the beginning of the file.
2001-01-22 20:47:26 +00:00
dc40ac0fe0
Added link to the "Python Codecs" project at SourceForge.
...
Changed markup of the list of values for the list of meaningful "errors"
values.
2001-01-22 20:17:54 +00:00
91834c6c7e
Added dictionary.popitem() and the improved XML modules.
...
Reorder the smaller items, roughly in decreasing order of visibility to
the Python coder
Finished an incomplete sentence.
Moved the unwritten sections down to the bottom.
Bumped version number and added acknowledgements
2001-01-22 19:51:13 +00:00
0f564eaceb
Change some wording to make this work with PDF generation -- using a PDF
...
hyperlink at the start of the paragraph confused pdflatex; it saw the
link start while still in vertical mode, which is not allowed. Including
text before the link forces horizontal mode.
2001-01-22 19:06:20 +00:00
bcb09fa33f
Worked around bug SF #125880 : changed the text of three sections that
...
really nasty TeX source to "bleed" into the PDF "bookmarks".
2001-01-22 18:38:00 +00:00
5f0decf0d3
Clean up the docs for the "random" module according to comments from Tim
...
Peters.
This closes SF bug #125919 .
2001-01-22 18:18:30 +00:00
f228fd10d9
Add reference to PEP 232.
...
Use correct flag name Py_TPFLAGS_CHECKTYPES
Mention that numeric methods can return Py_NotImplemented (NAS)
Mention optional arguments in time modules (TW)
Various minor rewrites and additional attributions
2001-01-22 17:52:19 +00:00
31ab298df6
Remove the dollar sign from the formatting of environment variables --
...
too Unix-specific, and not really needed. (Already fixed the HTML
formatting, but forgot to mention it in the checkin for python.perl 1.94.)
2001-01-22 17:50:42 +00:00
0a8690a0ad
Make "PythonLabs" bold.
2001-01-22 17:48:23 +00:00
c8e8281fb6
Updated note about collection of cyclic garbage, based on comments from
...
Chris Ryland.
2001-01-22 17:46:18 +00:00
ef8cd7ca99
Minor markup adjustment.
2001-01-22 17:42:32 +00:00
afc7ce118e
Fix \seepep handling -- correct URL to the online PEP repository on SF is
...
now generated. (SF bug #129692.)
Patch from Anthon van der Neut <anthon@mnt.org>:
Work around the removal of content-less paired tags used for name
anchors in some places. (SF bug #116008.)
Move some class attributes from an artificial SPAN element to otherwise
"useful" elements that are being generated anyway. Added the class
"versionnote", used for \deprecated, \versionadded, \versionchanged.
2001-01-22 17:33:24 +00:00
b216ab632f
Fill out various transcripts and XXX bits, thanks to the WMATA.
...
The only missing section is the Nested Scopes section, which has to wait
to see if a patch is actually committed. (Plus any other notable changes
that get made or backed out between now and 2.1final, of course...)
2001-01-22 16:15:44 +00:00
90cecee894
Beginning of a "What's New in Python 2.1" article
2001-01-22 04:02:09 +00:00
fe385251f4
Make the 'time' argument to the timemodule functions strftime, asctime,
...
ctime, gmtime and localtime optional, defaulting to 'the current time' in
all cases. Adjust docs, add news item. Also convert all argument-handling to
METH_VARARGS. Closes SF patch #103265 .
2001-01-19 23:16:56 +00:00
5566c1ce36
Fixed a bunch of typos caught by Gilles Civario.
2001-01-19 22:48:33 +00:00
0fe5af9b4d
Clarify comments about returning None using a return without an expression;
...
this is not hard to explain!
Closes SF bug #129345 .
2001-01-19 22:34:59 +00:00
6f77667a64
Backed out the unistr() builtin.
2001-01-19 21:36:19 +00:00
bc0b260a77
Minor markup cleaning, and one required fix in the unistr() description.
2001-01-18 18:09:07 +00:00
ab782dd6cc
Document rich comparisons.
2001-01-18 15:17:06 +00:00
9483bed6d9
correct typo - closes bug #129205
2001-01-18 10:44:08 +00:00
3a9582fbe5
Fix the example (it didn't seem to reflect reality).
2001-01-18 07:50:17 +00:00
a544ea2354
Undoing the whitespace patches which sneaked into the earlier patch.
2001-01-17 18:04:31 +00:00
ad7c98e264
This patch adds a new builtin unistr() which behaves like str()
...
except that it always returns Unicode objects.
A new C API PyObject_Unicode() is also provided.
This closes patch #101664 .
Written by Marc-Andre Lemburg. Copyright assigned to Guido van Rossum.
2001-01-17 17:09:53 +00:00
90badd1286
Add a missing newline in an example; caught by Chris Ryland
...
<cpr@emsoftware.com>.
2001-01-17 05:12:13 +00:00
20ab9e9c0a
Document xreadlines() method. (Forgot to check this in before!)
2001-01-17 01:18:00 +00:00
25be1931a0
Fix a few small markup/consistency nits.
2001-01-16 20:52:41 +00:00
bd1a489759
push_source() and pop_source() entry points for shlex instances.
...
These basically just make available to the user what userhook()
does to the source stack. Documentation included.
2001-01-16 14:18:55 +00:00
83ad5015cb
effbot caught a typo!
2001-01-15 20:51:40 +00:00
773d9f09be
Document function attributes for both the function type and the method
...
type. The method documentation also includes a new brief discussion
of `bound' vs. `unbound' and why setting an attr on a bound method is
a TypeError. Includes Skip's suggested text.
2001-01-15 20:28:50 +00:00
a770e866d6
Fixing author's email address.
2001-01-15 17:08:45 +00:00
97d3b93c2f
Document changed default to passive mode.
2001-01-15 16:37:05 +00:00
77b20f099e
Document filterwarnings(..., append=<bool>).
2001-01-14 14:10:18 +00:00
34bafcc079
Fix a variety of minor nits and typos caught by Chris Ryland
...
<cpr@emsoftware.com>.
2001-01-14 02:57:14 +00:00
1beb3d204f
Added note that this module was added in Python 2.1.
2001-01-12 22:57:32 +00:00
ca7e1ee01a
Updated descriptions to incorporate additional information from Tim Peters.
...
This mostly closes SF bug #128251 .
2001-01-11 22:49:49 +00:00
a177c40daf
Document \code{import} in pth files.
2001-01-11 22:07:25 +00:00
49c9ac30a4
Fixed minor markup nits for consistency with the rest of the library
...
reference.
2001-01-11 16:02:08 +00:00
ab78beca2f
Added pointer on POP3 variations.
2001-01-11 10:22:34 +00:00
f68f2fec7d
Implementation of PEP-0217.
...
This closes the PEP, and patch 103170
2001-01-11 05:41:27 +00:00
5ac97957f7
Corrections and additions to the documentation for POP3 and IMAP library
...
support, based on my fetchmail experience.
2001-01-11 04:19:52 +00:00
8321026ff4
SourceForge patch #103140 , checked in at fdrake's invitation. Minor fixes and
...
additions to library docs.#
2001-01-10 19:34:52 +00:00
fe338ca540
Fix a typo, remove one copy of a duplicated name.
2001-01-10 05:33:38 +00:00
675e1d0a0d
Remove bogus "echo" command.
2001-01-09 22:50:13 +00:00
3c48ef7de8
Added documentation for the xreadlines module & related changes. The
...
documentation was written by Jeff Epler (thanks!).
2001-01-09 22:47:46 +00:00
42181dba8e
Added a --global-module-index option to specify a (possibly relative) URL
...
to the Global Module Index for a set of documents. This is used to include
a reference to the global index from the per-document module indexes, so
that it is just a little easier to find.
(Someone suggested this, but I do not remember who. Please let me know if
it was you -- thanks!)
2001-01-09 22:02:10 +00:00
c49480ed51
Miscellaneous updates.
2001-01-09 21:40:52 +00:00
347a62505c
Steve Holden <sholden@holdenweb.com>:
...
Clarify the handling of characters following backslashes in raw strings.
2001-01-09 21:38:16 +00:00
d5f0198dec
Added names.
2001-01-09 20:55:09 +00:00
986eafdc2b
Added missing word; fixed minor nits.
2001-01-09 20:54:15 +00:00
37f1b34b62
Added entry for fpectl module documentation.
...
Moved the mutex docs to be adjacent to the sched docs, since these are
meant to be used together (if they are used at all!).
2001-01-09 20:52:49 +00:00
fa214cca61
Added entry for fpectl module documentation.
2001-01-09 20:50:02 +00:00
a5e7ad99d5
Documentation for the fpectl module, from Lee Busby. (Thanks!)
2001-01-09 20:38:54 +00:00
45b1d6a831
Explain that long options are matched based on a unique prefix rather than
...
requiring the whole option to be typed out.
This closes SF bug #126863 .
2001-01-08 16:05:51 +00:00
81473b12b7
The Python/C API deals in PyObject*, not PyDictObject*.
2001-01-08 05:53:53 +00:00
e1d4715a6f
Update explanation of the set_location() method to indicate that in
...
BTree databases, the key need not be in the database. Also, tell about
the exception if the key is not in the DB for other DB types.
This closes SF bug #127377 .
2001-01-05 06:44:19 +00:00
b31d36cf01
Fix the bugfix for SF bug #127151 -- make sure we map "previous_page" to
...
"previous" and "next_page" to "next". This way the proper icons are found.
2001-01-04 15:16:01 +00:00
445f832060
__rcmp__() description: Changed to indicate that this is no longer
...
supported as of Python 2.1. We still need to
have an entry for this since it is reasonable
for users to want to understand existing code.
This closes SF bug #122715 .
2001-01-04 15:11:48 +00:00
4e18f07613
Based on comments from Guido, do not describe bisect() and insert() as
...
being "for backward compatibility." Also revert to using bisect() in the
example, since Guido thinks that is the best recommendation for typical
usage.
2001-01-04 14:18:55 +00:00
288927f426
Markup nit: Command line options should be marked with \programopt.
...
Other minor markup nits fixed.
Make reference to PyErr_Warn() a hyperlink.
2001-01-04 05:59:37 +00:00
316ef7c574
Markup nit: Command line options should be marked with \programopt.
2001-01-04 05:56:34 +00:00
b162d188f6
Fix typo spotted by Detlef Lannert <lannert@users.sourceforge.net>.
2001-01-04 05:48:08 +00:00
19ae78302e
Added information about the interaction of opening a file in append mode
...
and seek() in the description of seek().
This closes SF bug #126850 .
2001-01-04 05:16:39 +00:00
22e9a5eaec
Markup nit: OK and ERR should be marked \constant in running text.
2001-01-04 05:14:45 +00:00
2a72712efe
Update documentation to include the new functions, and use the more
...
explicitly-named bisect_right() in the example code.
This closes SF bug #127055 .
2001-01-04 05:12:52 +00:00
9c15fa7a0f
Description of long(): A string parameter is no longer required to be
...
*decimal*.
This closes SF bug #127273 .
2001-01-04 05:09:16 +00:00
48c2eb9165
Document the NotImplemented object.
2001-01-04 01:25:50 +00:00
d18722b99d
Do not cache <img> tags for navigation icons as agressively; this fixes
...
bug #127151 .
2001-01-02 22:08:48 +00:00
2cba0f641f
Improve description of else clause of the try/except/else statement.
...
This closes (again!) bug #127098 .
2001-01-02 19:22:48 +00:00
cc97f8c609
Fix up an awkward sentence, pointed out by Chris Ryland <cpr@emsoftware.com>.
2001-01-01 20:33:06 +00:00
8e2b6b5cc7
Change documentation of 'else' clause of 'try/except' to make clear that it
...
doesn't get triggered by 'return', 'break' or 'continue'. If the
'try-inside-continue' patch does not get accepted before next release, the
'or continue' should be removed ;P
Closes SF patch #103045 and SF bug #127098 .
2000-12-31 22:52:59 +00:00
be0630282e
Fix doubled word
2000-12-26 16:14:32 +00:00
8694cc42ab
Remove redundant reference to tab (since it = 'horizontal tab')
2000-12-26 16:09:37 +00:00
e6bf85845f
Document ERR and OK
2000-12-26 15:58:27 +00:00
1dea760ca1
Make sure subsections are formatted into HTML pages with reasonable names.
2000-12-25 06:19:08 +00:00
f08cbb1771
Added information on the ExternalEntityParserCreate() method.
2000-12-23 22:19:05 +00:00
5caee408b8
Add 'see also' link to curses.panel
2000-12-22 22:06:43 +00:00
676634beda
Added documentation for the panel wrapper module
2000-12-22 21:57:42 +00:00
e412e7a3a0
Fix lots of small markup nits.
...
Wrapped some long lines.
2000-12-21 17:04:31 +00:00
68a6f5a0a2
Document the window.overlay() and .overwrite() methods
2000-12-21 16:25:44 +00:00
68abe832b9
Fix typo
2000-12-19 14:09:21 +00:00
5db5ba1ee3
Document the warnings module.
2000-12-19 06:01:23 +00:00
dea764d7f1
Updated string literals description to encompass Unicode literals and the
...
additional escape sequences defined for Unicode.
This closes bug #117158 .
2000-12-19 04:52:03 +00:00
1367b83797
Document warning categories.
2000-12-19 04:27:54 +00:00
035f7e88c8
Clarify __repr__ and __str__.
2000-12-19 04:18:13 +00:00
5b56765fe7
Added documentation on the ErrorHandler interface.
...
This closes bug #126034 .
2000-12-19 04:07:54 +00:00
e22e4b2b59
Oops. The value "0 or +1" for the category argument of PyErr_Warn()
...
doesn't work. Make it 0. (Although it really *should* be 0 or +1 --
the refcount is incremented when it is raised as an exception, but not
otherwise.)
2000-12-19 03:58:11 +00:00
9a18a7ed03
Document Pyerr_Warn().
...
Add an XXX comment at the beginning expressing disappointment over the
confusing way refcount behavior of arguments is documented.
2000-12-19 03:53:57 +00:00
3dbb406335
Document Pyerr_Warn().
2000-12-19 03:53:01 +00:00
2b6d7bc151
Do not talk about "real" numbers; talk about "floats" or "floating point
...
numbers" instead; we have not described "reals" anywhere else in the
documentation, and this is not the place to change the story!
Reported by Keith Briggs <keith.briggs@bt.com>.
2000-12-18 13:50:24 +00:00
e9e860faf3
Add support for gdbm2 open flags ('s' and 'u'). Add module constant
...
open_flags which contains the flags supported by gdbm. Closes patch
#102802 .
2000-12-17 07:14:13 +00:00
5100133685
urlretrieve() description included explanation of "data" parameter, but
...
did not include it in the signature.
Fixed some markup nits.
2000-12-15 23:57:51 +00:00
065cba1281
Added documentation for random.shuffle().
2000-12-15 19:07:17 +00:00
29c45a5e91
Grant Griffin <grant.griffin@honeywell.com>:
...
Clarify that invert() is a *bitwise* operation.
2000-12-15 05:41:49 +00:00
4fb588240f
Document napms()
...
Add reference to demo directory
2000-12-15 01:03:23 +00:00
de77bc5468
For the title page, insert the package version number before the date.
...
This makes the title area more like the title are of the top-level
index, and puts the information more people are interested in first.
2000-12-14 18:36:12 +00:00
f0b315478b
Update information on the locking() function, added the needed constants.
...
(Thanks for the info, Tim!)
2000-12-14 03:11:24 +00:00
48971198c5
Finish a sentence that was left half-written!
2000-12-13 22:36:02 +00:00
dd802208a7
Changing allow_reuse_address's default value, and documenting it.
2000-12-13 20:39:22 +00:00
24d6da3eae
Added "stub" documentation for xml.dom.pulldom for Paul to fill out with
...
useful explanations.
2000-12-13 19:34:38 +00:00
bc9c1b15cc
Added descriptions of the defined exceptions and their mapping to the
...
DOM recommendation.
2000-12-13 17:38:02 +00:00
ff63f2023d
"Documentation" for {}.popitem().
2000-12-12 22:03:47 +00:00
dc90cc2b15
Additional docs for __iadd__ and family, closing SF bug #117178 and SF patch
...
#102169 .
2000-12-11 23:11:51 +00:00
2a22200ab4
Adjust explanation of operator precedence summary -- exponentiation groups
...
from right to left!
Closes bug #125391 .
2000-12-11 22:39:24 +00:00
ed911b8cfb
Added link to HTML version of the NumPy documentation.
...
This closes bug #124943 .
2000-12-11 20:57:13 +00:00
5255c791cc
select.select(): Add note that though this function accepts empty lists,
...
using *only* empty lists may not be acceptable on all
platforms, with the specific caveat that it does not
work on Windows. Also clarified list of acceptable
objects that may be in the lists, to let the user know
that file objects are not usable here on Windows.
2000-12-11 15:50:07 +00:00
9a29dd6580
Lots of small improvements and bits of added information on the DOM API.
2000-12-08 06:54:51 +00:00
c3b18d7ca8
Fix error noted by Gerrit Holl (old; had been buried in my INBOX):
...
sequence repitition works just fine with long integers now, so we
should not say that only plain integers are allowed.
2000-12-07 04:54:02 +00:00
0c47559352
Added a note that objects which emulate built-in types should only
...
implement as many of the relevant methods as make sense for the particular
information being modelled.
2000-12-07 04:49:34 +00:00
16942f2224
Lots of additional information. Not done, but much better.
2000-12-07 04:47:51 +00:00
4c12ee866b
Another name!
2000-12-07 00:06:46 +00:00
fd4d29cf5d
Typo caught by Jim Tittsler <jwt@onjapan.net>: They --> The
2000-12-07 00:03:24 +00:00
b62966c175
Note that, as of Python 1.6, the .returns_unicode attribute on parser
...
objects can be modified at any point with the expected results.
2000-12-07 00:00:21 +00:00
b6a54d2a2c
_getframe(): New sys module function for getting at the stack frame.
...
Implements and closes SF patch #102106 , with Guido's suggested
documentation changes.
2000-12-06 21:47:46 +00:00
21e4dd0492
Two typos caught by /F; thanks!
2000-12-04 22:29:17 +00:00
e119c8fc61
Added a comment for ContentHandler.characters() explaining how to migrate
...
SAX1 code to SAX2, based on bug #123695 .
2000-12-04 22:04:15 +00:00
57657bce94
Update Moshe Zadka's email address to one works and might last a while.
2000-12-01 15:25:23 +00:00
5725d1eb03
Backing out my changes.
...
Improved version coming soon to a Source Forge near you!
2000-11-30 19:30:21 +00:00
1a62750eda
Added .first{item,value,key}() to dictionaries.
...
Complete with docos and tests.
OKed by Guido.
2000-11-30 12:31:03 +00:00
827bb9fb3c
Adjust to allow an explanation of the changes to be included in the
...
notification message.
2000-11-30 07:38:59 +00:00
e463f8e4cd
A few small refinements to the table building code.
2000-11-30 07:17:27 +00:00
c01f6e691b
Use a table to describe the keys to the locale information dictionary;
...
this is slightly easier to read than the list environment that had been
used.
2000-11-30 07:13:58 +00:00
e0b9deb3ce
Use small tables instead of bare \item markers to describe the contents
...
of return tuples. The bare \item took advantage of an implementation
detail when formatting in LaTeX, and was just wrong when generating HTML.
It also broke the XML conversion scripts, since there was no enclosing
list-like environment to contain them.
2000-11-30 07:12:54 +00:00
1aaf5855f7
Added name.
2000-11-30 07:09:59 +00:00
6b3f3f2861
In the first discussion showing how to handle exceptions from C, make the
...
Python equivalent actually equivalent to the C code. Also, in the C code,
place the "goto" statements on a line by themselves for better visibility
of statements that affect control flow.
This closes bug #123398 .
2000-11-29 15:48:22 +00:00
f65ab1bf10
Added entries reflecting the separation of the abstract DOM documentation
...
and the implementation docs for xml.dom.minidom.
2000-11-29 06:11:29 +00:00
eaf57aa44a
Substantial re-organization of the DOM documentation. The abstract API
...
is now separated from the supplied standard implementation. Not all
interfaces are documented yet, but the structure is better set up to do
so.
There is still a lot to do here, but the shape of the documentation is
coming into line.
2000-11-29 06:10:22 +00:00
4a6f1df48c
Fix broken backslashes in Unicode strings section.
...
This closes bug #123730 .
2000-11-29 06:03:45 +00:00
657ebef2ae
Partial fix for SF bug 123730: extra backslash in tutorial.
2000-11-29 05:51:59 +00:00
ee814bf2c9
Added documentation for the Py_InitModule*() family of functions.
2000-11-28 22:34:32 +00:00
83ff4af1a3
Added information on the use of Unicode with the StringIO and cStringIO
...
modules, otherwise the behavior is just plain confusing.
2000-11-28 16:24:28 +00:00
0a0ef8696b
Use a subclass of buildindex.Node to clean up the HTML and get the
...
ordering fixed up (this makes sure that "xml.dom" comes before
"xml.dom.minidom" in the Module Index, which was not true before because
some HTML cruft crept into the data structures).
2000-11-28 16:20:50 +00:00
6763b31731
Added brief explanation of the \versionchanged for 1.5.2 (fixes formatting
...
for the HTML version).
2000-11-28 06:39:28 +00:00
2fef3abc74
Two minor nits.
2000-11-28 06:38:22 +00:00
b7a52c9de3
Minor typo: \subsubsections --> \subsubsection
2000-11-27 20:10:18 +00:00
c113465a49
SF non-bug 123520: fleshed out the tutorial's lambda example a little more.
2000-11-27 06:38:04 +00:00
fed0d09075
Conversion.write_ordinal(): Not used, remove it.
2000-11-22 17:59:32 +00:00
691a5a7c09
Convert the LaTeX "tie" (~) to a simple space.
...
Add support for some combining characters.
Remove unnecessary imports and dependencies on PyXML and esistools.
2000-11-22 17:56:43 +00:00
382a75d0e9
Update to reflect the process changes.
...
Remove the SGML aspects; there's too much XML momentum to worry about
the SGML flavor at this point.
2000-11-22 16:58:25 +00:00
97be740cd8
Update the rules to separate the two phases for the ESIS generation,
...
entirely so that debugging can be performed independently.
2000-11-22 16:54:20 +00:00
d397f236d5
Add support for (relatively) recent additions and changes to python.sty,
...
and one more standard LaTeX macro.
2000-11-22 16:45:19 +00:00
0ac000cd54
Updates to reflect pending changes to the XML conversion process.
2000-11-22 16:42:37 +00:00
Fred Drake
Andrew M. Kuchling
Guido van Rossum
Moshe Zadka
Skip Montanaro
Martin v. Löwis
Ka-Ping Yee
Barry Warsaw
Tim Peters
Thomas Heller
Jeremy Hylton
Eric S. Raymond
Fredrik Lundh
Thomas Wouters
Marc-André Lemburg
Neil Schemenauer