1191692d3d
Lots of little nits.
...
Big fix: the module index for the Python Library Reference is once more in a
separate file! Yeah!
1998-04-02 22:30:57 +00:00
58b2bfd0bf
This fixes a (minor) problem discovered by AMK when you don't want any
...
special markup for the first column of a table using {tableii} or {tableiii}.
In LaTeX, this requires using "textrm" as the formatting function, and this
is needed to remove the bogus "<textrm>" that gets generated otherwise.
There should probably be a more general mapping of specified markup to useful
markup, but that doesn't appear needed at the moment.
do_env_tableii(), do_env_tableiii(): If the markup for the first column is
\textrm, make it empty.
do_cmd_lineii(), do_cmd_lineiii(): If the markup for the first column is
empty, don't add markup around the text.
1998-04-02 20:14:04 +00:00
3a18f3ba38
Hyphenate "built-in" for consistency.
1998-04-02 19:36:25 +00:00
dc40904a32
Hyphenate "built-in" for consistency.
1998-04-02 18:54:54 +00:00
da70ee1fae
Use methoddesc and memberdesc, as needed.
...
Added description of BastionClass, since it is referred to in the Bastion
description as subclassable.
1998-04-02 18:51:30 +00:00
182bd2d176
Use methoddesc instead of funcdesc to describe the only method.
1998-04-02 18:50:21 +00:00
2351c80747
\bifuncindex: Fix so entries combine correctly with those of the built-in
...
functions section.
1998-04-02 18:48:32 +00:00
0a73d4db51
Removed reference to ni module.
1998-04-02 18:46:44 +00:00
9ac80cb5bd
Removed references to ni.
1998-04-02 18:45:09 +00:00
b401637bd8
Markup nits, index entries.
1998-04-02 18:44:38 +00:00
674e0fd7a8
Be more specific about where in RFC 1421 to look, since it's not at all
...
obvious when taking a quick look.
Say "base64" instead of "base-64", since that seems to be how it's referred
to in other RFCs.
1998-04-02 16:24:29 +00:00
b789c70d05
Minor markup nits.
1998-04-02 16:19:15 +00:00
f14e2f8a04
Fix one remaining internal use of \code{} that could use the simpler form.
1998-04-02 16:09:02 +00:00
9e9c89e67c
Some nits.
...
Fixed quoting in third paragraph of the findmatch() description.
1998-04-02 15:53:07 +00:00
ac8f91ada4
Added --split for AMK; control split level of the HTML output. Use --split 1
...
to create a single HTML file.
Added --help.
1998-04-02 15:37:13 +00:00
a0dbddfcc0
Markup consistency nits.
...
Fix indentation in code sample in PyArg_ParseTuple() section.
Added one index entry.
Fix include file reference in "Shared Libraries" to print <...> instead of
the upside-down versions of ! and ?.
1998-04-02 06:50:02 +00:00
c6fa34e4d0
Markup consistency & nits.
...
Fix typo in a C code example: KeyError is spelled PyExc_KeyError in C; the
"K" is upper case!
Some index entries.
On function signatures, always use parameter names. Make return types match
what's in the header files. When the return type is a pointer, always omit
the space between te type name and the "*"; leaving it in results in
type * func(..)
and having two spaces there just looks terrible.
1998-04-02 06:47:24 +00:00
e9625e86b8
AMK's version from the latest pypcre distribution. This clarifies a
...
few things and adds docs for what happens to escapes in replacement
strings.
1998-04-02 01:32:24 +00:00
391564f10f
Small markup nits, a few grammatical fixes, and a clarification of the binary
...
mode for files under MacOS.
Updated the traffic figure for c.l.p in the "What Now?" chapter; see comments.
1998-04-01 23:11:56 +00:00
1a7af3959b
Implemented one more special markup item.
1998-04-01 22:44:56 +00:00
454a4fb018
Added some comments.
1998-04-01 22:20:14 +00:00
982d91fb51
Change $ICONSERVER to conform to the value AMK & I have discussed for this;
...
doing this here may prove to not be such a good idea, but we'll see.
1998-03-27 06:53:13 +00:00
8fe533e6a0
Use the new {methoddesc} and {memberdesc} environments as appropriate.
1998-03-27 05:27:08 +00:00
ec56109a0a
First (rough) cut at HTML index generation in Python. Not very pretty, but
...
easier to work with than the Perl code.
1998-03-27 05:25:43 +00:00
19e2ce58bf
Add support for mapping internal labels used from the index.
1998-03-27 05:24:53 +00:00
48a16bf6b5
\tableofcontents: Add support for some warning reduction in python.sty.
1998-03-27 05:24:03 +00:00
6cb71491de
Add comments about several of the environments.
...
Cleaned up some problems that caused minor warnings.
Added environments for object methods and members, with non-indexing variants.
This includes reduced use of the indexsubitem setting, allowing more robust
index generation.
Removed some unused definitions.
1998-03-27 05:22:53 +00:00
235e6b1428
Some cleanup.
...
Remove index generation from Perl; use an external script instead.
1998-03-27 05:19:43 +00:00
8821ecb9cc
Added note about weird sequencing of <PRE> & <dl> around {verbatim} sections.
1998-03-27 05:18:45 +00:00
6355bd43e5
Clarified some comments about the requirements on the TeX installation.
...
Added brief section on the howto support.
1998-03-27 05:17:21 +00:00
42b31a5536
Lots and lots and lots.....
...
Implemented some new features of python.sty for methods & members.
Fixed some bugs.
Cleaned up some perl code and made some basic regular expressions more robust.
1998-03-27 05:16:10 +00:00
f76abb51ef
Make sure both hyphens of a long-option show up in the HTML output.
1998-03-27 00:37:40 +00:00
55730316c9
Don't use the fncychap package for HOWTO documents; appendices break. Still
...
use them for manuals.
1998-03-25 15:41:23 +00:00
050be83da9
Python HOWTO template document, with lots of help from AMK.
1998-03-25 15:39:49 +00:00
f6b55106a7
Update.
1998-03-25 14:56:01 +00:00
c0b2e453ae
Change uses of \pdfinfo and \pdfcatalog to use the new syntax from the
...
latest pdftex. (Which we have here at CNRI.) This makes the PDF targets
work again.
1998-03-25 14:53:43 +00:00
f558e3188e
Make $MYDIR absolute -- bug reported by AMK.
1998-03-24 17:48:20 +00:00
2543769ca5
Use "/usr/bin/env perl" for the #! line, and change the -i option to:
...
use English;
$INPLACE_EDIT = '';
to get the inplace-editing behavior.
1998-03-19 05:17:49 +00:00
1125488b24
build_dvi(): Make sure we run latex enough times; this now matches the #
...
of times pdflatex would be run, which is correct.
1998-03-18 22:06:13 +00:00
685ef4e604
According to Tim Peters, there should be 'print' statements in one
...
particular example.
1998-03-17 14:37:48 +00:00
cce1090d49
Change "\," to just "," in function signatures. This is easier to maintain,
...
works better with LaTeX2HTML, and allows some simplification of the python.sty
macros.
1998-03-17 06:33:25 +00:00
c9a4438c16
Coding cleanups.
...
Fix some small but messy buglets.
1998-03-17 06:29:13 +00:00
13210ed55f
Get the index working at least partway again.
...
Some small cleanups.
1998-03-17 06:28:05 +00:00
bd2796e972
Update....
1998-03-17 06:24:10 +00:00
f3aa0e0627
Revert the index stuff to work better with LaTeX2HTML.
1998-03-17 06:23:13 +00:00
396a7cfb94
Reverting some the index stuff to use tools/newind.py again; this works
...
better with LaTeX2HTML.
Run pdflatex twice to generate the PDF files, even though LaTeX has already
been run a couple of times. This ensures that font metrics for the final
run match those for the first run, and seesm to get (somewhat) better
outline results.
1998-03-17 06:22:12 +00:00
a2be9881f0
Reverting some of the index stuff to work with LaTeX2HTML better.
1998-03-17 06:20:04 +00:00
af5c0fc65f
Logical markup, consistency.
1998-03-17 02:02:51 +00:00
e603cb1073
Revive newind.py. -sigh-
1998-03-16 16:15:49 +00:00
d98329cdf0
Logical markup.
...
Convert a {description} list to a {tableii} environment.
1998-03-16 06:38:42 +00:00
ae25be2e4d
{classdesc} environment: Index as "Foo (class in foolib)" instead of
...
"Foo (in module foolib)". Is now independent of indexsubitem.
1998-03-16 05:26:10 +00:00
1a855fad30
Markup nits.
...
Adjusted some index entries.
1998-03-16 05:23:50 +00:00
abdea226dc
Adjusted an index entry.
1998-03-16 05:22:08 +00:00
52405c899a
Added an index entry.
1998-03-16 05:21:08 +00:00
7bf5e0828f
Use {classdesc} consistently.
1998-03-16 05:07:04 +00:00
c9808b3af2
Logical markup.
...
Emphasized title "4Sight User's Guide".
1998-03-15 02:04:59 +00:00
5f874d618f
Markup nits.
...
Some additional index entries.
1998-03-15 01:59:57 +00:00
ebce37087d
Logical markup.
1998-03-14 22:22:14 +00:00
f90dbc9c87
Logical markup.
1998-03-14 21:53:48 +00:00
bd9ded8190
Logical markup.
...
Replace ugly {description} with a {tableii}, for the what() return values.
1998-03-14 20:09:15 +00:00
434493b207
Logical markup.
...
Replace ugly {description} with a {tableii}, for the option descriptions.
1998-03-14 19:47:23 +00:00
a891230688
Logical markup, using {classdesc} as appropriate.
1998-03-14 07:08:02 +00:00
f9e1f658ed
Logical markup.
1998-03-14 07:00:41 +00:00
2e495c93b0
Logical markup, using {classdesc} as appropriate.
1998-03-14 06:48:33 +00:00
be2b6d7f42
Logical markup.
1998-03-14 06:40:34 +00:00
ff79a21119
Logical markup.
...
Use {classdesc} environments to describe the constructors, and place them
at the top.
1998-03-14 06:30:13 +00:00
cdea8a3c60
Logical markup.
...
Wrap general Message class description in a {classdesc} instead of nothing at
all.
1998-03-14 06:17:43 +00:00
0f51fff57e
Logical markup.
1998-03-14 06:16:57 +00:00
fc16e78f3c
Bring this up to date. Some things still don't work right.
1998-03-12 21:03:26 +00:00
94fac130bb
\regexp{}: Rewritten to look like Freidl's book. Too rip-off?
...
\envvar{}: Bow to font-lock-mode a few times...!
1998-03-12 19:37:03 +00:00
3b5da76182
Logical markup.
1998-03-12 15:33:05 +00:00
2dde74c778
Logical markup.
1998-03-12 14:42:23 +00:00
51375ae07b
Use {classdesc} instead of {funcdesc} for HTMLParser.
...
Clean up index reference to SGMLParser class.
1998-03-12 14:39:09 +00:00
6ef871ce2f
Logical markup.
...
Lots of nits in both.
1998-03-12 06:52:05 +00:00
7be8fcb42a
Use \envvar{FOO} instead of \code{\$FOO}.
1998-03-12 06:47:48 +00:00
4e7e11abe5
Use \withsubitem{} for indexing extra-module functions.
1998-03-12 06:46:16 +00:00
371ecc0c1b
Use \withsubitem{} for indexing functions from other modules. This fixes
...
things in the index.
1998-03-12 06:44:58 +00:00
0ee9f727c9
\withsubitem{}: New macro. Change indexsubitem temporarily for another
...
macro. Intended usage:
\withsubitem{(in module foo)}{\ttindex{myfunc()}}
This allows indexing functions from other modules/class/whatnot
without being dependent on the exact expansions of several macros
internal to python.sty. It's also easier to read in the source!
Some new "logical" macros that seem to be useful:
\regexp{}: For regular expressions. To make it easier to keep the appearance
consistent.
\mimetype{}: Don't use \code{}!
\envvar{}: Environment variable. This does some indexing as well.
\character{}: Just a character we want to talk about in the text, but not
a Python constant.
1998-03-12 06:41:40 +00:00
6a1eefe535
Logical markup.
1998-03-12 06:04:53 +00:00
a2e9818467
Logical markup.
...
Improve some index entries.
1998-03-12 05:54:02 +00:00
c71585e069
Logical markup.
...
Markup consistency.
Removed incorrect \setindexsubitem{}.
1998-03-12 05:33:40 +00:00
4912beb9d8
Add copyright statement.
...
Add section on using A4 paper, since that's a common request.
1998-03-11 17:07:35 +00:00
664b36ff59
*Sigh*
...
Add a -q option for "quiet" operation. Nothing gets out (not even stderr,
since that's tossed to stdout for capture in the .how file). It's a good
idea to use -l to get the log in case there are problems. Maybe this should
be the default and add a --verbose option to get the stdout? There's way
too much junk output.
1998-03-11 15:41:21 +00:00
dbc879e949
Allow the user to operate the script in debugging mode (-D), which just does
...
a "set -x".
Allow keeping a transcript, using -l, in $FILE.how.
Allow keeping of all the temp files created by the process, using -k.
1998-03-11 15:33:44 +00:00
c9f2c14d49
Somewhat more direct way of locating the file, using __FILE__.
...
Leave find_my_file() around for now, even though we're not using it at the
moment.
1998-03-11 12:08:21 +00:00
bc8ad5bdeb
Replace lists of attributes for code and frame objects with a reference to the
...
Python Reference Manual.
1998-03-11 06:29:59 +00:00
fdbd51db8b
Logical markup.
1998-03-11 06:24:46 +00:00
60ba44750f
Logical markup.
1998-03-11 06:18:15 +00:00
295eaa84b0
Logical markup.
...
Changed example to use "import posixfile" instead of "from posixfile import *"
since only one symbol was used.
1998-03-11 06:11:37 +00:00
e42f595e5c
Logical markup.
...
Made references to constants in other TERMIOS module explicit in termios
description.
Removed superfluous backslash from example.
1998-03-11 06:00:23 +00:00
db9693ec97
Logical markup.
1998-03-11 05:50:42 +00:00
75aae9ad89
Logical markup.
...
Added information on the exception attributes when exceptions are classes.
1998-03-11 05:29:58 +00:00
e2e904f303
Script to format HOWTO documents. Currently only tested on the "Using
...
Kerberos from Python" HOWTO (this will change shortly, I hope).
This needs to be run from it's location in the Doc/tools directory, and
not via a symlink. I'll try and fix this in the future.
The help message needs work.
1998-03-10 23:23:05 +00:00
db34a1e2d8
Use the location of the initialization file to augment the style-specific
...
.perl file search path, rather than making assumptions about the current
directory.
1998-03-10 23:02:57 +00:00
eff1f7622a
clean_title(): Remove debugging prints.
1998-03-10 14:33:27 +00:00
ac77b79df6
clean_title(): Clean a little more carefully. Still does funny things with
...
underscores. Might this be a fundamental PDF limitation? Hm, could
still be a TeX thing.
1998-03-10 14:02:35 +00:00
45e564dd78
In the source dist., don't include:
...
- the .cvsignore files; these are only useful in the CVS tree
- ref/ref.pdf
- ref/ref.ps
After compression, these last two account for about one-half MB, and half
the tarball. They can be picked up from the appropriate format dist if
needed.
1998-03-10 14:00:55 +00:00
b30d0164bf
Logical markup.
1998-03-10 05:41:08 +00:00
4ef3329259
Logical markup.
...
Correct misuse of indexsubutem.
Describe the Queue class using {classdesc}{Queue}, not {funcdesc}{__init__}.
1998-03-10 05:32:30 +00:00
8aee0e0356
Add some more labels for logical addressing.
1998-03-10 05:21:39 +00:00
d883ca1dcb
Logical markup.
1998-03-10 05:20:33 +00:00
193338afeb
Logical markup.
...
Convert one bulleted list to a {tableii} environment; the other should
probably be converted, but I haven't decided to what.
1998-03-10 04:23:12 +00:00
2cb1074937
Use a {datadesc} environment to describe errorcode.
1998-03-10 03:53:03 +00:00
92f31f1260
Logical markup.
1998-03-10 03:38:31 +00:00
a44d74086c
Logical markup.
...
Use {funcdesc} and {excdesc} to describe the module, not just running text.
1998-03-10 03:36:00 +00:00
c4f15af7de
Logical markup. small nits.
1998-03-10 03:17:26 +00:00
520f8bd9b7
Ok, remove dependency on the obsolete tools/modindex.py.
1998-03-09 16:43:54 +00:00
97c73c83ed
Remove \newif relating to index support; no longer needed. Index control
...
is now shared and located solely in python.sty.
1998-03-09 16:40:31 +00:00
7d20ffe245
Adjust the index inclusion for the new index support.
1998-03-09 16:39:22 +00:00
568113a75b
Obsolete.
1998-03-09 16:38:32 +00:00
8bc965785e
Adjust index file resetting; just remove the files. The new index support
...
doesn't fail if the files don't exist.
Use makeindex for the module index.
1998-03-09 16:37:52 +00:00
b390daf704
Adjust the index support a bit to make it easier to deal with module index.
...
Don't generate the mod???.idx file if it wasn't requested with the new command
\makemodindex.
Change the format of mod???.idx to match that of "normal" .idx files. This
lets us use makeindex for it and not need a special script.
1998-03-09 16:35:36 +00:00
8fcad7beb1
Don't generate a \label{} here.
1998-03-09 14:48:00 +00:00
2eda4ca4df
Markup adjustments.
1998-03-08 08:13:53 +00:00
cd14a87c02
Mark the journal title.
1998-03-08 08:02:58 +00:00
23bc85a8a6
Correct spelling of emdash.
1998-03-08 07:56:48 +00:00
7ddd043191
Moved solitary "see also" paragraph into a {seealso} environment, and told
...
why the reader should see also.
1998-03-08 07:44:13 +00:00
013ad9869e
Cleaned up some remaining markup nits.
...
Andrew: In description of (?iLmsx), you say it matches the empty string and
sets the corresponding flag. Is this correct? Or does it only set the flag?
1998-03-08 07:38:27 +00:00
8fab8cf211
Logical markup.
1998-03-08 07:14:20 +00:00
b991f8d2e0
Some logical markup.
1998-03-08 07:09:19 +00:00
b55f9d3dfc
Small nits.
...
Don't run into the right margin.
1998-03-08 07:03:27 +00:00
cc444e39e5
Nits.
1998-03-08 06:47:24 +00:00
bccc64020e
Logical markup.
...
Spell emdash right.
1998-03-08 06:41:57 +00:00
0c2af2bef6
Spell emdash with three hyphens.
...
Minor nits.
1998-03-08 06:28:00 +00:00
266b4c1506
Logical markup.
...
Index entry.
1998-03-08 06:12:10 +00:00
c07ae9f4d2
Some logical markup.
...
Combine function pairs: add() and __add__() go together. This way they
share a single description and use less space.
1998-03-08 05:56:15 +00:00
0fd72ee369
Logical markup.
...
Don't prepend the module name when referring to functions or data in the same
module.
Correct the description of "modules".
1998-03-08 05:43:51 +00:00
580eb26044
Logical markup, a couple of index entries.
1998-03-08 05:41:11 +00:00
2c954fa411
Remove info targets from "world" and "tarballs".
...
This is because it's not working again; the optional arg. for \seemodule{}
is not yet supported.
1998-03-07 19:59:45 +00:00
473a90e831
Allow the user to specify the "biggest" section type from the command line;
...
default is "chapter". Use 'python toc2bkm.py -c section' to use with
Python HOWTO documents.
1998-03-07 15:34:50 +00:00
cd05ca9762
Remove unnecessary blank line in long code sample.
...
Remove a confusing article.
1998-03-07 05:32:08 +00:00
1c8d0e0579
Never, NEVER try to recover a screwed up file by carving a chunk out of an
...
RCS ,v archive! And certainly don't check it back in without testing it.
;-(
"@" becomes "@@" everywhere.
This one *is* tested!
1998-03-07 05:29:15 +00:00
6663b22198
Oops; file copy error somewhere along the way....
1998-03-06 22:33:06 +00:00
47e09c43fd
Change the date to March 6, 1998.
...
Migration to Frame 5.5.
Checking in the PDF file. (This is questionable -- but we check in the
Postscript as well. Perhaps *both* should be removed from the CVS tree,
now everything is unbundled and we're distributing PS and PDF tarballs?)
Note -- the HTML generation using webmaker is currently broken. I'll
have to look into generating HTML from Frame...
1998-03-06 21:43:09 +00:00
1e9be5dbdd
Relocating file to Doc/texinputs.
1998-03-06 21:30:41 +00:00
e4837a1671
Revised Makefile to handle the new directories correctly.
1998-03-06 21:29:34 +00:00
361ee6582a
Utility to help create outline information for PDF.
1998-03-06 21:29:00 +00:00
1546fc3e10
Relocating file to Doc/tools.
1998-03-06 21:28:28 +00:00
4074896a1e
Add reference to the copy_reg module in the See Also: section.
1998-03-06 21:27:14 +00:00
ebcb658248
Revise some of the PDF support to get at least preliminary outline support.
...
Rewrite \seemodule (again) to allow an optional argument to support modules
which include an underscore in the names. See example in comments.
1998-03-06 21:25:17 +00:00
8f9728b8da
Ignore *.bkm files.
1998-03-06 21:22:34 +00:00
dbe132c7ac
LaTeX class for Python HOWTO documents.
1998-03-06 21:21:56 +00:00
6f7398b97b
Relocating file to Doc/perl.
1998-03-06 21:20:37 +00:00
b3c9bca242
Misc. revisions to LaTeX2HTML support.
1998-03-06 21:20:08 +00:00
bc7101dff0
Relocated .latex2html-init to l2hinit.perl.
...
howto.perl is new; supports LaTeX2HTML for HOWTO documents.
1998-03-06 21:18:55 +00:00
bc772f466c
Moved & renamed to perl/l2hinit.perl
1998-03-06 21:17:50 +00:00
2023d38a58
Relocating file to Doc/tools.
1998-03-06 21:16:47 +00:00
859c797a48
Fix the URL for the regex-to-re HOWTO.
1998-03-06 15:11:30 +00:00
2135117542
Oops, I *thoughT* I had seen a better address for Andrew....
1998-03-05 20:06:31 +00:00
8b8eae3e68
Updated URL & email addresses related to the PCT.
...
Andrew, plase check to make sure these are the ones you want used and get
back to me; this stuff will be "published" in the near future.
1998-03-05 20:04:23 +00:00
Fred Drake
Guido van Rossum