Fred Drake
f7685d79e2
Fix up the synopsis table stuff so it gets things right at each chapter,
...
instead of stringing it all together.
Yay!
1998-07-25 03:31:46 +00:00
Fred Drake
b3a3ed8f72
Update @INC so we can 'require' modules in Doc/perl/.
...
Call the localmoduletable handling once the document is complete & synopses
have been collected.
1998-07-24 22:17:34 +00:00
Fred Drake
a0f4c94af6
Added module synopsis support with one (big) caveat: All the modules are
...
listed in each chapter that has a \localmoduletable. This will be fixed,
and everything else seems to be working fine.
1998-07-24 22:16:04 +00:00
Fred Drake
2903d03e2d
tohtml(): Make module names anchors.
1998-07-24 22:13:37 +00:00
Fred Drake
a1cce714d0
Converted some {tabular}s to use {tablei*} environments.
1998-07-24 22:12:32 +00:00
Fred Drake
30e52653e1
{tableiv} environment: Four-column table.
...
\lineiv: Row for {tableiv}.
1998-07-24 22:11:29 +00:00
Guido van Rossum
aca61a43dd
Removing all references to FrameMaker
1998-07-24 20:58:52 +00:00
Guido van Rossum
6a2fe26861
checkpoint before I throw this away
1998-07-24 20:55:06 +00:00
Guido van Rossum
579c8453c3
Checking in uninteresting changes (mostly window resizes :-)
...
before I remove all this cruft.
1998-07-24 20:54:00 +00:00
Guido van Rossum
2babd7b151
Document getsize(), getmtime(), getatime().
1998-07-24 20:49:39 +00:00
Guido van Rossum
2bc1f8f07e
Added getsize(), getmtime(), getatime()
1998-07-24 20:49:26 +00:00
Guido van Rossum
89a79d19b7
Document makedirs(), removedirs(), renames() -- ESR-inspired super-versions
...
of mkdir(), rmdir() and rename() that make or remove intermediate
directories as well.
1998-07-24 20:48:20 +00:00
Guido van Rossum
4def7de7c6
Add makedirs(), removedirs(), renames() -- ESR-inspired super-versions
...
of mkdir(), rmdir() and rename() that make or remove intermediate
directories as well.
1998-07-24 20:48:03 +00:00
Fred Drake
7313b03469
My first Perl object. ;-)
...
SynopsisTable objects are used to store the table of module synopses for
a single chapter it the manual.
1998-07-24 20:34:59 +00:00
Fred Drake
246837d0f5
Fix markup of an \indexiii --> only two parameters were given.
1998-07-24 20:28:22 +00:00
Guido van Rossum
2a502d8304
Use 'S' format character for the optional constructor argument, so we
...
get a decent error message when it's not a string (instead of
confusing errors when trying to use the thing).
1998-07-24 19:53:54 +00:00
Guido van Rossum
d540509682
Changes copied from the FrameMaker version. Hardly anything (but then
...
this is the shortest chapter.)
Hurray, I'm done with this!
1998-07-24 18:56:17 +00:00
Guido van Rossum
5399d68c4b
Changes copied from the FrameMaker version. Not too much.
1998-07-24 18:51:11 +00:00
Guido van Rossum
56c2013d15
Changes copied from the FrameMaker version. Also documented some
...
previously undocumented features.
Packages and the import mechanism in general are still left
undocumented.
1998-07-24 18:25:38 +00:00
Fred Drake
34116ba933
Remove all-<format> targets in favor of just <format>.
...
Fix some comments.
For lib.pdf, run tools/toc2bkm.py to get "bookmarks" in acroread.
1998-07-24 15:42:12 +00:00
Guido van Rossum
7c0240f112
e.g. -> e.g.,
1998-07-24 15:36:43 +00:00
Fred Drake
c2aa9fbad9
Remove use of the avant package; Helvetica isn't as pretty, but works for
...
acroread. The problem this solves is likely dependent on font availability,
so keeping things simple is a good solution.
1998-07-24 15:19:38 +00:00
Guido van Rossum
b193c95165
Document Ellipsis (not much of a documentation snippet, but at least
...
it's mentioned.
1998-07-24 15:02:02 +00:00
Guido van Rossum
1eb200d360
Added 3 missing types: ComplexType, SliceType, EllipsisType.
1998-07-24 15:01:05 +00:00
Fred Drake
78a6ddbdd1
Move files around in a different way, so CVS picks up all the changes. ;-)
1998-07-24 14:27:22 +00:00
Fred Drake
3f8a59f146
Reflect file renamings for the Python Library Reference.
...
Fix style dependencies for HOWTO documents.
1998-07-24 13:58:27 +00:00
Fred Drake
64e3b43583
Move files around to get the names to match the module names except for
...
case. Two modules (SocketServer, BaseHTTPServer) still don't match; those
names are just too long!
1998-07-24 13:56:11 +00:00
Fred Drake
889f53d4e0
Reduce the number of levels in the Table of Contents by one, mostly for the
...
Python Library Reference. The other manuals do not suffer.
This does not affect HOWTO documents.
1998-07-24 13:54:29 +00:00
Fred Drake
13529c41e4
Remove item about one section === one module; done.
...
Add item about howto docs that use \localmoduletable problem for howto
documents.
1998-07-24 13:02:17 +00:00
Guido van Rossum
3a0ad6089b
Changes copied from the FrameMaker version, and some new stuff
...
(complex numbers, power operator).
1998-07-23 21:57:42 +00:00
Fred Drake
5420f3321d
\textunderscore: Re-define with a width that's more appropriate for the
...
courier font used in Python code. This still isn't *good*, but
makes the width about right in most cases. (Exception: it's now
a little wide in \var words.)
1998-07-23 21:41:02 +00:00
Fred Drake
cf0fb8bfee
Document the 'p' format character.
...
Clean up some of the markup.
1998-07-23 21:18:25 +00:00
Fred Drake
c457ca7ede
Fix up Barry's markup, which didn't pass the latex test. ;-)
1998-07-23 20:31:53 +00:00
Barry Warsaw
da00c878bd
Added descriptions of EnvironmentError and OSError; updated IOError to
...
reflect its new place in the exception hierarchy; fixed typos, etc.
1998-07-23 19:57:35 +00:00
Barry Warsaw
eef2cd14c9
Updated the description of os.error to reflect the fact that it is now
...
equivalent to exceptions.OSError.
1998-07-23 19:50:09 +00:00
Fred Drake
27467e4b7e
Logical markup.
1998-07-23 19:47:41 +00:00
Guido van Rossum
b18a93b4c8
Changes copied from the FrameMaker version (hardly anything original).
1998-07-23 19:36:00 +00:00
Fred Drake
3bd9ab0ef3
Use the new module synopsis syntax, even though we don't need a synopsis table
...
for this chapter. This protects against backend changes for \declaremodule.
1998-07-23 19:33:08 +00:00
Fred Drake
8cab549c0a
use_latex(): Hack to pass .syn files though uniq, so that the last module
...
in a HOWTO document isn't listed in the synopsis table twice. This
will do until the real bug is found (low priority!).
1998-07-23 19:13:52 +00:00
Fred Drake
465a42a58e
Added targets dvi, pdf, and ps, to make all of the documents in those formats.
1998-07-23 18:10:51 +00:00
Fred Drake
b91e934cf1
Adjusted to use the new module synopsis support macros.
1998-07-23 17:59:49 +00:00
Fred Drake
fe7f3bc2aa
Adjusted to use the new \declaremodule \modulesynopsis \localmoduletable
...
macros.
1998-07-23 17:55:31 +00:00
Guido van Rossum
dfb658c386
'name space' -> 'namespace'
1998-07-23 17:54:36 +00:00
Fred Drake
a488f30627
Lots of new stuff for "module synopsis support." Public interface consists
...
of three macros, one which replaces some of the current conventions used in
the module sections:
\declaremodule: Requires two parameters: module type (standard, builtin,
extension), and the module name. An optional parameter should be
given as the basis for the module's "key" used for linking to or
referencing the section. The "key" should only be given if the
module's name contains underscores, and should be the name with the
underscore's stripped. This should be the first thing after the
\section used to introduce the module.
\modulesynopsis: Requires a single parameter: a short, one-liner
description of the module that can be used as part of the chapter
introduction. This should probably be placed just after the
\declaremodule, but may be placed anywhere in the same section.
\localmoduletable: No parameters. If a .syn file exists for the current
chapter (or for the entire document in howto docs), a synopsistable
is created with the contents loaded from the .syn file.
Some re-organization due to module synopsis support.
Some \def's changed to \newcommand's.
1998-07-23 17:50:45 +00:00
Fred Drake
2fcadb2ffb
\py@ModSynopsisFilename: New macro; gives names of the .syn file.
1998-07-23 17:36:46 +00:00
Fred Drake
1cc6d53f65
\py@ModSynopsisFilename: New macro; gives names of the "current" .syn file.
...
\chapter: Extended, ensures that a pending module synopsis is written out
and then closes the .syn file for the preceeding chapter.
1998-07-23 17:36:14 +00:00
Fred Drake
c31cc38106
Ignore the new ".syn" files used to handle module synopses.
1998-07-23 17:33:10 +00:00
Guido van Rossum
83b2f8ad3d
Lots of changes copied from the FrameMaker version. Also documented
...
some previously undocumented features.
1998-07-23 17:12:46 +00:00
Barry Warsaw
d58d7647f3
Several changes to support inclusion of filename in relevent
...
exceptions:
posix_error_with_filename(): New function which calls
PyErr_SetFromErrnoWithFilename()
The following methods have been changed to call
posix_error_with_filename():
posix_1str()
posix_strint()
posix_strintint()
posix_do_stat()
posix_mkdir()
posix_utime()
posix_readlink()
posix_open()
INITFUNC(): os.error (nee PosixError) is PyExc_OSError
1998-07-23 16:14:40 +00:00
Barry Warsaw
52ddc0e756
PyFile_FromString(): If an exception occurs, pass in the filename that
...
was used so it's reflected in the IOError. Call
PyErr_SetFromErrnoWithFilename().
1998-07-23 16:07:02 +00:00