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
0f02628dce
\seemodule{}: Use logical markup for the module name, to ensure it picks up
...
any changes introduced there. Also ensure a little more space between
the module name and the parenthesized comment.
1998-01-22 17:43:15 +00:00
7c418ed89c
Added descriptions for log() and log10().
...
Clarified that floor() and ceil() return reals. Same for the integer part
returned by modf().
Some markup consistency changes.
1998-01-22 17:37:50 +00:00
bceaf35a63
Add support for the new macros, including hyperlink generation for \url{}.
1998-01-22 16:13:44 +00:00
ed79783bb2
Converted to use new macros. This example demonstrate \method{} and, more
...
importantly, \url{}.
1998-01-22 16:11:18 +00:00
55f4492859
Converted to use semantic markup. This is an example of how many of the new
...
constructs should be used.
1998-01-22 15:56:41 +00:00
dd28d57fd0
Revised new macros after discussion with Guido: Always use full names of
...
semantic concepts.
Added two new ones (not discussed with Guido:
\constant{}: Markup for constants defined in Python modules.
\cfunction{}: Markup for C functions; these should probably be distinguished
by font, but are not at this time (since they're typically \code{} at
this point).
1998-01-22 15:55:21 +00:00
0f35495563
Add entry for copy_reg module.
1998-01-21 05:04:52 +00:00
6eb9f10063
Removed entry for copy_reg module.
1998-01-21 05:00:28 +00:00
251fed3e56
$(LIBFILES): Added libcopyreg.tex.
1998-01-21 04:59:44 +00:00
2d754437d4
Add entry for copy_reg module.
1998-01-21 04:58:39 +00:00
1abf0df5b4
Simple documentation of the copy_reg module.
...
Guido, you should probably look at this. The pickle documentation is out of
date; I don't see anything about the __reduce__() stuff or the
__safe_for_unpickling__ attribute.
1998-01-21 04:58:10 +00:00
d1cc9c2b92
Update comment about relative URL internet draft to reflect current RFC status;
...
index references the appropriate RFCs.
Consistency: Always use trailing "()" on function names in running text.
1998-01-21 04:55:02 +00:00
61b0452626
Added a bunch of "concept" index entries.
...
Use trailing "()" on function names in running text.
1998-01-20 05:52:23 +00:00
a46f84d293
Added index entry and \label{} for exceptions module. This isn't in the
...
normal modules portion of the manual, but that's the basic effect of this
section with the 1.5 change in exception support.
1998-01-20 05:26:12 +00:00
73a973bf8d
Always mark variables in the "Notes" following a table the same way as in the
...
tables: \var{}
Add a couple of index entries to the File Objects section.
1998-01-20 05:20:39 +00:00
cbe50f4829
Removed bogus index entry for the type() built-in.
...
Marked title of the Python Reference Manual as \emph{}, like other Python
manual titles.
1998-01-20 05:12:36 +00:00
311c19688d
Proposed new macros: see comments. These are not yet used.
...
These are intended to support semantic markup. There are a number
of places in the documentation where the exact meaning of an
indentifier marked \code{} in the running text is ambiguous (could
be a module or a class, a function or a method, etc.). These are
intended to clarify the intent of the identifier for processing
applications and more intelligent style processing.
1998-01-20 05:07:19 +00:00
cb42f7c295
Consistency: "{\tt ...}" ==> "\code{...}"
1998-01-20 04:55:47 +00:00
9eb5e5097e
Consistency: "{\it ...}" ==> "\emph{...}"
1998-01-20 04:54:23 +00:00
c520b695fe
The soundex module is built-in, not standard.
...
"--" ==> "---"
1998-01-20 04:45:44 +00:00
ca12b9df7b
Consistency: {\it ...} ==> \emph{...}
1998-01-20 04:43:29 +00:00
dd17d1ce62
ni is a standard module, not a built-in module. The only other reference to
...
it already got it right.
1998-01-20 04:40:41 +00:00
bac354cd80
Consistency: (Yes, I know this section is not formatted by default, and
...
isn't likely to be of much interest these days....)
{\tt ...} ==> \code{...}
Added \label{module-blat} for the two supporting modules.
Added index entries for referred-to modules.
1998-01-20 04:32:09 +00:00
79a6a9e882
Removed a confusing note about coercions and __r*__ operators.
1998-01-19 23:16:55 +00:00
46503922a0
Various updates to the effect that the group argument is always optional.
...
Also documented that groups() now always returns a tuple.
1998-01-19 23:14:17 +00:00
7d4ecb8785
Add note about dropping latex 2.09 compatibility.
1998-01-19 23:10:21 +00:00
8095ebfc4a
Consistency: Replaced 4 {\it ...} with \emph{...}.
1998-01-19 04:02:41 +00:00
94e8f690dd
Consistency: Replaced one {\tt ...} with \code{...}.
1998-01-19 02:55:11 +00:00
b6ce6427e8
Consistency: In two places, change {\it ...} to \emph{...}.
1998-01-19 02:51:02 +00:00
53396f66c1
Consistency: In two \section{} headers, change {\tt ...} to \sectcode{...}.
1998-01-19 02:48:37 +00:00
9e24309bb5
\funcitem{}, \dataitem{}, \excitem{}: Removed obsolete macros; there are no
...
longer used anywhere. Use the {*desc} environments instead.
\var{}: Ensure that the argument is always set in roman italic, in case an
alternate font is being used for code. These keeps the result of
\var{} consistent.
Some minor changes to allow easier exploration of alternate fonts for code in
the running text. Haven't changed the selected font; I haven't found one that
has everything required! (The best non-monospaced font so far was missing
the <, >, and | characters, or at least had them at the wrong locations. It
also allowed confusion between upper-case I and lower-case L.)
1998-01-18 05:09:54 +00:00
b660b63edf
Use \emph{} for all references to the other documents, not just some of them.
1998-01-16 16:34:34 +00:00
5081b227f1
Ouch: "accounces" ==> "announces"
...
(In description of AbstractWriter class.)
1998-01-15 05:49:00 +00:00
af8a015c93
Consistency: "{\bf ...}" ==> "\strong{...}"
...
"{\em ...}" ==> "\emph{...}"
Not at all sure what to do with "{\rm ...}".
Leaving it for now.
1998-01-14 14:51:31 +00:00
b215137224
Added the standard \label{module-*} for the two supporting modules.
1998-01-14 05:47:15 +00:00
8ac34c2928
Consistency: "Unix" ==> "\UNIX{}"
...
Always include the comma *inside* the \optional{} markup!
1998-01-13 22:41:33 +00:00
737e73ec3d
Augment \tableofcontents to do the right thing.
1998-01-13 22:40:08 +00:00
4d4f9e726a
Removed \mytableofcontents; just use \tableofcontents.
1998-01-13 22:25:02 +00:00
3e9ce54eff
Removed one hack!
1998-01-13 22:23:30 +00:00
a809064166
Consistency: "Unix" ==> "\UNIX{}"
1998-01-13 19:10:02 +00:00
6862b46b70
Consistency: "unix" ==> "\UNIX{}"
1998-01-13 19:03:36 +00:00
c9dc5151b6
Consistency: "unix" ==> "\UNIX{}"
...
Added \label{} for referring to the module.
1998-01-13 19:01:57 +00:00
efc1e0f43b
Consistency:
...
"Unix" ==> "\UNIX{}"
1998-01-13 19:00:33 +00:00
3f20592c3e
Consistency:
...
"Unix" ==> "\UNIX{}"
"C" ==> "\C{}"
"C++" ==> "\Cpp{}"
1998-01-13 18:56:38 +00:00
b0a78738ea
Consistency:
...
"Unix" ==> "\UNIX{}"
"C" ==> "\C{}"
"C++" ==> "\Cpp{}"
1998-01-13 18:51:10 +00:00
18f9f539f2
Removed obsolete \kwindex{} call.
...
Added "user configuration file", ".pythonrc.py file" to the index.
Made reference to site module a {seealso} environment.
1998-01-13 18:45:34 +00:00
2b67bee8e1
Added "module search path" to the index.
1998-01-13 18:35:51 +00:00
cf75754357
Removed obsolete \kwindex{} calls.
...
Added "module search path" to the index.
"Unix" ==> "\UNIX{}"
1998-01-13 18:34:40 +00:00
bc5062f664
\kwindex{}: Removed obsolete macro.
1998-01-13 18:31:39 +00:00
b5dac4e02e
&do_cmd_kwindex: Removed obsolete function.
1998-01-13 18:30:31 +00:00
8362d005cf
Added command at end to use times fonts; commented out. Instructions to use
...
times are there as well.
Doing it here means the switch only affects one file and gets everything
rebuilt as needed.
1998-01-13 17:29:31 +00:00
95810e4d18
Removed tarps2, tardvi targets based on comments from Guido.
...
Added -9 option to gzip. This doesn't save much space, but it's "free" and
appreaciated by those with slow modems. (With these tarballs, that means
"those with modems"...!)
Remove the two tarballs in the clean target.
1998-01-13 17:18:57 +00:00
657cb148c3
After discussion with Guido, agreed to only support double-sided PostScript,
...
so we'll not need this shell whackery after all.
1998-01-13 16:57:13 +00:00
dca8792b52
Added openright option the the \documentclass{} for each of the manuals.
1998-01-13 16:53:23 +00:00
33d05b9d88
Added targets:
...
tarps - one-sided PostScript
tarps2 - two-sided PostScript, with ref.ps added as-is.
tardvi - yes, some people want the .dvi files
all-ps2 - Create the .ps files, but make sure the LaTeX openright option
is used in the \documentclass.
1998-01-13 16:33:09 +00:00
bc3b1c6fce
Script to add & remove LaTeX \documentclass options. Run "./texoption.sh"
...
for usage information.
1998-01-13 16:29:08 +00:00
ab0b65d0c9
&make_mod_index_entry: Wrap a long comment, store the additional data needed
...
to create a module index in the HTML version.
1998-01-13 04:05:11 +00:00
9b6f1d24f9
Override several functions from the stock latex2html to support the module
...
index. It works, it's ugly, and would probably have to be completely redone
if we changed latex2html versions. See the comments. ;-(
On the other hand, it works. ;-)
(Wait for myformat.perl checkin as well.)
1998-01-13 04:03:02 +00:00
1af9e79708
Added support for \funcline{} and \dataline{}.
...
For all generated cases of <strong>...</strong> (from this module), change to
<b>...</b>. This, from me? This is entirely to reduce the size of the
generated markup, which is more of an issue than semantics here. Since
<strong> isn't very meaningful anyway, this should be good.
1998-01-12 23:15:29 +00:00
023f87fbf8
Lots of minor markup nits, all consistency related.
...
Consistently use trailing "()" on function / method names.
Wrapped some long lines.
1998-01-12 19:16:24 +00:00
97546399c7
Document maxsplit arg for split(), with incompatibility note about 1.5
...
release bug.
Document groups() changed behaviour (now always returns tuple).
1998-01-12 18:58:53 +00:00
054f8fd12c
Wrapped some long lines.
...
Added trailing "()" for function and method names.
Added index entries for referenced modules.
1998-01-12 18:28:20 +00:00
74947ac473
Modify command descriptions to use \optional{} instead of ad-hoc markup.
...
There are still weirdnesses, but less of them.
1998-01-12 15:38:30 +00:00
6c886a8db1
\optional{}: Removed leading word space, allowing more flexibility.
...
{seealso} environment: Always start a new paragraph after the "See Also:"
line; this ensures that formatting is consistent for each subsequent
\see*{} item.
1998-01-12 14:44:33 +00:00
b2c45a8197
Sigh. Apply a similar patch to the *other* occurrence of [^...].
1998-01-12 05:49:05 +00:00
fd49a964bc
Follow current recommended practice in an example: Use isinstance() to
...
perform a type test instead of type(x) == types.FoobarType. In example
for type().
1998-01-11 21:15:23 +00:00
48022db400
"Unix" --> "\UNIX{}"
...
Added index references to referred-to modules.
Added seealso section pointing to the glob module.
Removed description of translate().
1998-01-11 19:06:37 +00:00
0cf785a7a7
Grammatical nit.
1998-01-09 22:37:52 +00:00
cf7e830869
Add module reference for cPickle to index.
...
Consistency: Always use trailing "()" for function and method names in text.
Consistency: Always mark parameter names with \var{} in text.
Change questionable text about CORBA to definate text about XDR; "CORBA" isn't
enough to specify an external representation, and I'm not sure the comment is
right if we say "IIOP". I know its right about XDR if we only mention shared
object references and not recursive structures.
1998-01-09 22:36:51 +00:00
12d9da5827
Use \file{} instead of \code{} or ``\code{}'' to mark file & directory names
...
& name parts.
1998-01-09 22:30:32 +00:00
8d0ff317bc
Simplify markup.
1998-01-09 22:27:55 +00:00
57b935d0d6
The resource module has been documented; remove from list.
1998-01-09 22:25:10 +00:00
bbe6068de0
Added \label{} to allow module references.
...
Added some seealso sections.
1998-01-09 22:24:14 +00:00
aa5dba026a
Add index entry for reference to the math module.
1998-01-09 21:30:03 +00:00
d327a8dddf
Typographical nits: Always set parameter names in \var{} in the running text.
1998-01-09 21:26:51 +00:00
6b3ed7f581
Markup consistency in the mapping object interface description.
1998-01-09 20:36:44 +00:00
0bf6845450
Fix previous nit to really do the right thing.
1998-01-09 16:26:54 +00:00
60a3d2788e
Consistency: Always use lower-case markup; one tag was still given in
...
uppercase. (Makes it easier to see what markup is generated by the
Python manual support and what is generated by standard latex2html.)
1998-01-09 14:39:41 +00:00
0fd8268189
Revise prologue and frontmatter to use latex2e (not in 2.09 compatibility
...
mode) and take advantage of changes in myformat.sty.
Change "C" to "\C{}" and "\code{NULL}" to "\NULL{}" everywhere for consistency
and control.
Started a description of PyArg_ParseTupleAndKeywords().
1998-01-09 05:39:38 +00:00
1f8449af4e
Revise prologue and frontmatter to use latex2e (not in 2.09 compatibility
...
mode) and take advantage of changes in myformat.sty.
1998-01-09 05:36:43 +00:00
031ad4b2a0
\mytableofcontents New macro. Wrapper around \tableofcontents that
...
does the right thing if the openright option is given. Allows a
lot of crud to be removed from the document files' frontmatter
sections.
\endabstract Extend standard macro. (Called as \end{abstract}.)
Does the right thing if the openright option is given.
\optional Adjust to get the brackets right under latex2e.
1998-01-09 05:34:23 +00:00
46fbd7f4a0
Nit.
1998-01-09 05:22:44 +00:00
3c3d7ce7fe
For consistency, always use a trailing "()" on function names in the running
...
text.
Add one index entry.
1998-01-08 04:00:30 +00:00
fcda560e81
Fix a typo (the word "a" was spelled "c"!).
...
Added index entries & \label{} constructs.
1998-01-07 22:05:25 +00:00
c9a32ab26b
Normalize some markup.
...
Use \file{} instead of \code{} for a directory name (Tools/freeze).
Consistently use "()" at the end of a function name in running text.
1998-01-07 18:57:01 +00:00
6279fccf4c
Fixed up index entries.
...
Adjusted one formatting problem (long \code{} in running text).
1998-01-07 13:23:32 +00:00
1566a1d72c
Added index entry for the protocol.
...
Fixed typo (extra char in the word "character").
Minor nits.
1998-01-07 13:17:20 +00:00
15bac5d6e4
Added index items for the RFC and the protocol itself.
1998-01-07 13:13:42 +00:00
799484399d
Fixed index entries to be more consistent.
1998-01-07 03:47:10 +00:00
c4586387f6
In description of \D, revise markup so that the caret shows up in the HTML
...
version as well as the dvi form. Without the fix, it showed up as an extra
zero character.
Bug reported by Hugh Sasse <hgs@dmu.ac.uk>.
1998-01-06 15:46:21 +00:00
85a5c52752
Descriptions for PyRun_String(), PyRun_File(), and PyRun_CompileString() all
...
gave the return type as part of the function field and used an empty return
type field. Fixed.
Function name field for PyLong_FromString() included an asterisk at the
beginning of the function name field; removed.
1998-01-02 03:24:19 +00:00
34252f99d6
lib.dvi target: Added commands to generate the modules index.
1998-01-02 03:01:47 +00:00
c1ce320a4f
Script to convert module index data to module index.
1998-01-02 03:00:27 +00:00
0b1337d674
Add module index before the general index.
1998-01-02 02:59:09 +00:00
da941ef27c
Added support for storing information to build a module index.
...
Enhance the "theindex" environment to add an entry to the table of contents.
1998-01-02 02:57:41 +00:00
875c807c92
In description of the group() method, fix markup of "\(" and "\)" literals;
...
"\code{\\(}" produces "(" in the .dvi file and "<BR> (" in the latex2html
output (the font was right). Changed to "\code{{\e}(}" variation, which
fixes both. Breaks the .texi file generation again. Oh well.
1998-01-02 02:50:13 +00:00
3884e7edf9
Apply fixps.py to allow A4 paper printing.
1997-12-30 23:49:49 +00:00
1f35977bfd
Added BaseHTTPServer to table of contents for chapter.
1997-12-30 23:42:27 +00:00
eb0f066fb8
Correct small nits reported by Rob Hooft.
1997-12-30 20:38:16 +00:00
ccd25d10c4
Final version for 1.5; two tiny corrections.
1997-12-30 18:35:35 +00:00
5793039dce
Clarify that __getinitargs__ is called at pickle time!
1997-12-30 17:44:48 +00:00
4f80b65aa6
Added "docs" for Pareto and Weibull distributions.
1997-12-30 17:38:05 +00:00
1c8b9e4769
Clean out *.texi and *.info* as well for "make clean".
1997-12-30 04:57:58 +00:00
7779619524
Add obsolescence note.
1997-12-30 04:54:47 +00:00
b1b8f23903
Add URL of Andrew Kuchling's nifty re conversion page...
1997-12-30 04:53:49 +00:00
8e94489882
Add a note that up to 1.4, translate() produced Emacs style syntax; in
...
1.5, it produces Perl style syntax. Also change "Python's regular
expressions" into plain "regular expression" in the intro.
1997-12-30 04:43:36 +00:00
e33e903461
Updated release date to match boilerplate.tex.
...
Removed implied future availability of an info/texi version of the other
manuals (the word "yet").
Guido, you might want to check this file to see if any other changes are
required.
1997-12-30 04:42:49 +00:00
5de1eb9b84
Added ConfigParser.py to list of undocumented miscellaneous useful utilities.
1997-12-30 04:41:56 +00:00
dccc298e3d
Took out some disclaiming text (even from the title!). Rewritten
...
abstract. Alas, I didn't get to do anything else before the release
:-(
1997-12-30 04:40:25 +00:00
5b8a523538
A whole bunch of typos fixed by Andrew Kuchling.
...
Added a warning about the incompleteness to the front.
Added a reminder about CObject to the back.
1997-12-30 04:38:44 +00:00
5b943ca1a9
Set the release date for 1.5 (final).
1997-12-30 04:29:30 +00:00
13704a8928
Added .PHONY annotation for lib.info target; the real target is
...
python-lib.info. The annotation is needed to prevent at least GNU make from
building a second set of info files with the lib.info base name.
1997-12-29 22:04:44 +00:00
e66e9c5562
Remove more commented-out text that is no longer needed.
1997-12-29 21:43:04 +00:00
29d3b9368c
Remove the commented-out warning at the top. It shouldn't be there
...
for the 1.5 release version of the file.
1997-12-29 21:42:03 +00:00
43c9350f7a
Getting uglier. But it doesn't completely bomb except for some table stuff.
...
I'll get to it when I can.
1997-12-29 21:40:35 +00:00
78f8e98232
Lots of minor nits that allow this file to get processed without failures by
...
the info generation phases. Most of the errors had occurred in the makeinfo
step.
Commented out the warning at the top; this should still really be removed
before 1.5, but that's not my call. It generated problems for the info
conversion as well.
1997-12-29 21:39:39 +00:00
6810a29c64
Ignore generated info files.
1997-12-29 21:37:21 +00:00
a007c13094
Reduce warning count from partparse.py.
...
Removed BaseHTTPServer.py from list of undocumented modules.
1997-12-29 21:32:26 +00:00
3d913ad370
Revised lib1.texi target to deal with some conversion nastiness. See comment.
1997-12-29 21:31:23 +00:00
1b6cf78c15
Reduce warning count from partparse.py.
1997-12-29 20:28:33 +00:00
588f38ec2a
Ignore another intermediate file from the info generation.
1997-12-29 20:03:46 +00:00
d7feffdd5f
Reduce warning count from partparse.py.
1997-12-29 20:02:55 +00:00
9cb64803aa
Added Greg Stein's docs for BaseHTTPServer.py.
...
Moved docs for "re" to before docs for "regex".
1997-12-29 20:01:55 +00:00
b0744c5a28
Make "{" and "}" in code sample visible instead of a group (it's supposed to
...
be a dictionary...).
1997-12-29 19:59:38 +00:00
bef9b0b039
Added missing "\" to "\var{address}, var{length}" in buffer_info() description.
1997-12-29 19:33:45 +00:00
6884e3b94b
Reduce warning count from partparse.py.
1997-12-29 19:09:37 +00:00
c416445d7e
Use tableii environment for the table instead of tabular. This makes it
...
consistent with other 2-column tables in the Python documentation.
1997-12-29 19:02:01 +00:00
671fe9dd31
Reduce warning count from partparse.py.
1997-12-29 18:53:31 +00:00
a3e672b574
Nit adjustments to remove warnings when processed with partparse.py.
1997-12-29 18:21:37 +00:00
f0867315e9
Normalized the word "Unix" to "\UNIX{}".
...
Changed "{\tt crypt}" to "\sectcode{crypt}" in section heading.
1997-12-29 17:31:22 +00:00
a4541af0ba
A bunch of minor stuff.
...
Lots of support for new macros defined in myformat.sty; including the new
indexing macros, seealso environment & friends, and the byte code instruction
support.
1997-12-29 17:19:22 +00:00
05dd3c09ab
Added back info generation. Still buggy in the final phase (makeinfo run).
...
Does not conflict with any other targets.
1997-12-29 17:17:54 +00:00
cc97454987
Added missing "\" to "var{P}.\var{M}" in load_module() description.
1997-12-29 17:16:24 +00:00
f3e6df1e2d
Remove unneeded "{}" that confused makeinfo.
1997-12-29 17:11:55 +00:00
6ccaaf1a08
Change name of temporary file to avoid possible filesystem issues; matches
...
similar renaming of the @buildno file elsewhere in the Python tree.
1997-12-29 16:58:46 +00:00
1656d17c42
Changed all \verb\...\ markup to either \code{...} or \samp{...}.
1997-12-29 16:55:50 +00:00
2cd0b9b1ba
Removed "-*-texinfo-*-" from first line; this can cause emacs/xemacs to stop
...
and ask the user for permission to set buffer-local variables depending on
the user's configuration. Not really needed since this doesn't get edited
often.
Bumped the version number to 1.5; date still needs to be set.
1997-12-29 16:54:11 +00:00
f9951818a6
Normalized the \seetext markup to match the only other instance: should be
...
"\seetext{...}" instead of "\seetext ...".
1997-12-29 16:37:04 +00:00
45c9df6636
Changed some \verb\...\ markup to the more common \code{...}. \verb\...\ is
...
rarely needed and should be avoided where possible since it doesn't behave
well with some processing tools (like partparse.py).
1997-12-29 15:55:10 +00:00
0ee358529e
do_env_tableii(), do_env_tableiii(): Align the table in the center, just
...
like LaTeX does. There's no need to diverge on this.
1997-12-28 03:41:07 +00:00
dd79bd3539
Checking in fixed PS, with A4 capability.
1997-12-24 18:32:36 +00:00
b9973d9060
Script to edit one line in the PS to allow A4 printing.
1997-12-24 18:31:53 +00:00
7f96291ee2
Convert a couple of three-column tables with an empty third column to
...
two-column tables. This improves the rendering of the HTML version on
(at least) some browsers.
1997-12-23 04:21:20 +00:00
d665e8b5b0
Removed unnecessary \small{} block; latex2html got it wrong and its no
...
longer needed for printed output.
1997-12-23 04:10:35 +00:00
d21759ba47
Removed unnecessary \small{} block; latex2html got it wrong and its no
...
longer needed for printed output.
1997-12-23 04:03:26 +00:00
0148bbf966
AMK's latest
1997-12-22 22:41:40 +00:00
9597daf220
do_env_tableii(), do_cmd_lineii(),
...
do_env_tableiii(), do_cmd_lineiii(): New functions to handle tableii and
tableiii environments.
Small changes to not add a superfluous space between a function name and the
comma in the index.
1997-12-22 22:37:34 +00:00
e903aab833
Replace unprotected tilders by \~ -- an unprotected tilde is a
...
non-breaking space!
1997-12-18 16:28:56 +00:00
b2c6ef83f4
Change {\em ...} to \emph{...}; this seems to be the developing preference
...
throughout the manuals, and seems easier to read.
1997-12-18 15:56:05 +00:00
616b23b2e4
img_tag(), top_navigation_panel(): Generate markup the same case as other
...
functions in this file.
1997-12-18 14:16:46 +00:00
8da9e6a8a0
make_mod_index_entry(): Generate markup the same case as other functions in
...
this file.
1997-12-18 14:14:16 +00:00
304474f315
Make the word "Module" in the section header start with an upper-case "M".
...
Include "()" when naming functions in the text.
Fixed reference to the built-in str() function.
Format constant names using \code{}.
1997-12-17 15:30:07 +00:00
20417b7afb
Make the word "Module" in the section header start with an upper-case "M".
...
Added index entry for RFC 1014.
1997-12-17 14:17:35 +00:00
b78da332fa
Make the word "Module" in the section header start with an upper-case "M"
...
for all three modules described here.
Added a \label{} for each of the two modules missing it.
1997-12-17 14:12:31 +00:00
a47bce54a6
Make the word "Module" in the section header start with an upper-case "M".
...
Added a \label{} for the module.
Fixed one minor grammatical nit: use plural pronoun to refer to a pair of
referents.
Include "()" when naming functions in the text.
1997-12-17 14:11:18 +00:00
9c483191d6
Make the word "Module" in the section header start with an upper-case "M".
1997-12-17 14:08:01 +00:00
2303d31cc0
Make the word "Module" in the section header start with an upper-case "M".
...
Added a \label{} for the module.
Changed one \code{} to a \samp{}.
1997-12-17 14:07:25 +00:00
bcda484bc4
Make the word "Module" in the section header start with an upper-case "M".
1997-12-17 14:01:52 +00:00
36499b8e62
Make the word "Module" in the section header start with an upper-case "M"
...
for both modules documented here.
1997-12-17 14:01:31 +00:00
14f8521952
Make the word "Module" in the section header start with an upper-case "M".
1997-12-17 13:52:04 +00:00
7372e5793d
Make the word "Module" in the section header start with an upper-case "M".
...
Minor grammatical nit.
1997-12-17 13:51:08 +00:00
045c7fc9b9
Make the word "Module" in the section header start with an upper-case "M".
...
Remove the leading comment declaring this to be a template for module
documentation.
1997-12-17 13:47:39 +00:00
6f070108df
Make the word "Module" in the section header start with an upper-case "M"
...
for both modules documented here.
1997-12-17 13:45:50 +00:00
dccd9dbf52
Make the word "Module" in the section header start with an upper-case "M"
...
for both built-in and standard modules. They were different.
1997-12-17 13:44:37 +00:00
819b789f36
gen_index_id(): New function. Construct an index key such that the sort
...
is stable and the form is only defined in one place, since we do
some fancy footwork with the keys to separate the defining instance
of a module reference from other references in the HTML index.
make_index_entry(): Override the standard definition to use get_index_id().
make_str_index_entry(): Moved to myformat.perl; only needed there.
index_key_eq(): Override the standard definition. Add key transforms to
remove extra junk from the end of the keys; it was only there to
maintain ordering.
clean_key(): Remove key transform no longer needed at this stage, because
keeping it makes the sort unstable.
add_idx(): Add key transforms to undo the mess we do to separate a module's
defining and reference entries. Don't make the text bold.
1997-12-17 03:08:27 +00:00
84818d7aad
make_mod_index_entry(): New function. Create the index entry for a module.
...
my_module_index_helper(): Do the actual work for \*modindex{}, including
both the defining and reference forms.
make_str_index_entry(): Moved from .latex2html-init; it's really specific
to the presentation.
1997-12-17 02:59:39 +00:00
e4eb2231fd
AMK's latest
1997-12-17 00:23:39 +00:00
72df9bcba2
do_cmd_refbimodindex(), do_cmd_refstmodindex(): New functions, handle the
...
reference form of \bimodindex{} and \stmodindex{}.
my_parword_index_helper(): Fixed to include proper anchor in result text.
1997-12-16 21:13:20 +00:00
5ca9033062
Index the RFC822 reference (some other RFC references were alreaddy indexed).
...
Add index reference to mailbox module; also remove comment that it's
undocumented (it has been).
1997-12-16 15:19:47 +00:00
8e0799817e
The \indexsubitem definition for the actual exceptions did not actually
...
change the \indexsubitem value; fixed.
1997-12-16 14:54:32 +00:00
9d2f7d414d
Oops, ".pythonrc.py" should *always* be marked with \file{}; one occurrance
...
escaped with \var{}.
1997-12-16 14:43:37 +00:00
5493205ba4
Module names should be in \code{}.
...
Added index reference to site module.
1997-12-16 14:41:36 +00:00
0514ce126a
Descriptions for delitem(), __delitem__(): These delete a value, not set it.
...
Lots of little nits: parameter names in text should be \var{}, etc.
1997-12-16 14:29:48 +00:00
4f496cc5b1
Fixed index module reference.
1997-12-16 04:08:24 +00:00
90f2e5e202
Added a named target for referencing.
1997-12-16 04:06:33 +00:00
bfc28bcfdf
Used a named target to form the reference to the Built-in Functions section.
1997-12-16 04:06:06 +00:00
6d2bdb682d
Fixed index module reference.
...
Changed references to regex/regsub modules to point to re.
1997-12-16 04:04:25 +00:00
3aa289537c
Fixed index references to modules. (This is *not* the spam module!)
1997-12-16 00:02:01 +00:00
e14388c4b8
Fixed index references to modules.
1997-12-15 22:28:38 +00:00
19d58273c5
Fixed index references to modules.
...
Made references to files use \file{} instead of \code{}.
1997-12-15 22:23:52 +00:00
356818eccb
Fixed index references to modules.
1997-12-15 22:20:33 +00:00
8274f32a6d
Fixed index references to modules.
...
Changed regex reference to re.
1997-12-15 22:19:46 +00:00
f5eaa2efb8
Fixed index references to modules.
...
Added new index entry for mimetools module.
1997-12-15 22:13:50 +00:00
a51f5a48e5
Fixed index references to modules.
1997-12-15 22:09:42 +00:00
4af1814858
\refmodindex{}: New macro, used to make an index reference to a module which
...
is neither standard nor built-in. (Used for sitecustomize entry.)
1997-12-15 22:08:14 +00:00
9ab2b2ec5b
Fixed index references to modules.
...
Placed references closer to usage.
1997-12-15 21:59:33 +00:00
Fred Drake
Guido van Rossum
Jeremy Hylton