Commit Graph

4308 Commits

Author SHA1 Message Date
Fred Drake c05fc7dd9d Added documentation for sys.maxunicode and sys.warnoptions.
Fixed a markup error which caused an em dash to be presented as a minus sign.
This closes SF bug #458350.
2001-09-04 18:18:36 +00:00
Tim Peters 32f453eaa4 New restriction on pow(x, y, z): If z is not None, x and y must be of
integer types, and y must be >= 0.  See discussion at
http://sf.net/tracker/index.php?func=detail&aid=457066&group_id=5470&atid=105470
2001-09-03 08:35:41 +00:00
Fred Drake b86677079d Move the long minidom example to a separate file; \verbatiminput does the
right thing with page breaks in long examples, while the verbatim
environment does not.  This causes the example to wrap to the next page
instead of overwriting the page footer and bottom margin.
2001-09-02 06:07:36 +00:00
Fred Drake 481cf2c064 Added the "Host" header to the "GET" example.
This closes SF bug #457100.
2001-09-01 02:35:23 +00:00
Andrew M. Kuchling 0e03f588f5 Add Jack Jansen's explanation of the MacOS X changes 2001-08-30 21:30:16 +00:00
Tim Peters d507dab91f SF patch #455966: Allow leading 0 in float/imag literals.
Consequences for Jython still unknown (but raised on Jython-Dev).
2001-08-30 20:51:59 +00:00
Neil Schemenauer 55cdc88c09 Update documentation for GC API. Closes SF patch #421893. 2001-08-30 15:24:17 +00:00
Fred Drake 3c0fc84b15 Update the links to the FIPS document that defines the Secure Hash
Algorithm.  This closes SF bug #454917.
2001-08-30 14:42:40 +00:00
Tim Peters 692323488b Add a new function imp.lock_held(), and use it to skip test_threaded_import
when that test is doomed to deadlock.
2001-08-30 05:16:13 +00:00
Fred Drake f9dc04341d Fix a minor markup typo. 2001-08-29 02:34:10 +00:00
Barry Warsaw da21ce3e31 On Fred's suggestion, convert sprintf() examples to use
PyString_FromFormat().  Also fixed one grammar problem, and a few
other mark-up issues.  Sample code not checked.
2001-08-29 01:41:58 +00:00
Andrew M. Kuchling 0ab31b8562 Add METH_O and METH_NOARGS change
Rewrite snprintf() item a bit
Bump version number
2001-08-29 01:16:54 +00:00
Fred Drake b5f17f2dc5 Revise comments about TeX & LaTeX for accuracy.
This closes SF bug #456222.
2001-08-28 18:09:11 +00:00
Fred Drake d800cff80d Added explanation that [...] * n generates shallow copies of [...], so
the contents will be shared by multiple references.

This closes SF bug #455694.
2001-08-28 14:56:05 +00:00
Fred Drake 5cb29a49c8 Fix a number of minor markup errors, and improve the consistency a bit. 2001-08-28 14:25:03 +00:00
Eric S. Raymond 46ccd1dae5 Plant a mention in the description of backreferences of the fact that
while \0 doesn't do what one might expect, \g<0> does.
2001-08-28 12:50:03 +00:00
Barry Warsaw 8c64a54f75 Refcount info for PyString_FromFormat() and PyString_FromFormatV().
Closes SF patch #455666.
2001-08-28 02:32:04 +00:00
Barry Warsaw c86aa57f58 Documentation for PyString_FromFormat() and PyString_FromFormatV().
Closes SF patch #455666.
2001-08-28 02:31:28 +00:00
Michael W. Hudson 53da317801 Docs for the PEP 264 changes. 2001-08-27 20:02:17 +00:00
Guido van Rossum 88e0b5bee0 SF patch #454553 by Walter Dörwald: auto-guess content-type header for
ftp urls.
2001-08-23 13:38:15 +00:00
Skip Montanaro 0f10f84028 indicate that mktime is platform-dependent. See SF bug 434143. 2001-08-22 12:44:27 +00:00
Skip Montanaro 5ff41d16a8 indicate that the years for which the calendar function will work are
platform dependent.  See SF bug 434143.
2001-08-22 12:43:38 +00:00
Fred Drake 16bb41934c New \grammartoken markup, similar to \token but allowed everywhere. 2001-08-20 21:36:38 +00:00
Fred Drake 2a274a7e41 Add another name. 2001-08-20 21:33:41 +00:00
Fred Drake cc8f44b884 Split "Extending & Embedding" into separate files, one per chapter. 2001-08-20 19:30:29 +00:00
Fred Drake 31d833d575 Added documentation for BoundedSemaphore(), contributed by Skip Montanaro.
This closes SF patch #452836.
2001-08-20 18:49:00 +00:00
Fred Drake 0e40c3d012 Document PyTuple_GET_SIZE(), removing confusing sentence from PyDict_Copy()
description.

This fixes SF bug #453111.
2001-08-20 16:48:59 +00:00
Eric S. Raymond 29bb115bae Clean up some argument profiles, enrich the docstring. 2001-08-20 13:16:30 +00:00
Tim Peters dbec7d2c16 Improve Windows time.clock() blurb; was missing return type and unit. 2001-08-19 01:38:03 +00:00
Eric S. Raymond b60f2d0977 Framework code for compilerlike scripts. 2001-08-18 09:24:38 +00:00
Barry Warsaw dbfe5e8507 Document that uu.decode() will always raise a uu.Error if out_file
isn't given, and the file in the uu header already exists.  Also add a
description of the uu.Error exception class.
2001-08-17 20:01:06 +00:00
Fred Drake 2dc07946bf Make sure that ampersand escaping is still performed on the contents of
local module tables (the lists of modules documented within a chapter,
inserted at the beginning of the chapter).  If this is not done here,
the text is not part of the resulting documents when latex2html does the
processing normally.

This fixes a little bit more of SF bug #451556.
2001-08-17 17:20:44 +00:00
Fred Drake cb19976f1a fix_font(): Instead of using a long if/elsif cluster, use a bloody
dictionary.  Added some entries to the dictionary to fix part of
    SF bug #451556.
2001-08-16 21:56:24 +00:00
Fred Drake 457c4190f9 Fix typo reported by Joonas Paalasmaa: dada-->data 2001-08-16 21:25:24 +00:00
Fred Drake 739282da83 Re-write the description of the os.spawn*() functions, and cover the
whole family instead of just two.


This closes SF bug #451630.
2001-08-16 21:21:28 +00:00
Martin v. Löwis e3eb1f2b23 Patch #427190: Implement and use METH_NOARGS and METH_O. 2001-08-16 13:15:00 +00:00
Fred Drake ce1650f3a5 A large contribution from Dave Kuhlman describing what each of the slots
in the type object is used for, for many of the more commonly used slots.
Thanks!

(But there is still a lot more to write on this topic.)
Markup and organizational changes by your friendly neighborhood
documentation czar.
2001-08-15 19:07:18 +00:00
Fred Drake 87731762f2 Dave Kuhlman has contributed a nice improvement to the "Defining New Types"
section of the Extending & Embedding manual -- thanks!
2001-08-15 19:00:29 +00:00
Andrew M. Kuchling 94a7eba9db Note addition of cleanfuture.py 2001-08-15 15:55:48 +00:00
Fred Drake ce575bac5e Fix a minor typo and mark an exception name that was missed. 2001-08-14 21:51:50 +00:00
Fred Drake c0cf726d8c Add material about the "r" and "u" prefixes for string literals; should
be reviewed for clarity.

Work around a bogosity in the HTML version of the escape sequences table
conversion.
2001-08-14 21:43:31 +00:00
Fred Drake 0cac5f697b Added some examples of table markup. 2001-08-14 21:36:19 +00:00
Fred Drake 3e2aca48bd Add information about __floordiv__() and __truediv__() methods for
implementing numeric objects in Python.
2001-08-14 20:28:08 +00:00
Fred Drake d3ba10f4b5 Clarify the prompt in an example.
This closes SF bug #450633.
2001-08-14 19:55:42 +00:00
Barry Warsaw 5ef99a0bc5 Describe the new semantics for setting and deleting a function's
__dict__ attribute.  Deleting it, or setting it to a non-dictionary
result in a TypeError.  Note that getting it the first time magically
initializes it to an empty dict so that func.__dict__ will always
appear to be a dictionary (never None).

Closes SF bug #446645.
2001-08-14 18:22:24 +00:00
Fred Drake 680cabb225 Add "exceptions" to the list of fundamental modules
created by Py_Initialize().

This closes SF bug #450621.
2001-08-14 15:32:16 +00:00
Fred Drake 280f7253e4 Insert omitted "the". 2001-08-14 11:42:13 +00:00
Fred Drake bf781a95c0 Add the smtpd module to the list of undocumented modules; Barry needs to
write the documentation for this module.
2001-08-14 11:38:35 +00:00
Fred Drake 6943a29cbf David Goodger <dgoodger@atsautomation.com>:
Documentation for difflib/ndiff refactoring: more of the ndiff functionality
has been moved to the underlying library (difflib).

This closes SF patch #445413.
2001-08-13 19:31:59 +00:00
Fred Drake 84e58ab722 For the escape() function, added a reference to the quoteattrs() function
in xml.sax.saxutils, since that is the right function to use for quoting
attribute values.
This closes SF bug #444707.

Cleaned up a variety of other minor markup errors.
2001-08-11 03:28:41 +00:00
Andrew M. Kuchling 9e9c1358e8 Add section on PEP 238 changes
Minor grammatical changes, reformattings, and an error fix from Keith Briggs
2001-08-11 03:06:50 +00:00
Fred Drake 1cf0f1751f Add a note that the quoteattr() function is useful for HTML and SGML
attributes as well.
2001-08-10 22:14:17 +00:00
Fred Drake 11ee90289c Added documentation for PyDict_Update() and PyDict_Merge(). 2001-08-10 21:31:12 +00:00
Fred Drake 1cb560a653 Do more to be compatible with Windows/CygWin. Make error messages more
informative when a child process dies with an error.

This is a variation of parts of SF patch #429611.
2001-08-10 20:17:09 +00:00
Fred Drake 9443dc31c1 Remove the use of the "cat" program. This improves portability to non-Unix
platforms.

This is part the response to SF patch #429611.
2001-08-10 20:12:09 +00:00
Fred Drake 8a7b59e7b4 Added this LaTeX style file to the package since not all LaTeX installations
have it, especially on non-Unix platforms.  (MikTeX in particular does not
have it.)

This is part of the response to SF patch #429611.
2001-08-10 19:47:41 +00:00
Fred Drake d635e3c468 Added a warning about reference cycles and memory consumption to the
section on functions which return stack frames.

This closes SF bug #449258.
2001-08-10 17:37:33 +00:00
Fred Drake 6d8d72b0cb Usage fix, problem reported by Keith Briggs. 2001-08-10 16:15:08 +00:00
Fred Drake e89659c02d Added documentation for the new rich comparison support.
This closes SF patch #428320.

Added documentation for the new floordiv() and truediv() functions.
This is part of SF bug #449093.

Re-organized the listing of functions to get better logical grouping.
2001-08-10 15:55:09 +00:00
Fred Drake 024ef6f493 Remove the bogus flags parameter from the PyFile_WriteString() signature;
it has no such parameter.

This closes SF bug #449761.
2001-08-10 14:27:38 +00:00
Martin v. Löwis 9b75dca192 Expose nl_langinfo through locale where available. 2001-08-10 13:58:50 +00:00
Martin v. Löwis 8cc965c1fb Patch #448474: Add support for tell() and seek() to gzip.GzipFile. 2001-08-09 07:21:56 +00:00
Fred Drake 0197858f62 Added documentation for PyNumber_*FloorDivide(), PyNumber_*TrueDivide(),
PyInterpreterState_*Head(), PyInterpreterState_Next(), and
PyThreadState_Next().

Wrapped some long lines, added some others.
2001-08-08 19:14:53 +00:00
Fred Drake 03590c6bdc Reference counting information for PyNumber_*FloorDivide() and
PyNumber_*TrueDivide().
2001-08-08 18:50:18 +00:00
Fred Drake e54acfd8b2 Add option to push the development docs to SF without announcing, for
when the changes are just too small.
2001-08-08 05:41:01 +00:00
Fred Drake ecab00176f More names.... 2001-08-08 05:39:52 +00:00
Fred Drake 3a5ec57456 Clean up some of the markup here -- be more consistent in the use of
semantic labels instead of presentational markup.
2001-08-08 05:39:29 +00:00
Fred Drake a7d608d1cf "Thin" version of floor division docs: add // to the list of operators
and //= to the list of other delimiter tokens.

I'll work on it again when it's not so late...
2001-08-08 05:37:21 +00:00
Andrew M. Kuchling 8c69c91be3 Document two new items
Correct error noticed by Keith Briggs
Re-indent a paragraph
2001-08-07 14:28:58 +00:00
Fred Drake 58212724f2 Add a comment on time.time() returning non-decreasing values except when
the clock is set back.

This closes SF bug #447945.
2001-08-05 15:43:04 +00:00
Martin v. Löwis c9908c4f5c Document IPv6 changes. Contributed by itojun. 2001-08-04 22:22:45 +00:00
Fred Drake 53765753c4 Lots of new text and example code on embedding Python in C, contributed
by Albert Hofkamp.  Some editing has been done for style and markup
consistency.

This also supplies an example of importing modules and calling a function
defined in the module, so this closes SF bug #440037 as well.

(The long example code was moved to a separate file so that it would
format properly.)
2001-08-04 01:58:36 +00:00
Fred Drake b3cc29b493 Note that the mimetypes.MimeTypes class was added in Python 2.2. 2001-08-04 00:48:49 +00:00
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