2a37455967
It's "Lauder", not "Lauders"!
1998-04-11 13:48:26 +00:00
9d4b6c52c3
Update the module index support to use the changed field separator for the
...
input file to buildindex.py.
1998-04-11 05:21:14 +00:00
e5cf53ad89
Formatting nits.
...
An index entry.
1998-04-11 05:02:45 +00:00
eb4ed15be8
Shift index entries around a little so the HTML doesn't have weird spacing.
1998-04-11 04:52:15 +00:00
1e0f8bfea9
Add imaplib to appropriate lists.
1998-04-11 04:27:07 +00:00
36751b0ed2
Remove obsolete module soundex from list of modules.
1998-04-11 04:23:07 +00:00
c48b772a77
Remove obsolete module rand from list of modules.
...
Add fileinput to list.
1998-04-11 04:22:02 +00:00
89de314cfc
First cut at documentation for imaplib. Based on original documentation by
...
Piers Lauders.
1998-04-11 04:19:04 +00:00
756a9e87b1
do_env_memberdesc(): Fix argument parsing for {memberdesc} environments.
...
(The bug was detected by the Q/A team -- me! Please, help review the docs!)
1998-04-11 03:12:06 +00:00
007bac3b0b
Added smtplib.py (thanks, Guido!).
1998-04-09 18:54:01 +00:00
2cb824cbf9
Don't use \samp when \code is better.
...
Consistently use ' instead of ": this conforms to my unofficial stance that
constants should be presented using the repr() whenever it makes sense. This
isn't because I think repr() is the greatest thing since spam, just that it's
an easy to adopt consistency standard. (It also holds no new surprises!)
1998-04-09 18:10:35 +00:00
5cca42e0b7
do_cmd_lineii(),
...
do_cmd_lineiii(): Fix markup style conversion to HTML tags for first column.
(The endtag wasn't formed properly.)
1998-04-09 17:59:11 +00:00
6b529ae0c0
Remove @webchecker.pickle in the "clean" target.
1998-04-09 15:46:36 +00:00
45c634ecae
Work around a small (& annoying) limitation of the latex2html support for
...
\seemodule. This is far easier than figuring out the real problem, but it
works.
1998-04-09 15:44:58 +00:00
8a254b5967
Removed misleading comment about GNU software. This module and the zlib
...
library have no relationship with GNU software other than implementing some of
the same algorithms and file format. (The zlib module is more general.)
1998-04-09 15:41:44 +00:00
45084ed52a
Added note about current status of info generation.
1998-04-09 15:19:41 +00:00
253328104f
Many markup changes (to \regexp, mostly)
...
Clarified text on 8-bit cleanness, complemented sets like [^5], and {m,n}
qualifier.
1998-04-09 14:56:04 +00:00
02a8e6b600
Update release number and date.
1998-04-09 14:50:47 +00:00
20ca9171c1
Don't assume that \version expands to the 3-character major.minor number; it
...
is the full release version name ("1.5.1beta1", for instance).
Add section for previously documented obsolete modules. Includes ni, rand,
and soundex.
1998-04-09 14:32:28 +00:00
363ab1a613
Comment out the soundex section.
1998-04-09 14:23:48 +00:00
2de75ec245
Don't assume that \version expands to the 3-character major.minor number; it
...
is the full release version name ("1.5.1beta1", for instance).
1998-04-09 14:12:11 +00:00
9da38814a3
Use the correct URL to AMK's regex-to-re HOWTO!
1998-04-09 14:06:33 +00:00
54c3947fbc
Updated URL to AMK's regex-to-re HOWTO.
1998-04-09 14:03:00 +00:00
5406e7071f
Added reference to AMK's HOWTO on the topic.
1998-04-09 14:02:02 +00:00
223395c0a0
Added imaplib.
1998-04-09 13:55:06 +00:00
b8efda01e6
Update URL to the related HOWTO document.
1998-04-09 13:49:18 +00:00
bd400881dd
Add section for ni back in, but comment it out.
1998-04-09 11:04:19 +00:00
eac469ca3d
Commented out sections on obsolete & Macintosh modules.
1998-04-09 04:51:07 +00:00
f1b72ddf82
Reduced description of the obsolete method Stats.ignore().
1998-04-09 04:49:56 +00:00
058068d992
Nearly a complete re-write.
...
Basically, it now works and produces a nice-looking HTML index.
Shows some promise for extensibility, but still young. Needs useful comments.
1998-04-08 23:12:51 +00:00
166abbabf9
Remove option to strip out <tt>...</tt> from index entry text; this is now
...
left to the buildindex.py script.
Change the field separator used in the index.dat file so utilities like grep
are useful on these files; they can't typically handle NUL bytes.
Protect index entries for environment variables from being handled as
case-insensitive by buildindex.py.
1998-04-08 23:10:54 +00:00
ae2be7144d
Correct definition of CTIME.
1998-04-08 22:44:25 +00:00
3f3c25fc03
Set flag to remove <tt>...</tt> markup from the index entries; it just ends up
...
looking really bad in popular browsers, mostly due to vertical size differences
between the roman and monospaced fonts.
1998-04-08 13:46:24 +00:00
2764dd33cf
Separate sections on anydbm and dumbdbm.
...
This is the last separation; each module now gets its own section. This will
be useful in performing conversions.
1998-04-07 22:08:02 +00:00
8e729ec31a
Caught a few more spurious \setindexsubitem macros....
1998-04-07 22:06:41 +00:00
5ab5503b8a
Use {classdesc} and {memberdesc} where appropriate.
1998-04-07 22:01:33 +00:00
a3f5c32f18
Removed unnecessary \setindexsubitem.
1998-04-07 21:45:52 +00:00
1ce3604cfd
Separate UserDict and UserList documentation into separate sections.
1998-04-07 20:05:33 +00:00
df0e3fcb63
Markup nit.
1998-04-07 20:04:27 +00:00
c708605f4f
Added a reference to the discussion in Knuth's "Sorting and Searching", and
...
noted that the original algorithm produces 4-character results rather than
the 6-character results provided by this module.
1998-04-07 19:58:19 +00:00
41565f66b6
Data attributes of objects should not be indexed with trailing parentheses!
1998-04-07 19:32:40 +00:00
396b827a93
Minor markup nit.
1998-04-07 19:17:27 +00:00
82d493fb96
Fixed some index entries.
1998-04-07 19:14:17 +00:00
6b9ff7257b
Added entry for wdb.
1998-04-07 19:09:32 +00:00
810349b685
Fix the formatting of the list of fields in the disassemble() function.
1998-04-07 14:16:41 +00:00
272fb3aaa4
Added poplib.
...
Made the module lists look like the other module lists in the documentation.
1998-04-07 14:15:28 +00:00
af370ea254
Move a short paragraph outside the description of ASTType.
1998-04-05 20:23:02 +00:00
3a0351cf85
Remove all uses of \sectcode; we can now use logical markup everywhere.
1998-04-04 07:23:21 +00:00
e7957184d2
Change \sectcode to logical markup.
1998-04-04 07:17:47 +00:00
fc57619811
Remove obsolete \setindexsubitem macros.
...
Massive migration to methoddesc and memberdesc.
Logical markup as needed.
A sprinkling of index entries for flavor.
1998-04-04 07:15:02 +00:00
71c1e502f0
Moved some things around.
...
Adjusted a couple of the comments to be more informative.
Tell a little bit about what obsolete means now, and how to use obsolete
modules.
1998-04-04 07:03:19 +00:00
13beac1289
Removed obsolete \setindexsubitem macros.
1998-04-04 06:46:51 +00:00
85ea68b2a2
Added index entries.
1998-04-04 06:46:05 +00:00
81acc2e988
Remove obsolete \setindexsubitem macro.
...
Logical markup, methoddesc, etc.
1998-04-04 06:35:41 +00:00
61f45c7cb5
Remove obsolete \setindexsubitem macro,
...
Added index entries.
Markup nits.
1998-04-04 06:31:51 +00:00
b208f128b4
Added index entry.
1998-04-04 06:28:54 +00:00
82143348aa
Remove obsolete \setindexsubitem macro.
1998-04-04 06:28:14 +00:00
858f787a02
Fix index entry for HTMLParser class.
1998-04-04 06:25:27 +00:00
41788db3e2
Logical markup.
...
Index entries.
1998-04-04 06:23:02 +00:00
9b28fe285d
Logical markup.
1998-04-04 06:20:28 +00:00
e14dde2117
Fixed description of similarity between m[name] and m.getheader(name),
...
reported by Samuel L. Bayer.
Use methoddesc instead of funcdesc, etc.
1998-04-04 06:19:30 +00:00
d275de985a
Remove obsolete lines like this:
...
\setindexsubitem{(in module frobnitz)}
These are no longer needed when present before any other \setindexsubitem{}
in the module section. The indexsubitem is now set by \bimodindex and
\stmodindex.
1998-04-04 05:56:51 +00:00
4bde97f190
Add fileinput section under Misc. Services.
1998-04-04 05:50:12 +00:00
ea2f2b9409
Use new index style for makeindex.
...
Add dependency on libfileinput.tex for lib.dvi.
1998-04-04 04:21:45 +00:00
35ca0d69e1
Document fileinput.
1998-04-04 04:20:51 +00:00
a8e262b0b2
Use the new index style when running makeindex.
1998-04-04 04:20:21 +00:00
10ad52e8af
Minor cleanliness.
1998-04-04 04:19:20 +00:00
0a2eb138e7
Style specification for building *.ind from *.idx. This is needed to avoid
...
wrapping of long lines, which tools/indfix.py doesn't understand, and needs
to to handle collapsing of entries which can share a common emtry and just
be short entries themselves. We get the added benefit of nicer formatting.
1998-04-04 04:18:06 +00:00
07bcd99873
Start at updating the template a little bit. There's a lot of stuff that's
...
just not here yet.
1998-04-03 21:25:16 +00:00
47cfd03dff
Increase space between the end of a regexp and the little right floor symbol
...
used as a closing quote. At AMK's request.
1998-04-03 21:22:31 +00:00
fe03e81aa5
Removed line of obsolete markup.
1998-04-03 20:35:03 +00:00
791468f731
Some clarifications of out-of-range group indexes/names
1998-04-03 20:07:37 +00:00
61885924b1
Lots of markup consistency nits.
...
Logical markup.
1998-04-03 07:16:46 +00:00
6251c169c6
Small nits.
...
One more index entry.
Be more specific about an exception raised by range().
1998-04-03 07:15:54 +00:00
8efde2197b
Several minor markup nits.
1998-04-03 07:13:56 +00:00
9f6aec870e
"alternative" is a noun, use "alternate" for the adjective.
...
Minor nits.
1998-04-03 07:12:52 +00:00
14c198b146
Talk about some minor nits...
1998-04-03 07:11:32 +00:00
395e8e4860
Capitalize "Python" for consistency.
...
Describe UserDict and UserList individually so they aren't too hideous in
the presentation.
1998-04-03 07:10:41 +00:00
7932a6bf8c
Small markup nits.
1998-04-03 07:09:38 +00:00
d59db4f974
Small consistency nits.
1998-04-03 07:06:56 +00:00
2123774287
Capitalize "Python" for consistency.
1998-04-03 07:06:01 +00:00
e6cedb362c
New index entries.
1998-04-03 07:05:16 +00:00
3f1c4720b5
Use {methoddesc} as appropriate.
1998-04-03 07:04:45 +00:00
5dabeed4ea
Index entries.
...
Consistency nits.
1998-04-03 07:02:35 +00:00
d0a40cb4cf
Added comment crediting Sue Williams with this documentation section (the
...
ACKS file should be checked....).
1998-04-03 06:56:31 +00:00
55e3cbd115
Fix one typo.
...
Add a manpage reference.
Add an index entry.
1998-04-03 06:54:27 +00:00
74810d5abb
Nits.
...
Add {excdesc} for zlib.error.
Use {methoddesc} where appropriate.
1998-04-03 06:49:26 +00:00
c3486318e0
Add index entry for GzipFile class.
1998-04-03 06:48:16 +00:00
d678cb7a6c
Logical markup.
1998-04-03 06:35:54 +00:00
9fee071ab6
Markup consistency.
1998-04-03 06:21:23 +00:00
5bfe4850cf
Consistency: Don't use module name when referring to functions defined
...
in the same module.
1998-04-03 06:14:54 +00:00
2cfc835b7b
Minor nits.
...
Lots of index entries.
1998-04-03 06:12:21 +00:00
4e6688747c
Consistency nits:
...
Use math-mode pi instead of mixing forms.
Use spaces around relational operators.
1998-04-03 06:04:12 +00:00
76547c5631
Minor nits.
...
Moved IGNORECASE & friends to "top level" definitions following compile(),
since there is no other case of nesting in the manual.
Use {memberdesc} and {methoddesc} as appropriate.
1998-04-03 05:59:05 +00:00
dff21a6b93
Minor nits.
...
Indent code sample to use 4-space indents.
1998-04-03 05:42:10 +00:00
16a19c46a9
Mention the --help option to tools/mkhowto.sh.
1998-04-03 05:41:38 +00:00
5bd7fccef9
Minor nits.
...
Index entry.
1998-04-03 05:31:45 +00:00
a594bafde7
Normalized case rules in section headings.
...
Moved stuff from "Recent Additions to 1.1" to "More on Defining Functions".
This means there's now a short section on "Defining Functions" immediately
followed by a long section "More on Defining Functions."
1998-04-03 05:16:31 +00:00
7e9d3148d1
Capitalize "Python" for consistency.
1998-04-03 05:02:28 +00:00
6a79be8db8
Capitalize "Python" for consistency.
...
Add an index entry.
1998-04-03 03:47:03 +00:00
930f134fc9
Logical markup.
1998-04-03 03:44:56 +00:00
dd1f52b0c4
Use {seealso} environment to refer to the struct module.
...
Document ArrayType.
Use {memberdesc} and {methoddesc} environments, as appropriate.
Minor nits.
1998-04-03 03:35:24 +00:00
5a52519a6e
add_idx(): Restore message to stdout when formatting the general index.
1998-04-02 22:39:05 +00:00
2b8093ab96
Match python.sty a little better.
1998-04-02 22:33:44 +00:00
537149707b
Removed an obsolete hack that's been commented out for a long time.
...
Added comments to various sections.
1998-04-02 22:33:16 +00:00
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
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
906f7ea429
Change quoting a little bit to avoid problems building it at CNRI.
1998-02-23 21:32:18 +00:00
78f6aac73e
Clean up some stuff in the {seealso} at the end. This avoids a little nit
...
(which causes processing to fail) when using the LaTeX hyperref package.
1998-02-23 21:31:24 +00:00
a705da7aa0
Marked the unmarked AttributeError. (AMK)
...
"Protect the class instance" --> "Protect the object" It works for anything
with attributes to look up! (AMK)
Logical markup.
1998-02-23 14:42:00 +00:00
71f894ad56
"streans" --> "streams" (AMK)
1998-02-23 14:37:40 +00:00
eb72a275b4
Add a period to "Written by James Roskind"
1998-02-22 20:42:11 +00:00
5ad78f39e7
Changed way *.ind are forced to exist; the files are now reset to contain
...
an empty index instead of touched. Note that for modindex.ind, this also
includes "\label{modindex}" so that the modindex.py script doesn't change
the set of labels in the document.
Be more consistent in use of $* in commands.
1998-02-22 19:47:13 +00:00
d028ca989a
Fixed and extended the example; the original example contained some
...
bogus code.
1998-02-22 04:41:51 +00:00
3ffb715032
Added two subsections with extra hints and details, even for
...
extensions and embedding programs.
1998-02-22 04:23:51 +00:00
1ee492e5d4
The list of module descriptions should be a {description} environment, not
...
{itemize}!
1998-02-21 06:30:17 +00:00
ed3515d541
Removed two items, correct one spelling error.
1998-02-20 21:55:10 +00:00
5c19c7bade
Tell TeX about a pathological hyphenation case (BaseHTTPRequestHandler).
1998-02-20 06:08:07 +00:00
2c8aa650a8
Added \label{}s for logical addressing.
...
Logical markup.
1998-02-20 06:03:52 +00:00
d67e12e65c
Added \label{}s for logical addressing.
1998-02-20 05:49:37 +00:00
7baf3d4ea7
Fixed typo reported by Vladimir Marangozov <Vladimir.Marangozov@imag.fr>.
1998-02-20 00:45:52 +00:00
f7f2e70fd4
Don't ignore makeinfo errors.
1998-02-19 21:40:51 +00:00
9c7c6bec98
Clean up name->name conversion a little, *make sure it happens in all the
...
right places*!
1998-02-19 21:40:22 +00:00
505d80b39d
Jeff Kunce writes (and he is right):
...
Also, I just ran across a [possible] minor glitch
in the library documentation for site.py. It says:
"For example, suppose sys.prefix and
sys.exec_prefix are set to `/usr/local'. The
Python 1.5 library is then installed in
`/usr/local/lib/python1.5'. Suppose this has a
subdirectory `/usr/local/python1.5/site-packages'
with three subsubdirectories, `foo', `bar' and
`spam'..."
I think it should be:
"...Suppose this has a subdirectory
`/usr/local/lib/python1.5/site-packages' with..."
^^^^
1998-02-19 21:02:32 +00:00
ef146222db
Revise comment about the {fulllineitems} environment to be accurate.
1998-02-19 21:02:26 +00:00
6eb1f6b251
Improve support for logical node names.
1998-02-19 21:00:41 +00:00
0cf0cfbaa9
Adjusted \label{} for *consistent* logical addressing.
...
Logical markup.
1998-02-19 20:59:19 +00:00
c83db33781
Added \label{} for logical addressing.
1998-02-19 20:50:52 +00:00
9168328572
Add missing files to $(LIBFILES).
...
Run node2label.pl on the HTML versions of all the LaTeX manuals.
1998-02-19 20:46:47 +00:00
c3e4549012
Added \label{} for logical addressing.
1998-02-19 20:22:13 +00:00
83efb54562
Added \label{} for logical addressing.
1998-02-19 20:07:39 +00:00
af9b6e6607
Added itemized list of Macintosh modules, similar to the other chapters.
1998-02-19 19:45:19 +00:00
cea0e7350d
Added \label{} for logical addressing.
1998-02-19 19:40:17 +00:00
83c1a39c4b
Separate chapter and section.
1998-02-19 18:59:48 +00:00
baa04a1c77
Make sure the general index and about nodes get labels assigned, so they get
...
real names instead of node#.html names.
1998-02-19 18:51:39 +00:00
1aabe5e4d1
Separate binhex and binuu documentation from binascii. Support better
...
module addressing in HTML.
1998-02-19 18:29:18 +00:00
05ce570e8b
Remove debugging print.
...
Support {classdesc} and {fulllineitems} environments.
Support most recent logical markup.
1998-02-19 17:26:48 +00:00
1f0fdde4fb
Bring date into line with the last documentation release.
1998-02-19 16:18:19 +00:00
526ebb4d97
Work on a temporary file, not the input file.
1998-02-19 16:01:41 +00:00
a799835460
Revised some targets to make better use of make "special" variables, to avoid
...
repeating file names.
Change lib.texi target to not overwrite the input file; work on a copy.
1998-02-19 16:01:04 +00:00
ef058037a5
Support environments {fulllineitems} and {classdesc}, more of the new logical
...
markup.
The info generation now works, yet again.
1998-02-19 15:20:30 +00:00
c92740708d
Adjust grouping for the "b(reak)" command syntax description. This is
...
required to get the info generation back in operation, yet again.
1998-02-19 15:18:02 +00:00
20e01966f5
Logical markup.
...
Several uses of "\^" could be simplified; this fixes part of the info
generation process.
1998-02-19 15:09:35 +00:00
ea8006a865
\nodename{} must immediately follow \chapter{} to be handled correctly;
...
adding the \label{} broke that.
1998-02-19 14:00:22 +00:00
75bfb0f7bb
{fulllineitems} is now an environment; use it as such.
1998-02-19 06:32:06 +00:00
802a202d0d
Logical markup.
...
Changed {funcdesc} to {classdesc}. This is a test case for {classdesc}.
1998-02-19 06:26:35 +00:00
fb5e54d497
Mostly LaTeX style cleanup.
...
Use \newenvironment{envname} instead of \newcommand{\foo} &
\newcommand{\endfoo} (or \let\endfoo=...!) wherever reasonable.
Where {*desc} environment helper functions are not needed outside a
single environment definition, inline them.
Ensure that \seemodule{} and \seetext{} are only available within the
{seealso} environment.
Added "()" to the index entries for {funcdesc} and {cfuncdesc} environments.
Added {classdesc} environment which looks like the {funcdesc} environment
but doesn't add the parens in the index entry.
1998-02-19 06:23:06 +00:00
c02fbe52b2
breakable_re: Fix the RE so that module definition entries don't prevent
...
combining.
1998-02-19 06:05:29 +00:00
a73033fcc2
Feature added by Bill van Melle: when no timezone is present, assume
...
local time -- that's better than failure.
1998-02-19 00:28:58 +00:00
ce0e175554
&do_cmd_url,
...
&do_cmd_email: Adjust to use a font similar to that used in the printed
representation.
&my_module_index_helper: Change to be only used for defining markup. Don't
prepend an <A NAME=...> to the result; use the containing page as
the module target for the index.
&ref_module_index_helper: New function. Used only for references to modules
described elsewhere. Generate the right target.
&init_myformat: Set the anchor_mark to an empty string; this avoids junky
" "'s in the text, which could really screw up vertical spacing
when that's all that's in a paragraph.
&do_cmd_seemodule: Insert markup to jump right to the referred-to module.
1998-02-18 22:45:53 +00:00
026d9626df
Consistent spelling: "time zone" -> "timezone".
...
Clarify that the sign of the timezone offset returned by
parsedate_tz() is the opposite of time.timezone.
1998-02-18 21:47:29 +00:00
4186cd3df2
Add named destinations for \label{} in the PDF.
...
Fix \email{} so it doesn't rely on \url{}.
1998-02-18 17:21:09 +00:00
8ff4b8b05b
Add new files from the Mac user interface breakup.
1998-02-18 17:19:53 +00:00
b4efb6c8cb
Separate Mac user interface modules into separate files, to better support
...
bookmarkable module sections in the HTML.
1998-02-18 17:19:11 +00:00
9caa110141
assure a consistent assignment for nodes with multiple labels
1998-02-18 16:10:22 +00:00
b866020f66
Added a number of items....
1998-02-18 16:03:43 +00:00
dd94676865
Added libsymbol.tex, libtoken.tex to dependencies for the libref.
...
New targets: ???-all, for each document. This creates all formats of the
named document (DVI, HTML, PDF, PS).
l2hlib: Added commands to translate node*.html to use the \label{} stuff,
as supported by Jeremy's node2html.pl. This gives us mostly
bookmarkable nodes.
1998-02-18 16:02:14 +00:00
b0df567897
Separate the parse, symbol, and token documentation into separate files.
1998-02-18 15:59:13 +00:00
710c035c05
Added \label{} for logical addressing.
1998-02-18 15:47:17 +00:00
31ecd50d02
Added \label{} for logical addressing.
1998-02-18 15:40:11 +00:00
af0bfbee46
Added \label{} for logical addressing.
...
Logical markup.
1998-02-18 15:39:15 +00:00
1f3ab1cb6c
Added \label{} for logical addressing.
1998-02-18 15:22:08 +00:00
55fca54ebb
Added \label{} for logical addressing.
...
Logical markup.
1998-02-18 15:21:26 +00:00
12918af83e
Added \label{} for logical addressing.
1998-02-18 15:10:24 +00:00
ddf03bf8e1
Added \label{} for logical addressing.
...
Logical markup.
1998-02-18 15:05:47 +00:00
9acafa8bb5
Don't make backups.
...
Use "mv" instead of "ln -s" to install the new names.
1998-02-18 14:52:24 +00:00
0c17d661e0
\url{}: For pdflatex, make the link active & make it blue. If anyone figures
...
out how to make the border go away completely, please let me know!
1998-02-18 14:24:19 +00:00
1931c0c961
Add normpath(). Clarify normcase(). (Note -- this doc section
...
probably needs more work, describing new functions and the differences
between unix/mac/win.
1998-02-18 14:00:05 +00:00
daa2d5d4ea
Patch HREFs in html files, replacing nodeXXX.html with label.html.
1998-02-18 13:53:48 +00:00
8cf94e608e
Add mktime_tz(). Add () to a function reference in parsedate_tz().
1998-02-18 05:09:14 +00:00
a219e7976f
main(): Include a \label{modindex} in the output so latex won't let us re-use
...
the name elsewhere. This is useful for the logical filenames project,
since the "modindex" label is hardcoded into .latex2html-init.
1998-02-17 23:13:19 +00:00
45a40930e7
&do_cmd_textohtmlmoduleindex: Get the modindex key added to the label->node
...
association.
1998-02-17 23:11:40 +00:00
57b5e42c0c
Added \label{} for logical addressing.
1998-02-17 22:30:13 +00:00
e2f194b57d
Use \manpage{} markup for referencing a UNIX man page.
...
Added index entry for DES cipher.
1998-02-17 22:24:45 +00:00
8ecc705ba4
Added comment explaining the only warning produced by makeindex, since there
...
doesn't appear to be a way to fix that's reasonable.
1998-02-17 20:31:08 +00:00
326e19700f
Remove Macintosh ligatures item. Solution: Update your Times fonts.
...
Added native package semantics note.
1998-02-17 20:14:12 +00:00
81f4b663b4
Started a TODO list with the latest bug reports.
...
In part prompted by questions from AMK.
1998-02-17 19:01:02 +00:00
5fd242b085
Clarified comment about the PS generation when using the all-pdf target.
1998-02-17 18:20:30 +00:00
30d17825ac
Add magic to make PDF generation use maximal compression.
1998-02-17 15:56:55 +00:00
ddae414cb5
Added all-formats target: use this to get both PDF and PS files; using the
...
"alternate" rules for PDF generation doesn't ensure the PS files get
generated since distiller isn't used.
Switch to the "alternate" rules for PDF generation; this is starting to make
more sense than the distiller-based rule, and requires only free software.
I'm also confident it's working well (meaning I paged through all four
pdflatex-generated PDF files).
1998-02-17 15:45:25 +00:00
5c4e648731
Updated date for interim documentation release.
1998-02-17 15:41:45 +00:00
5374045271
If generating PDF, include the author and title information in acroread's
...
"File->General Info" dialog.
1998-02-17 15:13:01 +00:00
e8b46132e2
Massive changes. Fewer warnings from the Python Library Reference. Still
...
messy, but the thing seems to be working without bombing completely today.
Formatting lib.texi with TeX doesn't seem to do too badly, either!
Info formatting isn't quite there; that might just have to disappear this
time.
1998-02-17 05:54:46 +00:00
7154d382c3
Update indexsubitem for file attributes correctly.
1998-02-17 02:11:21 +00:00
a200faac55
\nodename{} must appear immediately after \section{} for the info conversion.
1998-02-17 02:10:41 +00:00
06e1664c77
Indent {verbatim} environments like in the printed version.
1998-02-16 22:50:06 +00:00
76183c0ed8
Move optional package inclusions to the top, to make them easier to find.
...
Code elsewhere in this file tests for the inclusion of the package and does
not need to be uncommented. Comments explain what they do and how to
disable them.
Added support for the optional "fancyhdr" package. If used, page footers
include chapter information on the left and section information on the right.
Both optional packages, "fancyhdr" and "times", are enabled by default. We
may want to disable them before shipping, but I'm not completely convinced.
(How many installations format their own documentation?)
1998-02-16 22:30:10 +00:00
fac431e7d5
NNTP.xgtitle() description: Add a missing ")" from the response value
...
description.
NNTP.xover() description: Adjust some markup for consistency.
1998-02-16 21:57:37 +00:00
009ab92c12
Made the area for wildcards in the description wider, so we don't invade the
...
left margin.
1998-02-16 21:37:58 +00:00
75fc045bf5
Fixed formatting of the program name for crypt.
...
Added another index entry.
1998-02-16 21:36:57 +00:00
ad51192a4f
In the example file name, use the current Python version, not a hardcoded
...
value.
Use logical markup.
1998-02-16 21:25:53 +00:00
2705e801d9
For the lists which describe the regular expression syntax, increase the
...
width available so we don't run into the left page margin.
1998-02-16 21:21:13 +00:00
b0f77d65db
Use \version to get the current Python version number, where possible. This
...
can only be done in the running text, and not in {verbatim} environments.
1998-02-16 20:58:58 +00:00
7506298dfb
Mark up filename extensions consistently.
...
Logical markup.
1998-02-16 20:40:37 +00:00
3b26eeddea
Added rule to generate the PDF format using pdflatex. Commented out since
...
this is still experimental software. See the comment.
1998-02-16 17:06:10 +00:00
9d20ac36a9
Removed various "(New in 1.5a?!)" constructs. Other notes pertaining to
...
versioning remain intact.
1998-02-16 15:27:08 +00:00
70d289d04b
Break up some long lines in the generated header & footer.
1998-02-16 15:23:11 +00:00
1aedbd8b0a
"--" --> "---" in two places.
1998-02-16 14:47:27 +00:00
4de05a90be
Place C typedef for Py_complex after brief description, to be more consistent
...
with the other example of a structure description (struct _frozen).
Added index entries for the modules referenced in the document.
1998-02-16 14:25:26 +00:00
53fb7723ee
Added index enties for the Python built-in functions, where appropriate.
1998-02-16 06:23:20 +00:00
e058b4f124
Lots of nitty-gritty stuff:
...
Use \emph{} when referring to title of any of the Python manuals, like is
done in the other manuals.
In some places, use \emph{} or \dfn{} instead of ``...''.
Use \samp{} instead of \code{} when marking identifier prefixes.
Use logical markup wherever it made sense.
Fixed a bunch of typos.
In several places, use "---" instead of "--" to get the emdash.
Start sentences with capital letters and end them with periods, as needed.
"it's" --> "its" in many places: "it's" it *always* a contraction of "it is",
and "its" should always be used for the possessive.
"don't" --> "doesn't"
"should discards any" --> "should discard any"
In C function descriptions, use \var{} to mark parameters in the running
text instead of \code{}. This matches usage in the other manauls better,
and is more consistent with the formatting of the function signatures.
Lots of little changes to implement this.
Lots of fixups needed due to appearant heavy cut-&-paste in the orignal
document.
Mention that the exception objects may be either classes or strings,
depending on the use of -X; they were unequivocally stated to be strings
in the section "Standard Exceptions".
"mkvalue()" --> "Py_BuildValue()"
Description of PyNumber_Power() indicates that the third value is option,
but not how to indicate that it was omitted. Clarified.
Explain the behavior of PyString_FromStringAndSize() if the buffer is NULL.
Explain the Py_complex structure a little (tell what it's used for) and use
a {verbatim} environment for the structure definition itself.
Fix explanation of PyFile_SoftSpace().
Update the example version string to 1.5.
Combined the sections on defining new object types.
1998-02-16 06:15:35 +00:00
f1a4150b70
Make sure indexes begin on odd-numbered pages.
1998-02-16 05:30:27 +00:00
b666c15c4a
Normalization of markup.
1998-02-13 22:22:36 +00:00
6e99adb1c9
Don't capitalize identifiers at the beginning of the sentence; re-write to
...
place them elsewhere so they get the right capitalization.
1998-02-13 22:17:21 +00:00
01dbb88831
Fix some markup so that the right characters are printed.
...
"EOF" --> "\EOF{}"
1998-02-13 22:13:07 +00:00
4a1efb63a9
Capitalize subsection title.
1998-02-13 22:10:21 +00:00
ab875b9a32
Make one paragraph wrap a little better.
1998-02-13 22:07:33 +00:00
a19bb9bbcf
Capitalize first word in sentences, use periods at end.
1998-02-13 21:57:33 +00:00
86b5dcec86
Change {datadesc} environments with empty descriptions to \dataline{}s; this
...
removes extra vertical space from the list of names, and makes the display
more similar to that used in the socket module, where several constants share
a description.
1998-02-13 21:55:21 +00:00
fc931ecf92
In description of sound_similar(), break up the markup for long
...
\code{} at each embedded space, so that the words will wrap. This keeps
it from being too ugly.
1998-02-13 21:49:12 +00:00
315b5d8a7f
In description of __import__, second paragraph, break up the markup for long
...
\code{} at each embedded space, so that the words will wrap. This keeps it
from running off the side of the page, and is only slightly weird.
1998-02-13 21:26:35 +00:00
83bd081920
Minor stuff:
...
Explain what happens when a negative shift count is used (what exception).
Mark the title "Python Reference Manual" as \emph{}, for consistency.
"info" --> "information"
Tell more about the data attributes of file objects, using the {datadesc}
environment.
When refering the user to the language reference for information about
internal types, tell what internal types to expect information on.
1998-02-13 20:59:25 +00:00
4c6896304b
Fix weirdness with single-page table of contents, reported by Guido.
1998-02-13 16:58:49 +00:00
2549249f79
&do_env_datadescni,
...
&do_env_funcdescni: New functions. These support the non-indexing variety
of the {datadesc} and {funcdesc} environments.
There's still some flakiness with the new indexsubitem support, but that's
low priority.
1998-02-13 15:08:36 +00:00
fb74a463ad
Add "Pretty Good Privacy" as well as "PGP" to the index.
1998-02-13 14:52:17 +00:00
c9c456ef69
In add_label_data() description, use "\samp{}" instead of "``\code{...}''"
...
to indicate the interpreted letters from the format string.
1998-02-13 14:48:00 +00:00
7f6e2c45ec
Use "\samp{...}" instead of "``\code{...}''" when showing markup fragments
...
in the running text.
For computed attribute and method names (where there's a \var{} part to
the name), use the non-indexing forms of \datadesc{} and \funcdesc{}.
This doesn't change the printed output, but removes 3 rejections from the
makeindex run and allows the LaTeX2HTML support to exclude these from the
index.
1998-02-13 14:38:23 +00:00
b441eb84d3
Use "\samp{...}" instead of "``\code{...}''" when showing markup fragments
...
in the running text.
For computed method names (where there's a \var{} part to the name), use
the non-indexing form of \funcdesc{}. This doesn't change the printed
output, but removes 3 rejections from the makeindex run and allows the
LaTeX2HTML support to exclude these from the index.
1998-02-13 14:37:12 +00:00
aebc6f399e
Two new environments: datadescni and funcdescni. These are similar to
...
datadesc and funcdesc, but don't add entries to the index.
1998-02-13 14:34:04 +00:00
00dcfb2bc3
&get_indexsubitem: This now has a chance of working, thanks to:
...
&do_cmd_setindexsubitem: New function. Set the indexsubitem value from
\setindexsubitem{(...)}.
&do_env_opcodedesc: By default, don't index byte codes.
$INDEX_OPCODES: New flag. If true, index the byte codes. Default is off.
Normalize indentation to 4 spaces everywhere.
Minor nits.
1998-02-13 07:21:03 +00:00
8842e867af
Remove \bcode / \ecode everywhere.
...
Make all the indentations in {verbatim} environments have column 0 of the
listing in column 0 of the file.
Remove pagenumbering / pagestyle cruft.
Use more logical and less physical markup.
1998-02-13 07:16:30 +00:00
1e11a5c117
Remove \bcode / \ecode everywhere.
...
Make all the indentations in {verbatim} environments have column 0 of the
listing in column 0 of the file.
Remove pagenumbering / pagestyle cruft.
1998-02-13 07:11:32 +00:00
2a4646c660
Remove obsolete pagenumbering / pagestyle cruft.
1998-02-13 07:08:56 +00:00
1947991c2f
Remove all \bcode / \ecode cruft; this is no longer needed. See previous
...
checkin of myformat.sty.
Change "\renewcommand{\indexsubitem}{(...)}" to "\setindexsubitem{(...)}"
everywhere.
Some other minor nits that I happened to come across.
1998-02-13 06:58:54 +00:00
dc8af0acc1
Lots of stuff:
...
Handle most (all?) of the page style / numbering magic here so the documents
don't have to do it individually.
Revise the \bcode / \ecode stuff so that the {verbatim} environment handles
it right directly. \bcode / \ecode will be completely removed from all files
(to be checked in momentarily).
Have the {verbatim} environment get the samples indented a bit; this
appearantly had been attempted in the old code, but didn't work because
paragraphs weren't indented.
Make all headers, from chapters on down to subparagraphs, have sans-serif
titles.
\setindexsubitem{}: New macro. Replaces \renewcommand{\indexsubitem{}(...)}
everywhere. This allows LaTeX2HTML to be made to work correctly for
this. That was near impossible with the old mechanisms.
For all {*desc} environments, make the name of the described thing bold as
well as monospaced.
{opcodedesc} environment: Don't index the byte code names; that doesn't seem
terribly useful, and there are a lot of them.
\var{}: More magic to make sure that the size is right even if embedded in
\file{} or some other macro that uses the sans-serif font in running
text.
\bfcode{}: New macro. Makes the font \code{} and bold. (Was unreasonable
using old LaTeX 2.09.)
\file{}: Adjust the size of the sans-serif font a little.
\email{}, \url{}, Make these use the same font as \file{}, but not the
surrounding single-quotes.
Update many comments.
Lots of minor nits and a little cleanliness.
1998-02-13 06:48:05 +00:00
cffaebb621
parse_line(): Strip whitespace from the module name.
...
main(): Include a comma between the module name and page number, to make
the generated index more like the "standard" generated index.
1998-02-13 05:11:05 +00:00
6eab2fb0f1
Clean up some of the definitions related to info generation.
1998-02-13 03:23:33 +00:00
e5bc49785c
"ASCII" --> "\ASCII{}"
1998-02-12 23:36:49 +00:00
04cf4dcf58
Added tarpdf target.
...
Don't remove *.texi & *.info for clean; only for clobber.
Don't remake tarballs if not needed (PDF & PS only). HTML tarball is still
painful.
1998-02-12 22:33:50 +00:00
e5bf8b2c79
Reorganized a bit. No changed content.
...
Guido, please take a look at new structure, at least the ToC.
1998-02-12 21:22:28 +00:00
f44617d298
For sections describing the "Foo Protocol", consistently use the capitalized
...
"Protocol" and not "protocol".
1998-02-12 20:57:15 +00:00
faa1afe2d7
Py_Exit(status) calls exit(status), not exit(0).
1998-02-12 20:51:02 +00:00
da62398139
Correct description of BUILD_SLICE.
1998-02-12 03:53:02 +00:00
63221124c0
Comment out the times package in the distributed version.
1998-02-12 03:48:50 +00:00
dd1f6cc402
Mark opcode arguments \var{} in the running text.
...
In IMPORT_NAME description: "is not affect:" --> "is not affected:"
1998-02-12 03:32:18 +00:00
8a72a7e344
Use new \authoraddress{}; author's name and address are now separate.
...
Use new \release{}; this is now separate from \date{}.
Use \email{} instead of \code{} for email addresses.
1998-02-12 03:16:04 +00:00
71c1ef34bf
Remove second index entry for UserList.
1998-02-12 03:10:55 +00:00
06f169bb7f
\rfcindex{}: Removed; no longer needed.
...
\file{}: Use a sans-serif font for the filename itself.
Use the fncychap.sty package for fancy chapter headings.
Replace the \maketitle command with our own format. This is new, but it
looks a lot better than the old one.
Use \renewcommand instead of \def when extending or overriding standard LaTeX
commands. This makes it more LaTeX-like.
1998-02-11 23:08:20 +00:00
0e823d2abd
New file. Written by Ulf A. Lindgren <lindgren@ae.chalmers.se>; we have
...
permission to distribute this without modifications. This is the latest
version, directly from Ulf.
CTAN:macros/latex/contrib/supported/fncychap/
1998-02-11 23:01:23 +00:00
692b87db15
Added \nodename; added index entry for UserList.
1998-02-11 23:00:08 +00:00
f6a7b443c2
Added entries for stat, commands modules.
1998-02-11 22:58:55 +00:00
6d659b3e51
Added entries for re, soundex modules.
1998-02-11 22:57:10 +00:00
38e0df330b
Some subtleties suggested by Tamito Kajiyama, including an added
...
\nodename macro for a section with a very underscriptive title.
1998-02-11 22:55:55 +00:00
f5370f4019
Turn the space in [\^ ...] into a hard space: [\^\ ...].
1998-02-11 22:52:47 +00:00
1c974db134
Split UserDict and UserList on two separate lines; added entries for
...
modules symbol and token.
1998-02-11 22:36:17 +00:00
ee833cca7b
Don't break a long line at an unpleasant point.
1998-02-11 22:34:51 +00:00
8b0927eddc
Added missing entry for cmath.
1998-02-11 22:33:57 +00:00
c57aff20e3
Replace $math$ with \code{}.
1998-02-11 22:33:28 +00:00
c4452fd08f
Swap ni and imp (so they are in the same order as their sections are).
1998-02-11 22:32:23 +00:00
34122fa99c
Remove a spurious space from the title.
1998-02-11 22:31:54 +00:00
ed68854b40
"lists objects" --> "list objects" (Section "More on Lists".)
1998-02-11 22:29:17 +00:00
8d486b1779
In the appendix, all sections were marked as subsections, and so had section
...
numbers "A.0.#". Fixed.
1998-02-11 22:12:18 +00:00
5d8f0edc33
Add copyright.tex and boilerplate.tex to the common dependencies for .dvi
...
files.
1998-02-11 14:43:38 +00:00
a28eb3a8cb
Mark the URL "ftp://ftp.python.org" with \url{}.
1998-02-11 14:42:06 +00:00
4254363f25
&do_cmd_rfc: New function. Handles \rfc{}.
...
$STRIP_INDEX_TT: New flag. If set, the <tt>...</tt> around stuff in the index
is dropped. This is more O'Reilly-like.
&make_str_index_entry: Honor $STRIP_INDEX_TT.
&make_mod_index_entry: Honor $STRIP_INDEX_TT.
1998-02-10 22:11:07 +00:00
526467ce0a
Removed all references to the \rfcindex{} macro; now only \rfc{} is used.
1998-02-10 21:42:27 +00:00
a94d21f44e
Minor performance nits.
1998-02-10 21:35:49 +00:00
4be00713b8
Include indfix.py script in lib.dvi's processing.
1998-02-09 22:18:42 +00:00
dd244a0b9e
Script to fix up the Library Reference index so it's less ugly. The docstring:
...
"""Combine similar index entries into an entry and subentries.
For example:
\item {foobar} (in module flotz), 23
\item {foobar} (in module whackit), 4323
becomes
\item {foobar}
\subitem in module flotz, 23
\subitem in module whackit, 4323
Note that an item which matches the format of a collapsable item but which
isn't part of a group of similar items is not modified.
"""
This results in a much more readable index, with less repitition of text;
especially for common method names.
1998-02-09 22:17:52 +00:00
1624a507e6
Oops, missed a \POSIX{} in an index entry.
1998-02-09 22:12:28 +00:00
88223904c8
Add some index entries; switch to logical markup.
1998-02-09 20:52:48 +00:00
65b32f7f74
Consistently use \POSIX{} to denote POSIX. There were at least two different
...
ways to do it previously (not counting module names).
1998-02-09 20:27:12 +00:00
41785fb864
Do the right magic to make \ABC{} get sorted correctly in the index.
1998-02-09 20:16:46 +00:00
19b97b13fa
Do the right magic to make \UNIX{} get sorted correctly in the index.
1998-02-09 20:16:18 +00:00
c58912426e
Use the new RFC macros wherever RFCs are referenced by number. No other
...
changes.
1998-02-09 19:16:20 +00:00
b16166e56f
Add macros to insert RFC references much like the \manpage{} macro. Also a
...
macro to insert an RFC index reference.
(RFC references were formatted three different ways.)
1998-02-09 19:14:54 +00:00
8083c176a3
Add a note about rounding up of readlines()' sizehint to 8K.
1998-02-08 22:51:09 +00:00
6e91c6a344
Document getrefcount().
1998-02-07 21:17:05 +00:00
b37a395231
\itembreak, \itemjoin: Remove unused macros.
...
\idxcode{}: New macro; used to mark things that would be \code{} for entry
into the index. This allows easily switching things around for the
font used in the index. (O'Reilly seems to keep it all plain roman
in the index. Looks reasonable in the Python documentation as well.)
\*index{}: Use \idxcode{} instead of {\codefont{}}.
1998-02-06 22:52:52 +00:00
31c4ed75fc
Remove commented-out \itembreak.
1998-02-06 22:26:04 +00:00
c660233cfb
Update two of the \indexsubitem values to use singular rather than plural form
...
of "variable": each individual variable should be identified as a single
variable and not a collection in the index.
1998-02-06 22:19:23 +00:00
8e1e68de49
Add ref to errno module, and change ref to posix.error to os.error.
1998-02-06 15:18:25 +00:00
f499e09f94
Add ref to errno module.
1998-02-06 15:18:05 +00:00
afcd589027
Retract the statement that all functions called by Python (even method
...
defs) need to be declared extern "C" -- it seems to have no basis in
truth (any more?).
1998-02-05 19:59:39 +00:00
6b7fc6f267
Add *.pdf files to the clobber target (same target as *.ps).
1998-02-04 20:33:13 +00:00
baf700f398
Tell CVS to ignore PDF files.
1998-02-04 20:27:39 +00:00
b6e5032d9c
Added description of "D" format for PyArg_ParseTuple(), including example
...
use with function name provided as well.
Wrapped up PyArg_ParseTupleAndKeywords() description and provided example
based on Geoff Philbrick's example to the mailing list.
1998-02-04 20:26:31 +00:00
126d840d1a
Use implicit rules to perform DVI->PS and PS->PDF conversions. PDF conversion
...
requires "distill" from a FrameMaker installation. ;-) Would probably need
to be different for Windows/Mac.
1998-02-04 19:54:40 +00:00
b19274704f
\modindex{}: New macro; index module without declaring it "built-in" or
...
"standard". This is mostly for documentation of modules outside the
standard library.
1998-02-04 14:43:36 +00:00
8aad4c80b3
Added missing "{" for "\code <?stuff?>}".
1998-02-03 23:12:13 +00:00
ad37e9e77d
Clarify that capwords() removes leading/trailing whitespace.
...
Remove references to regsub, which is obsolescent.
1998-02-02 03:01:10 +00:00
c45c2f3dc1
Add S_ISBLK().
1998-01-29 22:03:41 +00:00
02505e4850
New version of xmllib from Sjoerd.
...
The main incompatibility is that the error reporting method is now
called as
parser.syntax_error(msg)
instead of
parser.syntax_error(lineno, msg)
This new version also has some code to deal with the <?xml?> and
<!DOCTYPE> tags at the start of an XML document.
The documentation has been updated, and a small test module has been
created.
1998-01-29 14:55:24 +00:00
7570669a08
Add a note explaining that multiplying a sequence with a negative
...
number is the same as multiplying it with zero, and yields an empty
sequence.
1998-01-27 19:09:43 +00:00
c6c921a4de
Py_AtExit(): Added brief note about the constraint on cleanup functions not
...
calling the Python API.
1998-01-26 19:16:27 +00:00
16f88454f1
Use \url{} to mark a URL.
1998-01-22 20:47:26 +00:00
ff3f0d0a5c
Use \url{} to mark URLs, \email{} to mark an email address.
1998-01-22 20:45:31 +00:00
ca6567fb3f
Use \url{} to mark URLs.
1998-01-22 20:44:18 +00:00
301ad2ee63
Fixed indexing of {datadesc} environments.
...
Removed " (byte code instruction)" from the output of the {opcodedesc}
environment; this should only appear in the index (which it now does).
Removed some really old cruft related to otherwise removed debugging code.
(I *think* assignments to $* set & clear auto-flush of <STDOUT>, but don't
really remember. Removing them seems to not change anything!)
1998-01-22 18:14:39 +00:00
Fred Drake
Andrew M. Kuchling
Guido van Rossum
Jeremy Hylton