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
2c0ef4d625
Corrected citation markup in first paragraph.
1998-03-05 19:33:10 +00:00
55a7cf3ee7
Update documentation release date.
1998-03-05 17:15:26 +00:00
c113745498
For verbatim text, don't bounce down a size.
1998-03-05 17:00:55 +00:00
aa54e2db84
Move the change to ending the abstract from python.sty to manual.cls; it
...
is not appropriate for the howto document class.
1998-03-05 16:41:42 +00:00
e61d7af4db
latex-$(VERSION).tar.gz, tarlatex: Create the source distribution.
...
clean: Remove all the generatable tarballs.
1998-03-05 16:37:34 +00:00
2888bf6cb9
Build a tarball that extracts to Python-$VERSION/Doc/ instead of Doc/,
...
at Guido's suggestion.
1998-03-05 16:31:22 +00:00
3455edcbc8
Create the module index only if a conditional is true.
1998-03-04 21:56:42 +00:00
54b03b85f7
Define a new conditional, use this to control creation of module index
...
data file.
1998-03-04 21:52:33 +00:00
28f1391051
Improve separation of document class and python semantic constructs. This
...
will allow us to have a class of smaller documents as well.
1998-03-04 21:47:59 +00:00
c7e76c885b
Remove item on migration to LaTeX2e document classes. Done.
1998-03-04 17:35:00 +00:00
85551a38f3
tarballs: Ok, we do support info for the moment, so add that to the tarballs
...
target.
1998-03-04 16:51:36 +00:00
b1cd7710ef
pdf-$(VERSION).tar.gz: If ref/ref.pdf exists, include it in the tarball
...
along with the others.
html-$(VERSION).tar.gz: Change the wildcard for picking up GIFs a little
to avoid changes in what LaTeX2HTML generates.
1998-03-04 16:49:36 +00:00
71472a5f20
Update URL to get Perl. (Anyone want to re-write LaTeX2HTML in Python? ;)
...
Add comments about what to do about bugs.
1998-03-04 15:21:02 +00:00
cefcb33d4e
Oops, remove some debugging prints.
1998-03-04 06:34:21 +00:00
b98cd39e20
changeit(): Added support for \deprecated{}.
...
Chunk.__repr__(), main(): Allow Chunk objects to get the buffer, to make the
representation contain text instead of a pair of indexes. This makes debugging
a little easier.
1998-03-04 06:33:43 +00:00
34d6f5b0be
Preliminary LaTeX2HTML 98.1p1 support. Includes patch from Ross Moore to
...
get some funky quoting of ']' in \item[...] to work right without having to
do really ugly things to the documents themselves.
There are a lot of things relating to indexing that are commented out;
parts need to be examined and dealt with with respect to changes in
LaTeX2HTML internals. I'll work with Ross to see what it takes to make
this sort of stuff reasonable.
1998-03-04 05:36:59 +00:00
2da947af87
Comment out the attempt to get index-related stuff processed in the right
...
order. LaTeX2HTML just doesn't do things the same way as LaTeX, and this
wasn't the fix.
Simplify the generated HTML for \file{}.
For \samp{}, use "..." instead of `...'; many fonts make that look pretty
bad. ;-(
1998-03-04 05:30:49 +00:00
3fe985fc28
Simplify some of the escaping around ']' in \item[...] markup in light of
...
a fix to LaTeX2HTML from Ross Moore. Yeah!
1998-03-04 03:51:42 +00:00
12577abe2e
For each of the l2h??? targets, remove the sed hack that rips out a comma;
...
it no longer appears to be needed.
1998-03-03 22:39:37 +00:00
986c100735
Perish Evil Revelry and Lamentation.
1998-03-03 22:27:28 +00:00
49d9b620a1
Obsolete.
1998-03-03 22:03:08 +00:00
6659c30b67
Convert LaTeX support to create a new class of documents. HTML generation
...
now requires LaTeX2HTML 98.1p1 or newer (& and is still in progress).
This means that doing things to change the formatting of the manuals (at the
"normal user" level, like A4 paper), can happen in just one place, rather
than in each document file.
1998-03-03 22:02:19 +00:00
53525379da
Logical markup.
1998-03-03 21:56:15 +00:00
34eefe59f2
Overhaul.
1998-03-03 21:41:22 +00:00
40e72f7fbd
Fix typo.
1998-03-03 19:37:38 +00:00
4ad89bfe68
Nit for \refexmodindex{} (reference to extension module).
1998-03-03 18:52:55 +00:00
791f2ae1fe
Simplify the parameters passed to node2label.pl.
1998-03-03 18:05:13 +00:00
d7bb3032c1
Marked reference to the Python Library Reference with \emph{}.
...
Changed sample module creation of an exception to use PyErr_NewException().
Logical markup.
1998-03-03 17:52:07 +00:00
fcf275e0be
Script to create a source distribution. See comments at top.
1998-03-03 17:22:44 +00:00
f611d37647
Ignore tarballs.
1998-03-03 17:14:23 +00:00
9bdc436aaa
Added msvcrt.
1998-03-03 02:00:14 +00:00
f7cfb9a7a7
&replace_verbatim,
...
&replace_verbatim_hook: Clean up a little, avoid long lines.
1998-03-02 16:43:59 +00:00
10026de6a3
Make the title page include all the interesting information.
1998-02-27 22:13:13 +00:00
ec9200a2fe
&do_cmd_deprecated: New function.
...
Attempt to get \setindexsubitem{} handled at the right time under LaTeX2HTML
98.1; should still be fine under 97.1*.
1998-02-27 16:56:55 +00:00
05073e99ab
Update.
1998-02-27 16:21:58 +00:00
92e31944f4
Deprecate the read() and write() methods.
...
Don't refer to them from the fromfile() and tofile() methods.
1998-02-27 16:21:31 +00:00
26c73b7841
Added semi-structured support for feature deprecation.
1998-02-27 16:20:30 +00:00
f9fd4e8828
Put all the indexsubitem stuff together.
...
Support modified verbatim for both LaTeX2HTML 96.1* and 98.1.
Make table column headers bold.
1998-02-27 15:28:45 +00:00
7186783f56
Make table column headings bold.
1998-02-27 15:20:20 +00:00
8a13525274
Updates by AMK.
...
Markup corrected, logical markup.
1998-02-27 15:19:42 +00:00
4f56f2d646
When "declaring" a module using \*modindex{}, and * doesn't start with "ref",
...
set up the indexsubitem to "(in module #1 )" automatically. This reduces the
amount of markup needed in the module docs and, more importantly, makes it
o.k. to leave out in simple sections. \setindexsubitem{} can still be used
to change or reset it.
1998-02-27 14:54:06 +00:00
8fa5eb8784
Logical markup.
1998-02-27 05:23:37 +00:00
c865eb0587
Nit to prevent empty node in formatted version.
1998-02-27 05:21:36 +00:00
e65bb4e914
Reformulate how the info stuff is ignored.
1998-02-27 05:20:59 +00:00
4f4e920889
Use a Python script to create "empty" indexes. This solves Guido's
...
corrupted file problem and avoids the shell escape interpretation
portability problem. ;-( See comments at top of newind.py for an
explanation.
1998-02-27 05:18:28 +00:00
bdab730cf3
Update....
1998-02-27 02:23:15 +00:00
f39ed67fa2
Added \label{}s for logical addressing.
1998-02-26 22:01:23 +00:00
6c2176eea7
Added \label{}s for logical addressing.
1998-02-26 21:47:54 +00:00
e817930a7b
Adjusted to work with the newer version of LaTeX2HTML as well.
1998-02-26 18:49:58 +00:00
3da06a69b9
Marked references to the other manuals as \emph{} in the abstract.
...
Added \label{}s for logical addressing.
1998-02-26 18:49:12 +00:00
2474d68548
Fix up description of 'S' format; as Dave Ascher pointed out, it
...
was ungrammatical to the point of saying the opposite of what it
should say.
1998-02-26 17:07:11 +00:00
74a11e59a2
Do a little bit more work on a table-driven basis. A little cleanup.
...
Seems to work at the moment.
1998-02-26 05:52:37 +00:00
20ee206500
Add support for some of the newer commands, a little cleanup.
1998-02-26 05:49:37 +00:00
c88aa3594f
&do_cmd_bcode, &do_cmd_ecode: Removed; no longer used.
...
&do_cmd_url: Make sure the tilde gets treated right for the browsers.
&replace_verbatim: Be sure we always have a leading vertical space.
1998-02-25 17:50:07 +00:00
628f59814e
Make sure the ']' in the content of the \item[] isn't used as the ending ']'.
1998-02-25 15:48:16 +00:00
b92dce38e7
PyFile_FromFile() description: make sure the closing brace for the arguments
...
comes after the arguments are complete.
1998-02-25 15:40:22 +00:00
540e13dd1e
Derive the name of the modules .ind from the jobname.
1998-02-25 15:31:20 +00:00
888dfa90f3
Change quoting of the "echo" commands yet again.... why can't shells agree?
...
Derive the name of the modules .idx from the jobname.
1998-02-25 15:30:47 +00:00
9cf4bbd630
Make this work better with a4 paper.
...
Make the table of contents "hot" for PDF output. No additional packages are
needed.
Move code for \b@code, \e@code into the macros for the verbatim environment
directly since they're not used elsewhere.
Derive the name of the modules .idx from the jobname.
Some clean ups.
1998-02-25 15:29:43 +00:00
d10d0faaa5
Logical markup.
1998-02-24 21:43:05 +00:00
eb9b83104a
Add support for hyperref package. This builds the PDF outline, makes the ToC
...
and index "hot", etc.
Updated a comment about fncychap.
Removed unused minitoc support; I'm not going to use it. Something that makes
more sense with the Python lib ref can be done with reasonable effort, and can
wait a little while.
1998-02-23 21:37:27 +00:00
4d3b2a2717
clean: Remove *.out (hyperref's internal files for building outlines for PDF).
1998-02-23 21:34:26 +00:00
f6dabaa57d
Ignore hyperref's *.out files (used in building outlines for PDF).
1998-02-23 21:33:43 +00:00
Fred Drake
Guido van Rossum