c794c38187
Added a comment about not using a symbolic link to access the script.
1998-08-12 17:50:07 +00:00
697c1c7325
Some minor updates.
1998-08-12 17:13:28 +00:00
eb7fe4f5a1
Massive cleanup: Use Makefiles in subdirs properly, move most of the
...
detailed build rules to the subdirs. Allow pretty much every useful target
to be built directly from the top dir (no change in output location).
1998-08-12 17:08:37 +00:00
07b12f2497
Re-written to actually perform the conversion instead of using a sub-make
...
with the parent Makefile. Will also force the auxillary files to be
created if they need to be.
1998-08-12 17:06:03 +00:00
3069c976cf
Update date & version number for release 1.5.2a1.
1998-08-12 17:02:50 +00:00
06098e45af
New Makefile; includes ../paper-letter/Makefile and sets PAPER=a4.
1998-08-12 17:01:27 +00:00
d48d62cabd
New Makefile, contains rules for building typeset versions.
1998-08-12 17:00:24 +00:00
3d865424a7
New makefile which only contains the source dependencies specific to each
...
document. The main Makefile will only contain rules and "system" dependencies.
1998-08-12 16:16:49 +00:00
370f3c9eb6
Bump RELEASE to 1.5.2a1.
1998-08-11 19:38:00 +00:00
f832f4cd34
Clean things up just a bit.
1998-08-11 19:36:35 +00:00
15c417eb77
Helper script used in creating navigation buttons.
1998-08-11 19:35:03 +00:00
9f7adc4f22
Get the <IMG> sizes right for the navigation buttons.
1998-08-11 19:33:38 +00:00
a69ada66d0
Ok, blank.pbm is free to go.
...
The rest of these are new or replaced. The buttons are now all the same
width. They have the transparency set right. They still need the attention
of a designer. But they work, and we have a real button for the Modules
Index.
1998-08-11 18:52:33 +00:00
1b9b210abf
I think this is the last of them.
1998-08-11 18:50:04 +00:00
7aac918029
Gosh, there's a lot of them....
1998-08-11 18:47:26 +00:00
704be95237
More files never used here.....
1998-08-11 18:42:30 +00:00
e528458155
Icons only needed if using the change control marks, which are bogus.
1998-08-11 18:40:03 +00:00
c83d7cac07
Remove files we never used; l2h would only use these if you use the
...
special "html" package, which we don't and won't.
1998-08-11 18:31:35 +00:00
af06a0b4ee
Use Perl's rename() function instead of system(); there's no need for two
...
additional processes for each name change!
1998-08-11 18:17:47 +00:00
211f22c1b1
Added the test package under "Frameworks".
1998-08-11 18:13:31 +00:00
ee9306b610
Template file for \documentclass{manual}.
1998-08-11 17:59:07 +00:00
0618f5e55b
Added step 0: copy this file to <somedir>/lib<module>.tex, and edit the copy.
1998-08-11 17:43:45 +00:00
bd4009493e
Updated to reflect recent changes.
1998-08-11 17:41:20 +00:00
2f343eb5cf
Moved to ../templates/module.tex.
1998-08-11 17:30:02 +00:00
1334147558
Relocating file to Doc/templates.
1998-08-11 17:25:48 +00:00
bd65706fe3
Added new files to the LIBFILES variable.
1998-08-11 15:50:35 +00:00
5bdf88a364
Removed now-documented modules from the list.
1998-08-11 15:49:09 +00:00
23f414c539
Added new sections.
1998-08-11 15:47:16 +00:00
e72e1e02fe
Documentation for the compileall module.
1998-08-11 15:46:42 +00:00
4756bb3e54
Documentation for the py_compile module.
1998-08-11 15:46:25 +00:00
64c105d3d2
Added index entries.
...
Small markup nits.
1998-08-11 15:18:45 +00:00
f6b6bbceb6
Add a comment explaining that this script is probably not useful outside the
...
standard Python documentation, since the mkhowto.sh script is. Let there be
no doubts....
1998-08-11 14:10:40 +00:00
4d46487fe8
Make sure the icons/ directory is created even if only one document is
...
converted.
1998-08-11 13:18:52 +00:00
916f7c1e7c
Better check in the date from the last magic-fix-release. ;-)
1998-08-11 13:14:08 +00:00
6aa5d482fb
Control when/where navigation bars will appear: top & bottom of each page.
...
Include an additional button to the module index in the nav. bars if we
generate a module index. Still need a button image, but the ALT text should
do for now.
1998-08-11 03:14:50 +00:00
bc74ca5203
Add a link to the Macintosh Module Reference here, too.
1998-08-10 21:48:31 +00:00
295da24eaf
New section header style.
...
Fix up a few synopses.
1998-08-10 19:42:37 +00:00
62e436955b
do_cmd_moduleauthor(),
...
do_cmd_sectionauthor(): Parallel the new macros.
1998-08-10 19:40:44 +00:00
b75c615389
\moduleauthor,
...
\sectionauthor: New macros to record attributions; no output.
1998-08-10 18:41:43 +00:00
c817e27501
New style section headers.
1998-08-10 18:40:22 +00:00
23329d41bc
Some logical markup, some nits.
1998-08-10 17:46:22 +00:00
4d10b43c26
insert_index(): Take two additional parameters: $columns and $letters. Call
...
buildindex.py appropriately.
add_idx(),
add_module_idx(): Add the appropriate parameters to the calls to
insert_index().
1998-08-07 20:51:58 +00:00
077fffa874
The letter headings must be requested explicitly with --letters.
1998-08-07 20:49:54 +00:00
aa3f9fb7d5
By default, use a two-column index.
1998-08-07 19:52:37 +00:00
7cbf462acf
Allow multi-column indexes to be produced.
1998-08-07 19:50:13 +00:00
66da9d69fc
re is standard, not built-in.
1998-08-07 18:57:18 +00:00
ed9dcc10f8
Clarify that the Python interpreter lock need *not* be held by
...
PyInterpreterState_New() and PyThreadState_New() -- but that you may
use it to serialize calls to them.
1998-08-07 18:28:03 +00:00
cdf6af1233
Document gethostbyname_ex().
1998-08-07 18:07:36 +00:00
96e11029b8
Updated list of Library Reference files.
...
Added some dependencies to some of the HTML generation targets.
1998-08-07 18:01:37 +00:00
aee5e26f4b
Add warning that mutable argument defaults are evaluated only once;
...
with examples and workaround. This keeps coming up, and I believe
that this section in the tutorial may have been (in part) the source
of the confusion. While it didn't show examples with [] for a default,
it also didn't emphasize enough why that would be a bad idea, and
while it did say that defaults are evaluated at the point of function
definition, the example was not relevant for this issue.
1998-08-07 17:45:09 +00:00
1a0b872665
At least mark the URL to the Packages essay using \url.
1998-08-07 17:40:20 +00:00
5ee808db51
Fix synopsis.
1998-08-07 17:37:15 +00:00
730d83797e
Clarify that quit() and close() render the instance useless.
1998-08-07 17:36:59 +00:00
161edc29a6
Added file transfer to example.
1998-08-07 17:30:49 +00:00
0cb76200ef
Guido's white background.
1998-08-07 16:43:29 +00:00
92a6ed9940
Minor refilling of a paragraph...
1998-08-07 16:33:51 +00:00
70da192f63
im_function --> im_func
1998-08-07 16:28:13 +00:00
60c3cafc24
In the example, make sure all the imports are done.
1998-08-07 16:03:32 +00:00
3700b6f94e
Markup nits.
1998-08-07 16:02:28 +00:00
c18a6f3bfe
Clarify xdrlib synopsis.
1998-08-07 16:01:15 +00:00
2d62395a8e
Fix typo in binascii synopsis.
1998-08-07 16:00:30 +00:00
150ee43c64
Removed obsolete chapter header.
1998-08-07 15:58:54 +00:00
f44c4851e9
New organization of internet modules into protocols/support and data
...
chapters.
1998-08-07 15:58:31 +00:00
29fe944787
New chapter headers for Internet Protocols and Internet Data chapters,
...
which replace the existing internet chapter.
1998-08-07 15:56:52 +00:00
d795c5cbd1
Fix synopsis for multifile.
1998-08-07 15:55:14 +00:00
399fea89cb
Shorten the module synopsis.
1998-08-06 21:30:32 +00:00
72d157e998
Shorten the module synopsis.
1998-08-06 21:23:17 +00:00
9940bd717c
Variant of AMK's patch to produce text versions of HOWTO documents.
...
This ensures that the text version uses latex2html's -split 1 option, without
affecting HTML produced in the same run, and also minimizes the number of
l2h runs needed if --split 1 was used for an HTML run.
1998-08-06 20:15:20 +00:00
23a163454a
Markup nit.
1998-08-06 15:33:55 +00:00
1a3c2a0ede
Markup nits.
1998-08-06 15:18:23 +00:00
56fa8a7e4b
Marked makedirs(), removedirs(), renames() as added in 1.5.2.
1998-08-06 13:45:42 +00:00
11300cc71e
build_html(): Simplify, so there's only one version of the latex2html
...
command line.
l2hoption(): Convenience function, to write out an option to the aux. init.
file only if set.
Added --iconserver option to set the $ICONSERVER variable in latex2html; this
requires the use of an auxillary init. file since this can't be initialized
using a standard latex2html command-line option. So the aux. init. file is
used for just about all the special options since it has to be written anyway
when $ICONSERVER needs to be set.
1998-08-05 04:48:18 +00:00
1ca8fdc446
Remove modified setting of $ICONSERVER; this isn't the right way to do it.
1998-08-05 04:36:09 +00:00
45f2601cf3
get_chapter_id(): Separate two aspects of string replacement to allow the
...
need for each to vary independently.
1998-08-04 22:07:18 +00:00
f54556efae
Fixed wrapping on some long lines.
1998-08-04 20:53:55 +00:00
3f7b6fcea0
Ok, we'll try this again: update the release date. ;-(
1998-08-04 17:01:18 +00:00
228e31eef9
Update the documentation release number in RELEASE.
1998-08-04 16:59:29 +00:00
5fdd119aba
Clarify the + and b mode characters for open() a bit.
1998-07-29 21:05:35 +00:00
b35631587b
Pass paper size to dvips explicitly.
1998-07-29 05:07:41 +00:00
8f7abed9d4
Update.
1998-07-29 04:45:53 +00:00
d05177fa84
tohtml(): Use a table instead of a definition list for module synopses.
1998-07-29 04:45:23 +00:00
d19b9d6c07
Fix two remaining references to all-pdf and all-ps to only use pdf and ps.
1998-07-29 03:49:44 +00:00
9f86b662d1
Update to use a separate page for front matter.
1998-07-28 21:55:19 +00:00
e574405eff
Update the HOWTO template to use a separate page for front matter, with
...
comments.
1998-07-28 21:53:34 +00:00
514cd87d40
do_cmd_maketitle(): No <hr> at the end of the "title page".
1998-07-28 21:52:57 +00:00
1e4973be73
Define stuff to allow simple HTML-only selection using TeX's \if<foo>...\fi
...
stuff. \ifhtml ...\fi for HTML only.
1998-07-28 21:52:17 +00:00
efc17bd968
Added ref/ref.tex to REFFILES.
...
Fixed up some comments.
Removed info-related targets from the really big combined targets.
1998-07-28 21:05:16 +00:00
61c7728cc9
Make sure all chapters, sections, and subsections have a \label to give them
...
semantic file names in the HTML. No more node#.html files!
1998-07-28 19:34:22 +00:00
020f8c0139
Make sure chapters, sections, and subsections all have a \label to give them
...
semantic file names in the HTML version; no more node#.html files.
Fix one section heading.
1998-07-28 19:32:59 +00:00
ee7fd697bf
Fixed the gzip synopsis.
1998-07-27 22:30:15 +00:00
a30e469fda
Added the popen2 synopsis.
1998-07-27 22:20:02 +00:00
54327c4c05
Added the calendar synopsis.
1998-07-27 22:18:24 +00:00
edf6b1f431
Added the bisect synopsis.
1998-07-27 22:16:46 +00:00
9030b0f053
Added the dumbdbm synopsis.
1998-07-27 22:12:26 +00:00
08caa964c4
Added a synopsis.
1998-07-27 22:08:49 +00:00
9643c6706f
Fix the synopsis.
...
Change one \code{} to \samp{}.
1998-07-27 22:06:12 +00:00
b44e75339a
Mark the new & changed items.
1998-07-27 21:11:42 +00:00
6481ba6251
Update the release date.
1998-07-27 21:10:54 +00:00
53af049499
do_cmd_localmoduletable(): Cause the child links table to be dropped when
...
there's a local module list.
1998-07-27 20:48:26 +00:00
897d12bb87
do_cmd_versionadded(),
...
do_cmd_versionchanged(): Support for new macros.
1998-07-27 20:33:17 +00:00
af958c7be2
\versionadded,
...
\versionchanged: New macros.
1998-07-27 20:32:33 +00:00
9ad9c9be03
Convert operator precedence table to the new style markup.
...
Added lambda to the table.
Call "**" exponentiation instead of power.
{\em ...} --> \emph{...}
1998-07-27 20:27:53 +00:00
6f5bf8d59a
Minor tidy.
1998-07-27 19:12:58 +00:00
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
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
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
2903d03e2d
tohtml(): Make module names anchors.
1998-07-24 22:13:37 +00:00
a1cce714d0
Converted some {tabular}s to use {tablei*} environments.
1998-07-24 22:12:32 +00:00
30e52653e1
{tableiv} environment: Four-column table.
...
\lineiv: Row for {tableiv}.
1998-07-24 22:11:29 +00:00
aca61a43dd
Removing all references to FrameMaker
1998-07-24 20:58:52 +00:00
6a2fe26861
checkpoint before I throw this away
1998-07-24 20:55:06 +00:00
579c8453c3
Checking in uninteresting changes (mostly window resizes :-)
...
before I remove all this cruft.
1998-07-24 20:54:00 +00:00
2babd7b151
Document getsize(), getmtime(), getatime().
1998-07-24 20:49:39 +00:00
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
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
246837d0f5
Fix markup of an \indexiii --> only two parameters were given.
1998-07-24 20:28:22 +00:00
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
5399d68c4b
Changes copied from the FrameMaker version. Not too much.
1998-07-24 18:51:11 +00:00
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
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
7c0240f112
e.g. -> e.g.,
1998-07-24 15:36:43 +00:00
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
b193c95165
Document Ellipsis (not much of a documentation snippet, but at least
...
it's mentioned.
1998-07-24 15:02:02 +00:00
1eb200d360
Added 3 missing types: ComplexType, SliceType, EllipsisType.
1998-07-24 15:01:05 +00:00
78a6ddbdd1
Move files around in a different way, so CVS picks up all the changes. ;-)
1998-07-24 14:27:22 +00:00
3f8a59f146
Reflect file renamings for the Python Library Reference.
...
Fix style dependencies for HOWTO documents.
1998-07-24 13:58:27 +00:00
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
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
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
3a0ad6089b
Changes copied from the FrameMaker version, and some new stuff
...
(complex numbers, power operator).
1998-07-23 21:57:42 +00:00
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
cf0fb8bfee
Document the 'p' format character.
...
Clean up some of the markup.
1998-07-23 21:18:25 +00:00
c457ca7ede
Fix up Barry's markup, which didn't pass the latex test. ;-)
1998-07-23 20:31:53 +00:00
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
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
27467e4b7e
Logical markup.
1998-07-23 19:47:41 +00:00
b18a93b4c8
Changes copied from the FrameMaker version (hardly anything original).
1998-07-23 19:36:00 +00:00
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
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
465a42a58e
Added targets dvi, pdf, and ps, to make all of the documents in those formats.
1998-07-23 18:10:51 +00:00
b91e934cf1
Adjusted to use the new module synopsis support macros.
1998-07-23 17:59:49 +00:00
fe7f3bc2aa
Adjusted to use the new \declaremodule \modulesynopsis \localmoduletable
...
macros.
1998-07-23 17:55:31 +00:00
dfb658c386
'name space' -> 'namespace'
1998-07-23 17:54:36 +00:00
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
2fcadb2ffb
\py@ModSynopsisFilename: New macro; gives names of the .syn file.
1998-07-23 17:36:46 +00:00
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
c31cc38106
Ignore the new ".syn" files used to handle module synopses.
1998-07-23 17:33:10 +00:00
83b2f8ad3d
Lots of changes copied from the FrameMaker version. Also documented
...
some previously undocumented features.
1998-07-23 17:12:46 +00:00
be260101cb
# Oops, correct Latex errors.
1998-07-22 21:51:41 +00:00
0af2f63056
Document how to make a POST request with urlopen().
...
Change the argument name for quote() and quote_plus() to safe (which
matches the implementation).
Add doc for the *new* function urlencode().
1998-07-22 21:34:21 +00:00
Fred Drake
Guido van Rossum
Barry Warsaw