Greg Ward
e24f05e25b
Improve Windows and Mac OS-specific instructions for running the
...
setup script. Also added a comment about how it *should* work on Mac OS.
2000-09-12 23:55:19 +00:00
Greg Ward
078fc0816d
Typo fix -- it's 'ext_modules', not 'extensions'.
2000-09-12 23:08:53 +00:00
Fred Drake
e92cdba105
Documentation is good. Let's release more.
2000-09-12 21:08:55 +00:00
Fred Drake
0b25053ca0
Make this script handle PyVarObject* functions as well as PyObject*
...
functions.
2000-09-12 20:47:29 +00:00
Fred Drake
31f5550fbe
Thomas Wouters <thomas@xs4all.net>:
...
Reference manual docs for augmented assignment.
This closes SourceForge patch #101418 .
2000-09-12 20:32:18 +00:00
Fred Drake
7740a01096
Thomas Wouters <thomas@xs4all.net>:
...
Fix up some of the PyNumber_*() documentation.
Add documentation for the InPlace API calls.
2000-09-12 20:27:05 +00:00
Fred Drake
f913e542be
Vladimir Marangozov <Vladimir.Marangozov@inrialpes.fr>:
...
Here are some changes to the C API docs. The memory examples & API have
been updated because one malloc family is gone (Py_Malloc).
You'll see other small additions to the "building new types" section
for completeness and some cleanup at the end of the memory section.
2000-09-12 20:17:17 +00:00
Fred Drake
c56817353d
Re-wrapped some wide comments.
...
Fixed Module Index generation.
2000-09-12 20:13:04 +00:00
Fred Drake
b7cf378023
Add note that the various \see* macros are only defined in the context
...
of a seealso environment.
2000-09-12 19:58:10 +00:00
Fred Drake
5dc6104729
Change the title of the link to the document index to be more specific.
2000-09-12 19:53:18 +00:00
Fred Drake
ae86d43f11
Add a reference item pointing to the Namespaces in XML recommendation.
...
Convert the existing reference items to \seetitle markup.
2000-09-12 17:53:48 +00:00
Fred Drake
48449985f4
\seetitle: New macro for building reference list content.
2000-09-12 17:52:33 +00:00
Fred Drake
1349437e4c
When referring to namespaces, always say "namespaces" instead of
...
"name spaces".
Inconsistency noted by Keith Briggs <keith.briggs@bt.com>.
2000-09-12 16:23:48 +00:00
Fred Drake
81cccb7563
Added documentation for PySequence_Fast() and PySequence_Fast_GET_ITEM().
2000-09-12 15:22:05 +00:00
Fred Drake
aafc0c4595
When formatting the API manual, use the generated api.tex rather than
...
the original, since the refcount information has been added there.
2000-09-12 15:20:54 +00:00
Skip Montanaro
b655939d69
add index entries for list comprehensions
2000-09-11 16:31:55 +00:00
Fred Drake
88fa9627b1
Some updates and fix a bunch of really small consistency nits.
2000-09-11 05:23:25 +00:00
Fred Drake
08c5d0cdcb
Add documentation for the \pep and \seepep macros.
2000-09-11 05:22:30 +00:00
Greg Ward
14deaaec12
Minor tweaks to get rid of some '\XXX' remarks.
2000-09-11 00:33:15 +00:00
Fred Drake
643d76d735
Add support for new \pep, \seepep, excclassdesc markup.
...
Update processing of module synopsis tables (found at the beginning of
most chapters of the library reference) to reflect changes in the
processing pattern of recent versions LaTeX2HMTL. Requires most
recent change to SynopsisTable.pm.
This does not fix the module index problem.
2000-09-09 06:07:37 +00:00
Fred Drake
4e607964d1
excclassdesc: New environment. For use in documenting class-based
...
exceptions which have interesting constructor signatures.
\pep, \seepep: New macros. Equivalent to \rfc and \seerfc, but
referring to the PEP series instead of the Internet RFC
series of documents.
2000-09-09 06:01:25 +00:00
Fred Drake
75c6cb909c
Add support for a filename to record the name of the node in which the
...
table will be presented. Accessor methods are used to access the
attribute.
2000-09-09 05:53:41 +00:00
Fred Drake
1b194f927d
Add a reference to the material on string methods.
2000-09-09 05:34:06 +00:00
Fred Drake
f96e0d203b
Various clarifications and minor nits fixed. Affected descriptions of
...
input(), locals(), reload(), unicode(), and zip().
2000-09-09 03:33:42 +00:00
Fred Drake
1172a85175
Really minor consistency nit.
2000-09-09 03:31:17 +00:00
Fred Drake
66571cc20c
Improve a couple of references to the language reference, making them
...
hyperlinks to relevant sections.
Clarify the conditions under which the "softspace" attribute of file-like
objects can "just work" (with relation to overriding of attribute access
in user-defined classes).
2000-09-09 03:30:34 +00:00
Fred Drake
7acb21866c
Minor clarifications in the introductory paragraph.
2000-09-09 03:28:00 +00:00
Fred Drake
e544191397
Add \modulesynopsis for inclusion in the list of modules at the beginning
...
of the chapter.
Add explanation that this is only available when the cycle detector is
enabled at build time.
2000-09-09 03:26:51 +00:00
Fred Drake
1c4efad770
Move the "See also" section to a location more consistent with other
...
module sections. Properly mark the name of the module in the content
of the reference there.
2000-09-09 03:25:11 +00:00
Fred Drake
621d2bee1c
Move description of UserString.MutableString to a location more typical
...
of the arrangement of other modules.
2000-09-09 03:23:50 +00:00
Fred Drake
1c25803647
Add a brief section on linking Python as an embedded scripting language.
...
This closes SourceForge bug #110833 .
2000-09-08 22:54:53 +00:00
Fred Drake
90f876798f
When building the HTML packages, make sure we pick up all the HTML files
...
at the top level of the tree.
2000-09-08 21:54:44 +00:00
Fred Drake
a61bfa84c9
Add a general "About" page and link to it from the index page.
...
This fixes SourceForge bug #113810 .
2000-09-08 21:53:22 +00:00
Fred Drake
6c8affe590
Remove an item that no longer needs to be done for 2.0.
2000-09-07 21:11:45 +00:00
Fred Drake
ae3a15c396
Make the HTML more XHTML-friendly.
...
Small nits in the layout of the generated markup.
2000-09-07 20:07:41 +00:00
Fred Drake
31edf4defb
Wrap some long lines.
...
Note that \file and \filenq do not work inside section titles.
2000-09-07 20:06:07 +00:00
Fred Drake
5cd0cefbd2
Remove the specific date -- back in development mode.
2000-09-07 18:56:29 +00:00
Fred Drake
d0726c3cd9
\file is not allowed in section titles -- converting to PDF fails due to
...
weird macro-expansion issues. A better solution may be available in the
future, but this will do for now.
Add an index entry. More should probably be added as well.
2000-09-07 18:55:08 +00:00
Fred Drake
88c023b863
Remove comment about -X and string exceptions. Error noted by
...
Justin D. Pettit <jpettit@raznick.com>.
2000-09-07 16:33:32 +00:00
Fred Drake
6300bd42a4
Added note about Python version this was added for.
2000-09-07 14:01:40 +00:00
Fred Drake
77a6c9ece5
Minor markup nits around use of \optional.
2000-09-07 14:00:51 +00:00
Greg Ward
b652897456
Greatly enhanced the section on creating built distributions; in
...
particular wrote up creating RPMs in detail.
Other scattered improvements.
2000-09-07 02:40:37 +00:00
Andrew M. Kuchling
4d46d38292
Add new section "What About Python 1.6?"
...
Document some things in the 2.0 NEWS files that should be mentioned here.
2000-09-06 17:58:49 +00:00
Andrew M. Kuchling
d500e44297
Removed mention of the winreg module, since it was deleted from 2.0b1
2000-09-06 12:30:25 +00:00
Fred Drake
8b2e8f846c
Added a \versionadded statement to the getfqdn() description.
2000-09-06 02:22:16 +00:00
Greg Ward
54589d4d97
General overhaul of the "Creating a Source Distribution" section --
...
better explanation of manifest files, in particular.
2000-09-06 01:37:35 +00:00
Fred Drake
239e1d5e50
Fix mkhowto so that the bookmarks for the PDF work for both "howto" and
...
"manual" class documents.
2000-09-05 21:45:11 +00:00
Fred Drake
8bdf0bf705
Fix PDF generation.
...
The \\ introduced in the \author in boilerplate.tex broke the PDF
generation because line breaks are not allowed in the "Document Info"
metadata stored in the PDF file. This changes the line break to
a ", " (comma-space) in that context.
2000-09-05 15:19:56 +00:00
Fred Drake
82de71dae8
Minor nit to make this work a little better with the PDF generation fix.
...
This does not change the HTML or PostScript output.
2000-09-05 15:11:56 +00:00
Fred Drake
8ff4cd7512
Minor markup revisions for consistency with the rest of the documentation.
2000-09-05 13:50:21 +00:00
Fred Drake
0d83f68fc9
Added entry for mmap module.
2000-09-05 13:49:30 +00:00
Fred Drake
c28425f4c6
Update license according to the LICENSE file in the source tree.
2000-09-05 04:32:26 +00:00
Fred Drake
05e4ef01a2
Set the date.
2000-09-05 03:13:38 +00:00
Greg Ward
47f99a6174
Fleshed out the section on the setup config file, setup.cfg.
...
Added a few clarifying footnotes and cross-references.
Various minor tweaks.
2000-09-04 20:07:15 +00:00
Andrew M. Kuchling
5e08a01a98
Various corrections pointed out by Detlef Lannert
2000-09-04 17:59:27 +00:00
Moshe Zadka
57a5932f13
Update documentation for PyErr_Format, because the function has changed.
...
Connected to patch 100895
2000-09-01 09:47:20 +00:00
Barry Warsaw
21fbd540ed
Document the new optional argument "rest" on the transfercmd(),
...
ntransfercmd(), and retrbinary() commands. This closes SF patch
#101187 .
2000-09-01 06:32:32 +00:00
Fred Drake
e0d9a83bea
Document PyImport_AppendInittab(), PyImport_ExtendInittab(), and
...
struct _inittab.
This closes SourceForge bug #111499 .
2000-09-01 05:30:00 +00:00
Jeremy Hylton
b709df3810
refactor __del__ exception handler into PyErr_WriteUnraisable
...
add sanity check to gc: if an exception occurs during GC, call
PyErr_WriteUnraisable and then call Py_FatalEror.
2000-09-01 02:47:25 +00:00
Fred Drake
65faf118b6
Fix markup error and minor consistency nit.
2000-08-31 19:35:56 +00:00
Jeremy Hylton
ee5adfbae6
add user-modifiable recursion_limit
...
ceval.c:
define recurion_limit (static), default value is 2500
define Py_GetRecursionLimit and Py_SetRecursionLimit
raise RuntimeError if limit is exceeded
PC/config.h:
remove plat-specific definition
sysmodule.c:
add sys.(get|set)recursionlimit
2000-08-31 19:23:01 +00:00
Fred Drake
aef0e890b5
Document the limitation that urllib does not work with proxies which
...
require authenication. This is an implementation limitation rather than
required behavior, and may be fixed in the future.
This closes SourceForge bug #111725 .
2000-08-31 17:23:35 +00:00
Greg Ward
e3cca26627
Added abstract.
2000-08-31 16:36:31 +00:00
Fred Drake
4c3f797128
UNARY_NEG is supposed to be UNARY_NEGATIVE (spotted by Charles Waldman
...
<cgw@fnal.gov>).
Fix minor problem with EXTENDED_ARG description markup..
2000-08-31 16:26:35 +00:00
Fred Drake
7e861bd1b3
Update some version information for tools based on prodding from Greg Ward.
2000-08-31 15:29:38 +00:00
Greg Ward
1365a300a1
Get rid of "sec:" prefix that slipped into a couple of \label's.
2000-08-31 14:47:05 +00:00
Sjoerd Mullender
1c8feae411
New method getnamespace.
...
Since the application never gets to see the namespace abbreviation
used in the XML document, but some applications may need to know them,
we provide this method.
2000-08-31 10:27:00 +00:00
Fred Drake
f730fc3e4e
Be a little more careful to avoid including style information in the
...
generated markup.
Don't be careless with the navigation icons! We should use the blank
icon where there is not anyplace to go for a particular position in the
navigation bar.
2000-08-31 07:19:07 +00:00
Fred Drake
3eb7c126cd
Always room to remove more formatting from the HTML!
2000-08-31 07:15:57 +00:00
Fred Drake
501b926da9
Move common parameters to mkhowto to a variable, add up-link from the
...
generated documents to the document index.
2000-08-31 07:00:17 +00:00
Fred Drake
dfa539d770
Add --up-link and --up-title parameters to allow linking the top level
...
of the generated document to an external index. These correspond to the
-up_url and -up_title parameters of LaTeX2HTML.
2000-08-31 06:58:34 +00:00
Fred Drake
3be2074758
Push some table header formatting to the style sheet; this also helps
...
separate some of the ties between l2hinit.perl and python.perl.
Revamp the "title page" construction to allow more flexibility.
2000-08-31 06:22:54 +00:00
Fred Drake
0154fea5f4
Remove obsolete scripts.
2000-08-31 06:15:30 +00:00
Fred Drake
8bc627a402
Add --l2h-init option, which can augment the standard LaTeX2HTML
...
initialization with additional Perl files. This can be given more
than once.
2000-08-31 06:14:38 +00:00
Fred Drake
b9b4c5b560
Centralize the processing logic for LaTeX documents into the mkhowto script;
...
do not use mkdvi.sh or mkhtl.sh any more.
This slows down building all versions of the documentation, but if you are
only building one format, it does not matter.
2000-08-31 06:12:35 +00:00
Fred Drake
fcab76350a
Relocate the popen2 documentation since it is now substantially more
...
portable.
2000-08-31 06:09:26 +00:00
Fred Drake
17e6343d2d
Document PyOS_CheckStack().
...
Fix a couple of really minor markup nits.
2000-08-31 05:50:40 +00:00
Fred Drake
33642acef5
Added note about documenting the SSL support in the socket module.
2000-08-31 05:08:00 +00:00
Fred Drake
eacc4fc5e6
Push a little more here to avoid style information in the generation
...
scripts as much as possible.
2000-08-30 15:02:13 +00:00
Fred Drake
4973b35991
Remove the reference to stdwin. The comment was still true, but no
...
longer meaningful to a new user, since stdwin is long gone.
2000-08-30 14:33:02 +00:00
Skip Montanaro
7b828a6a56
doc changes to parallel changes to calendar.py module
2000-08-30 14:02:25 +00:00
Andrew M. Kuchling
3cdb5761c5
Fix markup error
2000-08-30 12:55:42 +00:00
Fred Drake
d576e9df5f
Markup revisions. Nothing was actually required to be able to format it,
...
but many conventions were broken.
2000-08-30 04:19:20 +00:00
Fred Drake
47eceeaaa4
Added a couple of links to online documentation. Reasonable since this
...
file is not used in the online documentation.
2000-08-30 03:30:40 +00:00
Barry Warsaw
28b815f28a
Oops, spell MAL's name right.
2000-08-30 03:28:17 +00:00
Barry Warsaw
0691a6b8ed
Documentation for the gettext module.
2000-08-30 03:27:10 +00:00
Barry Warsaw
058365aec5
Added libgettext.tex
2000-08-30 03:26:17 +00:00
Andrew M. Kuchling
43737641c2
Removed forgotten text in list comprehensions section (taken from the Haskell
...
description of listcomps and used as inspiration)
Rearranged sections (which accounts for much of the size of the diffs)
Added section on augmented assignment
Mentioned 'print >>file'
Broke up the "Core Changes" section into subsections
2000-08-30 00:51:02 +00:00
Fred Drake
699f98c09a
Move a little more here.
2000-08-29 21:57:34 +00:00
Fred Drake
fcb8725de5
Add a --style option to allow specifying an alternate CSS style sheet for
...
HTML generation; the machinery was there but no option to set it was
defined.
Simplify some of the path-math since we can assume a recent version of
Python.
2000-08-29 18:15:05 +00:00
Fred Drake
78430b655f
Add a comment noting that the dependency information is stored in
...
Makefile.deps.
2000-08-29 16:30:21 +00:00
Fred Drake
7e1a1d0c89
These files are not part of the current plan.
2000-08-29 06:08:06 +00:00
Barry Warsaw
33f785fc1e
Document "print >> None"
2000-08-29 04:57:34 +00:00
Moshe Zadka
a1a4b5916b
Closing patch #101120 -- After everyone agreed.
2000-08-25 21:47:56 +00:00
Fred Drake
0308ff8652
Add reference to RFC 2396 in "See also" section.
...
Minor cleanups.
2000-08-25 17:29:35 +00:00
Fred Drake
dfca4dc503
Revised documentation relevant to SourceForge patch #100837
...
(simplify making HTTP POST requests).
Added documentation of URLopener.version and how it can be overridden.
2000-08-25 05:13:42 +00:00
Andrew M. Kuchling
99a3701618
Documentation for poll() interface (SF patch #100852 )
2000-08-25 01:21:28 +00:00
Thomas Wouters
12bba852a9
Rough and incomplete documentation on augmented assignment, which follows
...
shortly. Markup also needs checking.
2000-08-24 20:06:04 +00:00
Guido van Rossum
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
Fred Drake
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