99a3701618
Documentation for poll() interface (SF patch #100852 )
2000-08-25 01:21:28 +00:00
12bba852a9
Rough and incomplete documentation on augmented assignment, which follows
...
shortly. Markup also needs checking.
2000-08-24 20:06:04 +00:00
3d0c77b37c
Addresses the other half of Bug #112634 -- the documentation suggested
...
that you can set self.version *after* calling the base class __init__.
In fact it must be done *before*.
(Fred, maybe the version class variable should be documented now?)
2000-08-24 16:20:32 +00:00
45ca3331d9
Move references to RFCs to a "See also" section for consistency with
...
other sections of the library reference.
2000-08-24 04:58:25 +00:00
9fa4d61bcc
Moshe Zadka <moshez@math.huji.ac.il>:
...
Documentation updates for urlretrieve() and URLopener.retrieve(), to
reflect Randall Hopper's patch for those functions.
This closes SourceForge patch #100837 .
2000-08-24 01:06:40 +00:00
8377f5debf
Make sure Thomas Wouters has enough to do. ;-)
...
(Some of this is in-progress; this also serves as a reminded to me to
check this out once it is written.)
2000-08-24 00:50:27 +00:00
093272ea85
Charles G. Waldman <cgw@fnal.gov>:
...
Update the dis module documentation to reflect the EXTENDED_ARG opcode.
2000-08-24 00:37:50 +00:00
323fe5df6a
fix list comprehension discussion to use \keyword macro instead of simply
...
quoting keywords.
2000-08-23 17:03:34 +00:00
297bf7ceb5
update commonprefix doc to make sure user is aware it works
...
character-by-character and that that behavior may result in it returning
prefixes that are not valid paths
2000-08-23 16:58:32 +00:00
46dfa5f4ed
require list comprehensions to start with a for clause
2000-08-22 02:43:07 +00:00
9087688581
Describe the new PRINT_ITEM_TO and PRINT_NEWLINE_TO opcodes.
2000-08-21 17:19:00 +00:00
8c0a242289
PEP 214, Extended print Statement, has been accepted by the BDFL.
...
Document the extended print form. Fred, please double check the
markup!
2000-08-21 15:45:16 +00:00
120beb6b67
Strengthen the warning against using SerialCookie and SmartCookie.
...
(If they're security holes, should they be documented at all?)
Minor rewrites.
2000-08-20 23:33:50 +00:00
8bad612881
Disallow "import mod.submod as m", because the result is ambiguous. Does it
...
load mod.submod as m, or mod as m ? Both can be achieved differently, and
unambiguously. Also attempt to document this restriction (editor
appreciated!)
Note that this is an artificial check during compile, because incorporating
this in the grammar is hard, and then adjusting the compiler to do the right
thing with the right nodes is harder.
2000-08-19 20:55:02 +00:00
15446d344d
Add entry for Cookie module.
2000-08-19 16:55:31 +00:00
e5c7352201
Make it format.
...
Adjust markup for hyperlinking to the relevant RFCs.
Give it a little organization.
Minor nits.
2000-08-19 16:54:57 +00:00
1b07f2bcf6
Initial revision. Markup unchecked.
2000-08-19 14:11:41 +00:00
512bb72fb0
As pointed out by Denis S. Otkidach <den@analyt.chem.msu.ru>, xrange()
...
returns an xrange object, not a range object, despite the name of the
source file they're implemented in.
In the list of comparison operators, list != before <>, since <> is
described as obsolescent.
2000-08-18 03:12:38 +00:00
a00738259f
Adjust the way __getslice__() is marked as deprecated; this will also
...
stand out more.
2000-08-18 02:42:14 +00:00
304faf944c
Fix a markup error that caused formatting to fail.
...
Lots of minor markup adjustments as well.
2000-08-18 02:15:55 +00:00
59ecafa526
Mention the new 'import X as Y' syntax
2000-08-17 23:37:01 +00:00
0690c86a2a
Document the returns_unicode attribute
2000-08-17 23:15:21 +00:00
5215225ea1
Apply SF patch #101135 , adding 'import module as m' and 'from module import
...
name as n'. By doing some twists and turns, "as" is not a reserved word.
There is a slight change in semantics for 'from module import name' (it will
now honour the 'global' keyword) but only in cases that are explicitly
undocumented.
2000-08-17 22:55:00 +00:00
1d75a79c00
Apply SF patch #101029 : call __getitem__ with a proper slice object if there
...
is no __getslice__ available. Also does the same for C extension types.
Includes rudimentary documentation (it could use a cross reference to the
section on slice objects, I couldn't figure out how to do that) and a test
suite for all Python __hooks__ I could think of, including the new
behaviour.
2000-08-17 22:37:32 +00:00
68add2e938
Remove an item that's been done.
2000-08-17 22:32:01 +00:00
dd611b0070
A little more text, and some really minor cleanups.
2000-08-17 22:31:23 +00:00
e581bb30c4
Small cleanups, and note when zip() entered the menagerie.
2000-08-17 22:30:30 +00:00
b32aa5ecef
Revise the comments about the exceptions module to not refer to source
...
code; it is not sufficiently readable now that it in written in C, and
is less likely to be available to end users.
2000-08-17 22:29:31 +00:00
25699f99f4
Martin v. Loewis <martin@loewis.home.cs.tu-berlin.de>:
...
Document opcodes added to support extended call syntax.
2000-08-17 22:19:26 +00:00
de9fec5f99
\citetitle: Format the title, not the optional URL!
2000-08-17 04:25:59 +00:00
2d2dc9fde5
Add section on list comprehension
...
Comment out the unwritten XML section
mymalloc.h -> pymem.h
2000-08-17 00:27:06 +00:00
1aebadf0e5
Ka-Ping Yee <ping@lfw.org>:
...
Further examples of list comprehensions.
2000-08-16 21:44:03 +00:00
5772c86816
Document socket.getfqdn().
2000-08-16 14:21:42 +00:00
2337f5519a
Mention setdefault() method for dicts
2000-08-16 02:52:37 +00:00
caa658d047
Apply SF patch #101151 , by Peter S-K, which fixes smtplib's passing of the
...
'helo' and 'ehlo' message, and exports the 'make_fqdn' function. This
function should be moved to socket.py, if that module ever gets a Python
wrapper.
2000-08-15 19:30:36 +00:00
d341579178
Fix error made in applying Thomas's patch.
2000-08-15 18:44:10 +00:00
a1e214a1ed
Thomas Wouters <thomas@xs4all.net>:
...
Update the grammar to reflect the most recent changes to list
comprehensions.
2000-08-15 17:54:49 +00:00
d066f6d780
Fix markup bug that prevented formatting.
...
Adjusted some markup for consistency with the rest of the documentation
and creation of the proper index entries.
2000-08-15 17:47:09 +00:00
0be4346da6
Describe the b2a_hex() and a2b_hex() functions (a.k.a. hexlify() and
...
unhexlify() respectively).
2000-08-15 06:08:00 +00:00
4ef4be53ac
Added description of the md5.hexdigest() method.
2000-08-15 06:00:28 +00:00
34c391d743
Correct the reference count information for the parameters of
...
PyErr_Restore().
2000-08-15 04:36:16 +00:00
a2b6ad6e27
Guido pointed out that all names in the sys module have no underscore,
2000-08-15 04:24:43 +00:00
6bd8b252e0
For bug reporting, point to the SourceForge bug tracker instead of the
...
old Jitterbug interface.
2000-08-14 16:35:05 +00:00
68e2915fc7
Document the byte_order value in the sys module.
2000-08-14 15:47:30 +00:00
107b9679c4
Document the range type, as suggested by Denis S. Otkidach
...
<den@analyt.chem.msu.ru>.
2000-08-14 15:37:59 +00:00
510d08bfe4
In the section on the "Very High Level Layer", address concerns brought up
...
by Edward K. Ream <edream@users.sourceforge.net> about FILE* values and
incompatible C libraries in dynamically linked extensions. It is not clear
(to me) how realistic the issue is, but it is better documented than not.
This closes SourceForge bug #111520 .
2000-08-14 02:50:21 +00:00
81f7eb6c6b
Fix some markup errors that prevented formatting, and one that didn't.
2000-08-12 20:08:04 +00:00
803d6e5451
list comprehensions. see
...
http://sourceforge.net/patch/?func=detailpatch&patch_id=100654&group_id=5470
for details.
2000-08-12 18:09:51 +00:00
4ca744c70e
Added information for PyEval_EvalCode().
...
Fixed a couple of typos (new references are represented by "+1", not "1").
2000-08-12 03:39:47 +00:00
4de96c2fd8
Added Marc-Andre Lemburg's documentation for string methods, with some
...
massaging for markup consistency. This closes SourceForge patch #101063 .
Added Unicode strings and buffer objects to the list of sequence types.
Small markup nits elsewhere.
2000-08-12 03:36:23 +00:00
0be5aab04d
Merge UNPACK_LIST and UNPACK_TUPLE into a single UNPACK_SEQUENCE, since they
...
did the same anyway.
I'm not sure what to do with Tools/compiler/compiler/* -- that isn't part of
distutils, is it ? Should it try to be compatible with old bytecode version ?
2000-08-11 22:15:52 +00:00
a8d7341f63
PyRun_InteractiveOne(),
...
PyRun_InteractiveLoop(): Added descriptions.
PyExc_WindowsError: Added to list of standard exceptions and added note
about the right preprocessor symbol to use to protect
code that uses it.
2000-08-11 20:39:29 +00:00
46479d3740
Some minor clarifications and added some index entries.
2000-08-11 20:34:27 +00:00
3ac977e39c
O_BINARY: Documented this constant; omission noted by David Ascher.
...
access(): Corrected availability statement; error pointed out by
Tim Peters.
2000-08-11 20:19:51 +00:00
241551c16c
do_env_cfuncdesc(): Push as much of the generated HTML into one place
...
as possible for better readability. Revise a comment.
2000-08-11 20:04:19 +00:00
a8e484c8f5
getopt(): revise description of long_options parameter slightly so it will
...
be less confusing; add a paragraph separation so that comments about
the options and long_options parameters don't have references that
are easily misinterpreted.
Adjust the interactive examples to not need the string module.
Add an example showing how the module is commonly used in a script.
2000-08-11 19:55:06 +00:00
7932ed0ac4
Added material about documenting packages, so that the use of module
...
markup for packages is clear.
2000-08-11 17:37:33 +00:00
f40706375a
Include the document dependencies earlier so that documents are rebuilt
...
when they need to be.
2000-08-11 17:36:21 +00:00
4e15945fff
Markup errors: \cfuntion -> \cfunction
2000-08-11 17:09:23 +00:00
7d45d34ed7
ANY becomes void, to reflect the requirement for ANSI C.
2000-08-11 17:07:32 +00:00
10e1bf2f64
remove all occurence of math.rint() from the sources
...
(and yes, "Currintly" also counts <0.5 wink>)
2000-08-10 04:23:30 +00:00
65983372f0
More on noutrefresh.
2000-08-09 21:49:31 +00:00
1ebd3f6c4b
Tweak curses.wrapper so it initializes colors if they are available.
2000-08-09 21:11:07 +00:00
3fe9a98c95
Correct markup error.
2000-08-09 14:37:05 +00:00
fc1f9229f4
Correct version number at which the curses.ascii module was introduced.
2000-08-09 14:36:11 +00:00
ec4b2af6bb
Fix a few markup errors and lots of small consistency issues.
...
Add "See also" link to curses.wrapper module from curses module.
2000-08-09 14:34:48 +00:00
cb0fc9c2ce
fix_font(): Handle one more case for the magical first column of tables.
2000-08-09 13:45:04 +00:00
8141cf5c76
Barry's patch to document the new setdefault() method. Slightly
...
clarified the summary for default() in the table to indicate the side
effect.
2000-08-08 16:15:49 +00:00
f9d20c3786
Neil Schemenauer: GC enable(), disable(), isenabled() interface.
...
Small stylistic changes by VM:
- is_enabled() -> isenabled()
- static ... Py_<func> -> static ... gc_<func>
2000-08-06 22:45:31 +00:00
2afffd42fa
Wrote the "Describing extension modules" section.
2000-08-06 20:37:24 +00:00
1d8f57a5a4
A bundle of wording improvements, corrections, clarifications, updates,
...
and so forth.
2000-08-05 00:43:11 +00:00
b9fb1f23fe
Mention Include/my*.h cleanup
2000-08-04 12:40:35 +00:00
581f33a4cb
Added zip() builtin
2000-08-04 12:35:23 +00:00
5a007693c1
Documented curses.wrapper and curses.textpad.
2000-08-04 07:35:41 +00:00
ed13b4a5a6
Break the "Python Services" chapter into two: "Python Runtime Services"
...
(still at the start of the manual), and "Python Language Services" (late
in the manual). Moved "Restricted Execution" to just before "Python
Language Services."
2000-08-03 21:18:18 +00:00
8b9835cdb2
Added descriptions of the new parser markers for PyArg_ParseTuple().
2000-08-03 19:38:07 +00:00
cc2b81e7f3
\py@varvars: Merge the various definitions to be the simplist one that
...
does everything needed, and discard the older stuff that is not
being used.
2000-08-03 17:38:30 +00:00
8b168ba505
int() description: Fix markup to avoid image generation for math mode.
...
zip() description: Fix broken markup, three small markup consistency nits,
and one really minor usage nit. Introduce use of \moreargs instead
of hardcoding "..." with \optional.
2000-08-03 17:29:13 +00:00
3d5a04ab18
do_cmd_moreargs(),
...
do_cmd_unspecified(): New functions to reflect previously unused markup.
do_cmd_file(): Simplified generated markup to only make use of the
existing stylesheet.
do_cmd_makevar(): Make the markup more stylesheet-friendly.
2000-08-03 17:25:44 +00:00
faefa2a885
Both PEP 201 Lockstep Iteration and SF patch #101030 have been
...
accepted by the BDFL.
Added documentation for zip() builtin.
2000-08-03 15:46:17 +00:00
6c7a46a2f0
Rob Hooft <rob@hooft.net>:
...
Description of fcntl(): Added description of what can go wrong.
2000-08-02 20:53:51 +00:00
21a4764b9a
As requested by Fred - mention that in the future a winreg module may make a comeback.
2000-08-01 23:49:50 +00:00
f917bf6080
fixing a minor spelling mistake
2000-08-01 00:07:17 +00:00
fbd3b45bb7
Stop lying about [].pop() being experimental! There is no backing it out
...
at this point.
2000-07-31 23:42:23 +00:00
5a65c2d436
added count, extend, index, pop and remove to arraymodule
2000-07-31 20:52:21 +00:00
4640e13259
Change as suggested by Peter Funk <pf@artcom-gmbh.de>:
...
Move around the navigational links on the left-hand side of the navigation
bar to be more like the cursor keys.
2000-07-31 20:13:23 +00:00
3d83fc3ab1
Change as suggested by Peter Funk <pf@artcom-gmbh.de>:
...
Create a hyperlink between the language reference and documentation for
the built in functions.
2000-07-31 20:08:23 +00:00
e39dab6ce1
Organized a little bit; merged in some items from the 1.5.2p2 branch that
...
did not get handled.
2000-07-31 18:18:27 +00:00
e7aa5dc5bb
Update to indicate the appropriate version of LaTeX2HTML. Update pointer
...
for retrieving new versions.
2000-07-31 17:56:58 +00:00
85d14c9d02
Many changes to work with newer versions of LaTeX2HTML. This has been
...
tested with version 99.2beta8.
2000-07-31 17:53:45 +00:00
1915754ec9
Small changes to reflect changes in LaTeX2HTML support for newer versions
...
of LaTeX2HTML.
2000-07-31 17:47:49 +00:00
1e75e1776f
Two minor nits from Gerry Weiner (no working email address) about
...
describing the methods of dictionaries.
2000-07-31 16:34:46 +00:00
b8aa2619c7
Always pass the split level to LaTeX2HTML as a command line option since
...
newer versions only process one initialization file, and do so at a
different time than previous versions.
2000-07-31 15:55:22 +00:00
578a3f9638
Moshe Zadka <mzadka@geocities.com>:
...
Document new method in shutil (copyfileobj).
Minor clarification by Fred.
2000-07-31 15:45:46 +00:00
885082ca67
Update, 'cause Guido said it should be this way.
2000-07-31 14:31:28 +00:00
10853c9835
Finally fixed the much-reported bug about "~" in a couple of example.
...
This time, it was reported by Skip.
2000-07-28 13:51:27 +00:00
b924bd4610
Second round of curses documentation improvements. Completes and extends
...
documentation for function keys, special characters.
2000-07-27 21:10:02 +00:00
518e55c7f2
Rip out the information about the PSA, since the fate of that is not
...
certain.
Update the information about the mailing list, using the python.org
address instead of cwi.nl, and point to the pipermail archives. Also
update the daily average message count (at the risk of scaring people
off), using the mail archive at http://www.egroups.com/group/python-list
for the first half of 2000 for statistical information.
2000-07-27 20:55:12 +00:00
1962fb59f3
Document tiget{flag,num,str}
2000-07-26 02:59:13 +00:00
1cb3a9ecef
Add entries for the distutils documents to the directories table.
2000-07-25 19:27:17 +00:00
498c18f4d0
Only use one initialization file for LaTeX2HTML; more recent versions only
...
use the last one specified on the command line instead of all of them.
Smaller changes to reflect updated support.
2000-07-24 23:03:32 +00:00
e1b304db37
Fix small typos and markup consistency nits.
2000-07-24 19:35:52 +00:00
6899660a81
First round of curses documentation improvements; correct errors, flesh out
...
entry point descriptions.
2000-07-24 03:28:40 +00:00
d372521ec0
added doc for isatty()
2000-07-19 17:30:58 +00:00
7cb1524586
added documentation for new functions {get,set}_history_length
2000-07-19 16:56:26 +00:00
f9b526dbfd
More of Rob W. W. Hooft's spelling fixes. The only ones left now are the
...
distutils patches, which I'll leave to the distutils maintainers.
Tip: review the patch like this:
grep "^[\!+-] " <patchfile>
To get a quick and easy way to review the actual changes. Most of the
changes are single-line ones, anyway.
2000-07-16 19:05:38 +00:00
f8316638af
Rob W. W. Hooft's spelling fixes for the Library Reference. I hope
...
SourceForge doesn't choke on this batch :-)
I'm not entirely sure this is 100% correct. The patch changes an
\index{persistency} to \index{presistence}, and I don't know what \index{}
does. But it seems to do so persi--er, consistently, so I hope it isn't a
problem.
2000-07-16 19:01:10 +00:00
f868de6491
Document the second round of ConfigParser changes.
2000-07-14 15:00:02 +00:00
8c46b30e0a
Document PyObject_AsFileDescriptor
2000-07-13 23:58:16 +00:00
91826ed2a9
Improve the descriptions of expected exceptions for __getitem__(),
...
__setitem__(), and __delitem__(). Based on related comments from
Barry Warsaw.
2000-07-13 04:57:58 +00:00
8d2f2b2db2
From Sam Rushing's Medusa, via SF patch #100858 : add & document
...
os.seteuid(), os.setegid(), os.setreuid(), os.setregid().
2000-07-13 01:26:58 +00:00
bdcf91fda0
Documentation for the gc module. Text from Neil Schemenauer
...
<nascheme@enme.ucalgary.ca>, markup & minor revisions from Fred
Drake.
2000-07-12 04:22:53 +00:00
7ae3a5e79d
Resynchronize the TeX docs with (a) the module docstring, and (b) my recent
...
fix to the code to make it behave like the module docstring.
2000-07-12 02:56:15 +00:00
7399b9e6e4
Moshe Zadka <mzadka@geocities.com>:
...
Update the "in" / "not in" description to accomodate the current use
of the __contains__() discipline. This patch also incorporates
suggestions from Marc-Andre Lemburg <mal@lemburg.com>, minor markup
revisions from Fred Drake, and some rewording of the first affected
paragraph (also from Fred).
Closes SourceForge patch #100831 .
2000-07-11 19:43:47 +00:00
acab3d61e9
Change the table in the pyexpat.errors module to a series of datadesc
...
elements (since the table was pretty screwed up); this is how it is done
elsewhere in the manual.
I could use some help creating descriptions of the specific error
identifiers (input conditions that lead to each error, etc.).
2000-07-11 16:30:30 +00:00
417c489def
Give ConfigParser the capability to set as well as read options, and to write
...
a representation of the configuration state in .ini format that can be read
back in by a future read() call. Thus this class is now a back end
for .ini editors as well as parsers.
This patch is complete and tested, but exposes a bug in the ConfigParser
implementation which I have not yet fixed. Because case information is
discarded during parsing, the output of write() has its case smashed.
I wrote this for a SourceForge interface script called forgetool.
Documentation for the new entry points included.
2000-07-10 18:11:00 +00:00
c2844af87b
needs a space
2000-07-09 16:27:33 +00:00
08d87c6de1
Document addition of webbrowser.py
...
Mention the ANSIfication of the source.
2000-07-09 15:05:15 +00:00
a83b68a143
Remove the only Py_PROTO in the docs.
2000-07-09 03:35:10 +00:00
146b28086f
Minor revisions similar to some information in the new docstrings.
2000-07-08 16:59:03 +00:00
35e8afb76e
Rearrange order of sections
...
Fix some incorrect module names
2000-07-08 12:06:31 +00:00
5443c49fbb
Markup improvements in sections relating to interactive behavior.
...
Clarify some of the details of readline-related configuration.
2000-07-08 05:18:54 +00:00
c826ecbf8f
Add an entry for the KDE File Manager support from Peter Funk.
2000-07-07 17:08:40 +00:00
4707320566
Added new APIs and fixed some other Unicode ones (missing * or
...
extra ' ').
2000-07-07 15:48:54 +00:00
5a20b21fb1
Added docs for the new Unicode and string APIs.
2000-07-07 15:47:06 +00:00
e4dbb86ab8
New module webbrowser. Easy-to-use controller objects to make using a
...
Web browser as a help/information browser easy across platforms.
2000-07-07 03:36:12 +00:00
aa7524cf1f
Clean up markup to be more like recommended practice; only small changes
...
needed.
2000-07-06 18:37:08 +00:00
29fa30ea6b
Correct a markup nit that caused a space to be dropped from the HTML
...
version (actually a LaTeX2HTML bug), and clarified a sentence in the
mktime() description based entirely on comments from Grant Griffin
<grant.griffin@honeywell.com>.
2000-07-06 18:09:02 +00:00
e1a85f5e4a
Minor changes. Explain that for class exceptions, use excdesc but do not
...
document the constructor parameters. Need a better way, but this will do
for now.
2000-07-06 16:12:47 +00:00
8968a8292f
modified template to demonstrate subsection for examples.
2000-07-06 13:43:37 +00:00
5802e48033
Added some further description to the usage of the seealso environment.
...
Documented the \seerfc and \seeurl macros used in that environment as well.
2000-07-06 05:24:41 +00:00
3c62d9e656
Several small changes, mostly to the markup, to improve consistency and
...
internal hyperlinking. Move some things around, also for consistency
with other modules ("See also" stuff tends to live at the \section level,
before sub-sections, etc.).
2000-07-06 04:51:04 +00:00
14ea85f325
Add entry for readline documentation.
2000-07-06 04:47:25 +00:00
011028cf74
Sjoerd Mullender <sjoerd@oratrix.nl>:
...
Updates for recent changes in xmllib.
2000-07-06 04:45:14 +00:00
d14423abe2
Correct typo in description of the machine name parameter to the
...
ConnectRegistry() function; there is no trailing period!
2000-07-06 04:38:37 +00:00
63099f911f
added seealso pointing reader at readline example which uses atexit.
2000-07-06 03:26:39 +00:00
510ca1d338
simple-minded readline section doc based upon module's doc strings.
2000-07-06 03:25:26 +00:00
191a28218f
Typo: "This table table" -> "This table is"
...
Noted by Nicholas Spies <ns11@voicenet.com>.
2000-07-06 00:50:42 +00:00
0915165096
added warning about incompatibility with other codes' use of sys.exitfunc.
2000-07-05 23:11:26 +00:00
b5316188ee
Created a new chapter on structured markup processing, including the
...
existing SGML, HTML, & XML support, and providing a home for the new
XML support as it becomes documented.
2000-07-05 02:24:39 +00:00
c05cbb0527
Wrapped some long lines.
...
Cleaned up the table of error constants defined in pyexpat.errors; an
extra pair of braces had pretty much destroyed the table! (Not sure why.)
Moved the pyexpat.errors module documentation into a \section with the
proper headers for a module.
2000-07-05 02:03:34 +00:00
25e7cee1c8
get_starttag_text(): Document this method.
2000-07-03 14:32:04 +00:00
ae96aab1fe
Marc-Andre Lemburg <mal@lemburg.com>:
...
Update the API docs for the new macros Py_UNICODE_ISALPHA() and
Py_UNICODE_ISALNUM().
2000-07-03 13:38:10 +00:00
52dc76c81f
Eric S. Raymond <esr@thyrsus.com>:
...
This patch implements relative-path semantics for the "source" facility resembling
those of cpp(1), documents the change, and improves the shlex test main to
make it easier to test this feature. Along the way, it fixes a name error
in the existing docs.
[Additional documentation markup changes for consistency by FLD.]
2000-07-03 09:56:23 +00:00
353aaadd9b
Moshe Zadka <moshez@math.huji.ac.il>:
...
Substantial updates to reflect Moshe's Gordon's enhancements to the
module.
Additional changes from Fred to reflect his changes to the module as well.
2000-07-03 08:24:49 +00:00
fcc95a4d04
Tim-blessed documentation for math.frexp().
2000-07-03 06:38:17 +00:00
c3a65982a3
others --> other's (possessive)
...
Usage error noted by Grant Griffin <grant.griffin@iowegian.com>.
2000-07-01 17:47:38 +00:00
506a7a87ff
Send a "ARTICLE" --> Send an "ARTICLE"
...
Usage error noted by Grant Griffin <grant.griffin@iowegian.com>.
2000-07-01 17:43:19 +00:00
791b366f8f
Added more changes from /F
2000-07-01 15:04:18 +00:00
fed4f1e9c5
Changes from Moshe:
...
- distutils: Windows installers are already working
- string methods: .join() seems to be the concensus, so it should probably
be docommented
- filecmp.py supersedes cmp, cmpcache and dircmp
- winreg is completely new: _winreg is an adaptation of what used to be in
win32api, and winreg is a Python implementation which adds OO syntax.
Perhaps you know that, but the text is misleading.
2000-07-01 12:33:43 +00:00
d95f4e1a0d
Martin von Loewis <loewis@informatik.hu-berlin.de>:
...
Correct typo that caused a well-formedness failure.
2000-07-01 06:26:44 +00:00
b906d2ee66
Do not build the "longhtml" version for pre-release versions.
2000-07-01 02:37:37 +00:00
1cd3c14034
The new copyright / license.
2000-07-01 01:41:55 +00:00
a6161edf02
Refer to "Authors", plural
2000-07-01 00:23:02 +00:00
8357c4c9c6
Update the version number in an example
2000-07-01 00:14:43 +00:00
70ba382788
Updated the URL for Python 2.0
2000-07-01 00:13:30 +00:00
fd71b9e9d4
Change copyright notice.
2000-06-30 23:50:40 +00:00
f857ac97e9
Ignore the generated api.tex.
2000-06-30 19:25:41 +00:00
1739be50cb
Small grammatical correction from Frank Stajano. Added comment with
...
suggestion from Frank for an example and further explanation.
2000-06-30 17:58:34 +00:00
46346ec14e
Try to make sure \code always uses roman (non-italic) text.
...
Change a 1.6 version number used in a an example in a comment to 2.0.
2000-06-30 17:57:05 +00:00
30f76ffd00
Update version numbering from 1.6 to 2.0.
2000-06-30 16:06:19 +00:00
633a8d90d5
Update authors email address and corporate affiliation.
2000-06-30 15:54:18 +00:00
e06f0f9a13
Uncomment some additions from Vladimir pertinent to 2.0 but not 1.5.2.
2000-06-30 15:52:39 +00:00
aad1d4b8f2
Update the release number & date, Guido's employer.
2000-06-30 15:35:16 +00:00
f0e88980f3
Document randrange().
2000-06-30 15:32:31 +00:00
2e7cbc2cda
Fix an icon width; a "32" became a "3" somehow, and that did not look
...
as nice. ;)
2000-06-30 15:30:33 +00:00
62cdd96acb
Credit /F in a few places
...
Mention the GC module
Add MH's explanation of the Windows crash
Add atexit.py
2000-06-30 12:46:41 +00:00
57a2f7f8ef
Change description of altzone to not refer to the "0th meridian".
2000-06-30 04:24:52 +00:00
9a748aa832
Say "manual page", not "man page", when referring to the Unix manual.
2000-06-30 04:21:41 +00:00
abbc7344a4
Make sure to note that this module was added for Python 2.0!
2000-06-30 03:50:06 +00:00
6e71cdd9f1
Reflect the name change to _winreg; we still need documentation for the
...
new winreg module.
2000-06-30 03:45:40 +00:00
01df453f16
Update Python version numbers from 1.6 to 2.0 where appropriate.
...
Make some references between the distutils documents hyperlinks using
the \citetitle markup.
2000-06-30 03:36:41 +00:00
730067effc
Finished the GC section.
...
Removed all but one XXX.
Replaced 1.6 with 2.0.
Various minor corrections and additions.
2000-06-30 01:44:05 +00:00
efc43d4478
Document recently-added mouse-related functions
2000-06-30 01:05:39 +00:00
cc7371c437
Removed --l2h-config option; it introduced unnecessary complexity and
...
is not needed anywhere.
2000-06-29 23:01:40 +00:00
d04038d9d2
Update comments relating to the removal of the -X option and of string
...
exceptions in the interpreter and standard library.
2000-06-29 20:15:14 +00:00
8aa3bd9098
Make it clear that id() can return either a long integer or a plain integer.
2000-06-29 03:46:46 +00:00
0f353ed90d
Add update of httplib docs to reflect Greg Stein's recent updates.
...
Greg, this is yours!
2000-06-29 03:33:28 +00:00
ab43fcad5f
Give Moshe some work to do.
2000-06-28 22:13:06 +00:00
5c529d3f3e
Add a "See also:" link to the curses.ascii module.
2000-06-28 22:11:40 +00:00
589f44b9d0
Made the title of the Examples subsection plural!
2000-06-28 22:09:20 +00:00
be93a8332e
Added note that the atexit module was added for Python 1.6.
2000-06-28 22:07:55 +00:00
6f2a5efec9
Added entry for the curses.ascii module.
2000-06-28 22:05:44 +00:00
5ccd4b2a54
Added entries for the curses.ascii module.
2000-06-28 22:03:29 +00:00
4e716fa0ac
Skip Montanaro <skip@mojam.com>:
...
Added an example of using an HTTP POST request.
2000-06-28 21:51:43 +00:00
7388f730a3
Support constant as a font name for the first column of a table using the
...
tableii & friends markup family.
2000-06-28 21:06:08 +00:00
35c09f2e51
Revise the description of when functions retrieved from class instances
...
are and are not turned into bound methods; some confusion was noted by
Andrew Dalke.
In particular, it has to be noted that functions located on the class
instance are not turned into any sort of method, only those which are
found via the underlying class.
2000-06-28 20:15:47 +00:00
c82634c13c
Thomas Wouters <thomas@xs4all.net>:
...
Documentation updates related to the addition of openpty() and forkpty().
2000-06-28 17:27:48 +00:00
ec105d0993
Enhanced memory-reference information in the description of Py_BuildValue(),
...
based on response from Frank Stajano <fstajano@uk.research.att.com>.
2000-06-28 16:15:08 +00:00
cabbc3be5b
Added documentation for PyOS_AfterFork().
2000-06-28 15:53:13 +00:00
2b9e180ec3
Added memory-reference information to the description of Py_BuildValue(),
...
based on comments from Frank Stajano <fstajano@uk.research.att.com>.
2000-06-28 15:32:29 +00:00
c19425d520
Added the atexit module and documentation from Skip Montanaro
...
<skip@mojam.com>. Revisions to the markup to make it pass LaTeX, added
an index entry and a reference from the sys.exitfunc documentation.
This closes SourceForge patch #100620 .
2000-06-28 15:07:31 +00:00
69db0e4a0b
Added section on cycle GC
...
Various minor fixes
2000-06-28 02:16:00 +00:00
af5b76677f
Changed obsolete e-mail alias
2000-06-27 03:16:04 +00:00
f57d7b9e30
Dcoumentation for ascii.py. I've changed two references from ascii to
...
curses.ascii.
2000-06-26 23:59:24 +00:00
662d76ee7b
Fix typos and errors noticed by Skip Montanaro
2000-06-25 14:32:48 +00:00
1bbe32982d
Minor wording tweaks.
...
Kludged the extra-wide table that summarizes the manifest template language
(works with LaTeX, but is an *evil* kludge and could well break LaTeX2HTML
or similar...).
2000-06-25 03:14:13 +00:00
370248d705
Some clarifications to the 'A simple example' section.
2000-06-24 01:45:47 +00:00
19c67f83ad
Fixed a grab-bag of typos spotted by Detlef Lannert.
2000-06-24 01:33:16 +00:00
a4ca07cc8c
Minor grammatical fix
2000-06-21 01:48:46 +00:00
d24ff44f06
Document .timeout() method and .typeahead() function
2000-06-21 01:42:51 +00:00
1d15869534
Markup consistency nits.
2000-06-18 05:21:21 +00:00
0adfb45b9a
Make changes and clarifications suggested by Mark Hammond
2000-06-18 04:17:38 +00:00
b8050697b8
Documentation for the mmap module: proofreaders welcomed
2000-06-17 22:39:05 +00:00
992fe5a83e
Updates from Marc-Andre Lemburg <mal@leburg.com> for the Unicode support.
2000-06-16 21:04:15 +00:00
1c2d06acaf
Added reference count information for PySequence_List().
2000-06-16 20:00:04 +00:00
a8455abcf8
Documented PySequence_List() and PySequence_Tuple().
...
Added a bit more documentation in the chapter on building extension types,
including Py_FindMethod() documentation.
Several minor consistency nits were fixed.
2000-06-16 19:58:42 +00:00
c3fd45fe80
do_cmd_textasciitilde(): New function.
2000-06-15 22:41:48 +00:00
e57a11441e
Fix markup error that hid a tilde character; reported long ago by
...
Carl Feynman <carlf@abinitio.com>.
2000-06-15 20:07:25 +00:00
9e759dfc31
Michael Hudson <mwh21@cam.ac.uk>:
...
This patch corrects a little glitch and two outright errors.
(Including one reported earlier by Thomas Wouters.)
2000-06-15 18:44:30 +00:00
fb79ffae4d
Hook in the documentation for the unicodedata module.
2000-06-13 20:51:29 +00:00
28b294459d
Marc-Andre Lemburg <mal@lemburg.com>:
...
Documentation for the unicodedata module (massaged by Fred for minor
consistency issues).
2000-06-13 20:50:50 +00:00
6b14eebae6
Documentation for the pyexpat module.
2000-06-11 02:42:07 +00:00
c0328f014b
Mention setting the default encoding
...
Add IDLE section from MZ
2000-06-10 15:11:20 +00:00
a5bbb0089a
List more deleted modules.
...
Add request for feedback.
2000-06-10 02:41:46 +00:00
6c3cd8dd6a
Filled in the sections on new and deleted modules.
...
Bumped version number.
2000-06-10 02:24:31 +00:00
7f6270d97e
Minor fixes, additions to notes
2000-06-09 02:48:18 +00:00
d1a65ff40b
Added preliminary documentation for the winreg module,
...
by Mark Hammond <markh@activestate.com>.
Limited markup & consistency revisions by FLD.
2000-06-07 04:07:48 +00:00
b853ea0541
Latex formatting fixes
2000-06-03 03:06:58 +00:00
fa33a4e494
Patches from Moshe, w/ AMK's revisions
...
Wrote Unicode section
2000-06-03 02:52:40 +00:00
5b8311e3c1
Filled out the "Core Changes" section.
2000-05-31 03:28:42 +00:00
6c16019136
Fixed typo noted by Guido Kollerie <gkoller@cs.vu.nl> in example code.
2000-05-30 14:39:45 +00:00
3e7b133c95
Added concrete example of when separate build and install might be
...
useful (suggested by Moshe Zadka).
2000-05-30 03:00:43 +00:00
25bfd0e8d0
Article about 1.6 new features
2000-05-27 11:28:26 +00:00
b80a777859
Added documentation for gettempprefix().
...
Deprecated direct access to template.
Added note about past need to modify template so that legacy code has a
better chance of being understood, noting that the requirement to reset
template after os.fork() disappeared in 1.5.2.
2000-05-26 19:32:14 +00:00
0233075fce
Added documentation for TemporaryFile() and the siffix parameter to mktemp().
...
Removed obsolete comments about this module not creating or removing actual
files.
Removed obsolete comment about users needing to set template to None after
calling os.fork().
2000-05-26 19:05:16 +00:00
99d707af47
Piers Lauder <piers@cs.su.oz.au>:
...
I've added an extra comment about quoting arguments to
IMAP4 commands. Also changed the command descriptions
to show optional extra commands where appropriate.
Fred Drake:
Added example usage for the search() method based on comments from
<Lucas.DeJonge@awtpl.com.au>; elaborated error handling information
when arguments are missing from search() and uid().
2000-05-26 04:08:37 +00:00
6153fa19ce
Guido's rewording of my definition of "root package", with an addition by me.
2000-05-26 02:24:28 +00:00
59d382e482
A grab-bag of wording tweakage.
2000-05-26 01:04:47 +00:00
51060be2f8
Remove unused "import curses".
2000-05-24 14:33:26 +00:00
f1dc5fa2c8
Updated docs to list all the new methods and functions. The docs are
...
now complete, but probably still not very helpful or friendly.
Note: two very large tables (of key names, and of character names) were
added; these tables format terribly, and need some reworking.
2000-05-23 16:46:04 +00:00
7cb42cd070
From Greg Ward <gward@python.net>:
...
Typo: "dictionairy" --> "dictionary" (twice).
2000-05-23 02:28:26 +00:00
8c5cedee69
New description for math.frexp() -- poor description noted by
...
Francois Pinard.
2000-05-18 05:07:38 +00:00
147e5f3c65
Doc patch from Bastein Kleineidam: start to describe the 'install' command
...
family, including the new 'install_scripts' and 'install_data' commands.
2000-05-12 00:58:18 +00:00
c9a5f343bc
The addition of rint() (by Peter Schneider-Kamp; I forgot to mention
...
that before) in the previous patch has one problem; rint() is not in
the C math library on all platforms (e.g. not for VC++). Make it
conditional on HAVE_RINT.
2000-05-11 18:42:27 +00:00
71260b846e
Added math.rint() -- round according to current IEEE754 mode
2000-05-11 18:19:42 +00:00
65e69002a2
Oops, better also note that the module initialization function must be
...
extern "C" for C++.
2000-05-10 20:36:34 +00:00
2d54523551
Section "The Module's Method Table and Initialization Function":
...
Explain that the name of the initialization function must be
init<module>(). Omission noted by Daniel Kozan
<crum@dev-group.com>.
2000-05-10 20:33:18 +00:00
625d70a7a6
Fix references to the built-in compile() that don't include the
...
filename parameter. Noted by Randall Hopper <aa8vb@yahoo.com>.
2000-05-09 17:10:23 +00:00
35784dff6a
Skip Montanaro <skip@mojam.com>:
...
The intent is that this diff adds a link to the rfc822 module doc and
an index reference to this module under the rfc822 heading.
Fred, based on a suggestion from Grant Griffin <grant.griffin@honeywell.com>:
Added link to the MIME FAQ, so people can more easily get more
information about the subject of the module.
2000-05-09 16:23:23 +00:00
51313f164c
Define \seeurl in the seealso environment. Two parameters: url, why.
2000-05-09 16:18:44 +00:00
ef4d111b2a
do_cmd_seeurl(): New function.
2000-05-09 16:17:51 +00:00
d85f05940e
read() method: clarify that strings are accepted and interpreted
...
reasonably.
readfp() method: added documentation.
2000-05-09 15:06:32 +00:00
3d69c0e440
Someone found the examples of poor practice on socket addresses!
...
Spotted by Greg Kochanski <gpk@bell-labs.com>.
2000-05-03 19:40:32 +00:00
25871c001f
Brian Hooper <brian_takashi@hotmail.com>:
...
Added 'u' and 'u#' tags for PyArg_ParseTuple - these turn a
PyUnicodeObject argument into a Py_UNICODE * buffer, or a Py_UNICODE *
buffer plus a length with the '#'. Also added an analog to 'U'
for Py_BuildValue.
2000-05-03 15:17:02 +00:00
ae08853fb0
Clarify status of connection of a new instance; it *is* connected if
...
you pass server information to the constructor. Error noted by Pedro
Diaz Jimenez <diazjimenez@ctv.es>.
2000-05-03 15:11:47 +00:00
c26cc91c0c
Added descriptions of \versionadded and \versionchanged.
2000-05-02 17:43:44 +00:00
52e7684af1
do_cmd_versionchanged():
...
Added support for optional parameter explaining the change
that was made in the specified version.
2000-05-02 17:37:42 +00:00
e06d025e00
Use \versionchanged to indicate when the second parameter to utime()
...
was allowed to be None.
2000-05-02 17:29:35 +00:00
a6e8339e61
\versionchanged: Added optional parameter for explanation of change.
2000-05-02 17:28:36 +00:00
d67ddbbec1
Eric Raymond:
...
(1) Added and documented the capability for shlex to handle
lexical-level inclusion and a stack of input sources. Also, the input
stream member is now documented, and the constructor takes an optional
source-filename. The class provides facilities to generate error
messages that track file and line number.
(2) Add a convenience function to generate C-compiler style error
leaders.
2000-05-01 20:14:47 +00:00
93a8eacde5
Document the new additional signature for utime(). In addition to the
...
previous functionality utime(path, (atime, mtime)), now allowed is
utime(path, None) which sets the file's times to the current time.
2000-05-01 16:18:22 +00:00
40ee7acb95
\file and \filenq should not be used in section titles; they are not
...
sufficiently robust to survive the creation of bookmarks in the PDF
format.
2000-04-28 18:17:23 +00:00
20bab56118
Don't worry about the output dirs for the distutils manuals.
2000-04-28 17:45:27 +00:00
8187cb9664
Added distutils manuals.
...
Made the attributes more XHTML-friendly.
2000-04-28 17:43:12 +00:00
e78298a6bd
Stripped leading 'sec:' from all section labels -- generates bad filenames,
...
bad link URLs in HTML, etc.
2000-04-28 17:12:24 +00:00
e9792c4563
When building HTML releases, refer to */*.css and */*.html instead of
...
???/*.css and ???/*.html -- need to pick up the Distutils manuals!
2000-04-28 17:09:17 +00:00
3abb104356
Added the Distutils manuals.
2000-04-28 17:05:41 +00:00
0784c335f3
Added the Distutils manuals: inst and dist.
2000-04-28 17:03:26 +00:00
0862f800d0
Added 'inst' and 'dist' -- the two Distutils manuals.
2000-04-28 16:53:36 +00:00
3c3507fd4f
Documentation patch describing the 'u' and 'u#' format specifiers,
...
from Brian Hooper <brian_takashi@hotmail.com>.
2000-04-28 14:43:33 +00:00
638ae9d0bb
Support for the special macros used by the distutils documentation.
2000-04-27 21:27:49 +00:00
38c28e379c
Added a note to the section on 'exec' about the need for a trailing newline
...
in certain circumstances. (Apparently, this is a CPython problem.)
2000-04-27 18:32:02 +00:00
ac308d0a6f
Added a "See also:" section that exhibits the \seerfc markup.
2000-04-26 18:20:04 +00:00
64b72b6f4f
Define \seerfc within the seealso environment.
2000-04-26 18:13:58 +00:00
37cc0c0e9f
ref_module_index_helper(): Use "my" instead of "local".
...
get_rfc_url(): New function; returns the URL for a numbered IETF RFC.
do_cmd_rfc(): Use get_rfc_url() instead of hard-coding in the HTML
formatting.
do_cmd_seerfc(): New function.
do_env_definitions(): Small change to avoid "local".
2000-04-26 18:05:24 +00:00
c009d198db
Removed some extraneous and confusing parenthesized expressions.
...
Noted by Skip Montanaro <skip@mojam.com>.
2000-04-25 21:09:10 +00:00
4a9e72266d
Added section headers for "Extending the Distutils" section (just
...
a reminder to myself).
2000-04-25 02:57:36 +00:00
87da1ea127
Patch from Andrew Kuchling: document the new multiple pattern feature in the
...
manifest template.
2000-04-21 04:35:25 +00:00
d5767a5e43
Reformatted wide paragraphs.
2000-04-19 22:48:09 +00:00
4eaa3bfed0
Reverted '\var' in the "standard installation location" table to '\filevar'.
...
Reformatted wide paragraphs.
2000-04-19 22:44:25 +00:00
c402fa122f
Dropped '\tilde' and '\bslash' definitions.
2000-04-19 22:40:34 +00:00
4756e5fb1c
Changed '\tilde' and '\bslash' to the standard '\textasciitilde' and
...
'\textbackslash'.
2000-04-19 22:40:12 +00:00
95da443447
Removed '\package' definition.
2000-04-19 22:36:33 +00:00
1ecc251538
Changed '\package' to \module'.
2000-04-19 22:36:24 +00:00
a021acacfb
Changed '\option' to '\longprogramopt' wherever it referred to a command-line
...
option.
2000-04-19 22:34:11 +00:00
cebda6f5f0
Added documentation for WindowsError; omission noted by Michal Bozon
...
<bozon@natur.cuni.cz>.
(Mark Hammond, other Python/Windows cognoscenti: please check this!)
2000-04-17 17:42:00 +00:00
e99d1dbc74
Clarify the description of the else clause for try/except, and add an
...
explanation of why you'd want to use it.
Based on a question from Michael Simcich <msimcich@accesstools.com>.
2000-04-17 14:56:31 +00:00
46b98e35fd
Various wording/formattin tweaks.
...
Started spewing "Creating Built Distributions" section.
2000-04-14 01:53:36 +00:00
9cf7587fdc
Update change to version_info structure.
2000-04-13 17:51:58 +00:00
4d65d73686
Document hexversion (incompletely explained) and version_info (easily
...
explained).
2000-04-13 16:54:17 +00:00
502d2b4615
Added note about usual default prefix under Linux (thanks to Peter Funk
...
for the idea).
2000-04-12 14:20:15 +00:00
822a86a955
Trying to placate Fred: redefine \tilde and \bslash; document everything.
...
Still some not-quite-standard definitions in here that I have to fix.
2000-04-12 01:44:35 +00:00
d5faa7ea08
Changed the table of per-platform default installation locations to be
...
more consistent with the rest of the Python docs.
2000-04-12 01:42:19 +00:00
ee775a194c
Make use of \longprogramopt where appropriate.
2000-04-11 19:46:40 +00:00
2b85341776
Elaborate descriptions of \e, \module.
...
Describe policy on vertical lines in tables.
2000-04-11 19:08:30 +00:00
ce44498ba8
Revise the description of \programopt, document \longprogramopt.
2000-04-11 18:52:52 +00:00
493624941a
\longprogramopt: New macro.
2000-04-11 18:47:59 +00:00
0cd6021339
do_cmd_longprogramopt(): New function.
2000-04-11 18:46:59 +00:00
08c68fc82d
LaTeX macros for the Distutils manuals.
...
Perhaps these should be added to the standard Python style file?
2000-04-11 02:01:52 +00:00
c392caa390
Spewed a bunch more verbiage.
...
Lots of scattered wording changes.
2000-04-11 02:00:26 +00:00
8520cc2328
Added reference count information for Py_FindMethod().
2000-04-10 19:38:24 +00:00
7357770153
Yet another markup nit: functions that are part of the Python/C API
...
are still C functions, and should be marked.
2000-04-10 18:50:14 +00:00
37f41565a8
PyErr_Format():
...
Remove statement that the return value is always NULL; this is
generated by the formatting.
2000-04-10 18:46:22 +00:00
98605b54b4
document PyErr_Format
2000-04-10 18:40:57 +00:00
0682be4524
letters:
...
Fix description; lowercase and uppercase are strings, not
functions! Noted by Randall Hopper <aa8vb@yahoo.com>.
maketrans():
Minor markup nits in description.
2000-04-10 18:35:49 +00:00
8394595f3b
Add to the comment a description of the "null" value for returned
...
PyObject* values.
2000-04-10 18:29:21 +00:00
c2578c5bb6
load_refcounts(),
...
do_env_cfuncdesc(): Support the "null" value for the refcounts field
in refcounts.dat.
2000-04-10 18:26:45 +00:00
db2764d941
The reference count field for PyErr_NoMemory() and
...
PyErr_SetFromErrno() should be "null".
2000-04-10 18:25:09 +00:00
5e872de6c7
If the refcount field is "null", that's ok; the value will be None.
2000-04-10 18:24:26 +00:00
Andrew M. Kuchling
Thomas Wouters
Guido van Rossum
Fred Drake
Skip Montanaro
Barry Warsaw
Moshe Zadka
Peter Schneider-Kamp
Eric S. Raymond
Vladimir Marangozov
Greg Ward
Marc-André Lemburg
Mark Hammond
Greg Stein
Gregory P. Smith
Jeremy Hylton