Fred Drake
6a547c7878
Fix a link -- there is no starship.python.org!
2000-09-15 22:11:24 +00:00
Fred Drake
7c25f3df85
Add some comments on the available implementations that this module can
...
use.
Change the list of flag values for open() to a table.
Markup consistency nits.
2000-09-15 21:31:31 +00:00
Skip Montanaro
6634b14f3b
add cross reference to mimetools module
2000-09-15 18:20:20 +00:00
Fred Drake
6e5184fe6a
Update comments in the second paragraph, discussing versioning issues
...
related to the BSD DB library. Based on comments from Mark Summerfield
<summer@netcraft.com>.
2000-09-15 15:19:35 +00:00
Fred Drake
81c1735809
Add item to the list of limitations that points out the lack of support
...
for authenticated proxies. This is noted elsewhere, but this makes it
easier to find.
Fix typo where it was already mentioned.
This closes SourceForge bug #110619 .
2000-09-15 04:12:56 +00:00
Fred Drake
f3d41272c6
Before running LaTeX2HTML, remove all the HTML files from the output
...
directory. This avoids acretion of HTML from previous runs which may
have a new name; this would have avoided a lot of the packaging problems
related to changing labels from the old distutils documentation.
2000-09-14 22:25:47 +00:00
Fred Drake
aaa238585f
When there is a Module Index, make sure the icon actually links to it.
2000-09-14 22:20:41 +00:00
Fred Drake
4dfad57235
Add a reference to the sha module, noting that SHA is considered more
...
secure. Suggested by Erno Kuusela <erno@iki.fi>.
2000-09-14 21:47:32 +00:00
Fred Drake
b9fd468ded
Convert "See also" section to use \seetitle.
2000-09-14 21:46:22 +00:00
Fred Drake
33e0beaf77
Did not include the sha module documentation dependency.
2000-09-14 21:42:38 +00:00
Fred Drake
6ba0a3c30a
Denis S. Otkidach <ods@users.sourceforge.net>:
...
Minor fix in documentation of code module.
(Clarifies output destination for default implementation of the write()
method.)
2000-09-14 20:42:53 +00:00
Fred Drake
7a666b83c8
Remove reference to the stdwin-based windowed debugger, since stdwin
...
is gone.
Make a module reference into a hyperlink.
2000-09-14 20:32:17 +00:00
Fred Drake
bd2d4f1252
Use the \setshortversion macro to specify the abbreviated version number.
...
This partially addresses SourceForge bug #114318 .
Fix the release number -- this is supposed to be the *Python* release,
not the documentation release! The later is given by the combination of
the Python release number and the date. Add a comment so I can keep it
straight.
2000-09-14 20:28:26 +00:00
Fred Drake
d5d0435617
Use \shortversion in a number of places.
...
This partially addresses SourceForge bug #114318 .
2000-09-14 20:24:17 +00:00
Fred Drake
3cdb89d5ec
do_cmd_shortversion(),
...
do_cmd_setshortversion(): Implementation for new markup.
convert_args(): New helper function.
do_cmd_optional(): Modified to understand when it is called from within
a convert_args() invocation.
do_env_funcdesc(),
do_env_funcdescni(),
do_cmd_funcline(),
do_cmd_funclineni(),
handle_classlike_descriptor(),
do_env_methoddesc(),
do_end_methoddescni(),
do_cmd_methodline(),
do_cmd_methodlineni(): Modified to use helper convert_args().
The convert_args() helper and related changes fix the generation of HTML
for the \optional markup, so that bogus </var>...<var> is not generated.
This closes SourceForge bug #113800 .
2000-09-14 20:17:23 +00:00
Fred Drake
af2b71466a
\shortversion,
...
\setshortversion: New markup to help deal with Python having a "real"
version number and an abbreviated version number
used to create pathnames to the library installation.
2000-09-14 20:11:05 +00:00
Fred Drake
1fe3b82371
Avoid reference to specific versions of Python where possible.
...
This partially addresses SourceForge bug #114318 .
2000-09-14 18:25:41 +00:00
Fred Drake
933f0c38ef
Avoid reference to specific versions of Python where possible.
...
This partially addresses SourceForge bug #114318 .
2000-09-14 18:12:48 +00:00
Fred Drake
66d32b1e12
Add some index entries to make it easier to find information on
...
%-formatting of strings.
2000-09-14 17:57:42 +00:00
Barry Warsaw
ddef8887db
Include a link to Francois's po-utils.
2000-09-13 12:04:47 +00:00
Greg Ward
8c56259a3d
Fix install directories on Mac OS (now that the "install" command
...
does the right thing).
2000-09-13 00:12:37 +00:00
Greg Ward
1ed49eeb29
Changed/added a bunch of section labels so HTML files will be named nicely.
2000-09-13 00:00:58 +00:00
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