Commit graph

2831 commits

Author SHA1 Message Date
Fred Drake
802a202d0d Logical markup.
Changed {funcdesc} to {classdesc}.  This is a test case for {classdesc}.
1998-02-19 06:26:35 +00:00
Fred Drake
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
Fred Drake
c02fbe52b2 breakable_re: Fix the RE so that module definition entries don't prevent
combining.
1998-02-19 06:05:29 +00:00
Guido van Rossum
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
Fred Drake
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
	"&#160;"'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
Guido van Rossum
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
Fred Drake
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
Fred Drake
8ff4b8b05b Add new files from the Mac user interface breakup. 1998-02-18 17:19:53 +00:00
Fred Drake
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
Jeremy Hylton
9caa110141 assure a consistent assignment for nodes with multiple labels 1998-02-18 16:10:22 +00:00
Fred Drake
b866020f66 Added a number of items.... 1998-02-18 16:03:43 +00:00
Fred Drake
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
Fred Drake
b0df567897 Separate the parse, symbol, and token documentation into separate files. 1998-02-18 15:59:13 +00:00
Fred Drake
710c035c05 Added \label{} for logical addressing. 1998-02-18 15:47:17 +00:00
Fred Drake
31ecd50d02 Added \label{} for logical addressing. 1998-02-18 15:40:11 +00:00
Fred Drake
af0bfbee46 Added \label{} for logical addressing.
Logical markup.
1998-02-18 15:39:15 +00:00
Fred Drake
1f3ab1cb6c Added \label{} for logical addressing. 1998-02-18 15:22:08 +00:00
Fred Drake
55fca54ebb Added \label{} for logical addressing.
Logical markup.
1998-02-18 15:21:26 +00:00
Fred Drake
12918af83e Added \label{} for logical addressing. 1998-02-18 15:10:24 +00:00
Fred Drake
ddf03bf8e1 Added \label{} for logical addressing.
Logical markup.
1998-02-18 15:05:47 +00:00
Fred Drake
9acafa8bb5 Don't make backups.
Use "mv" instead of "ln -s" to install the new names.
1998-02-18 14:52:24 +00:00
Fred Drake
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
Guido van Rossum
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
Jeremy Hylton
daa2d5d4ea Patch HREFs in html files, replacing nodeXXX.html with label.html. 1998-02-18 13:53:48 +00:00
Guido van Rossum
8cf94e608e Add mktime_tz(). Add () to a function reference in parsedate_tz(). 1998-02-18 05:09:14 +00:00
Fred Drake
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
Fred Drake
45a40930e7 &do_cmd_textohtmlmoduleindex: Get the modindex key added to the label->node
association.
1998-02-17 23:11:40 +00:00
Fred Drake
57b5e42c0c Added \label{} for logical addressing. 1998-02-17 22:30:13 +00:00
Fred Drake
e2f194b57d Use \manpage{} markup for referencing a UNIX man page.
Added index entry for DES cipher.
1998-02-17 22:24:45 +00:00
Fred Drake
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
Fred Drake
326e19700f Remove Macintosh ligatures item. Solution: Update your Times fonts.
Added native package semantics note.
1998-02-17 20:14:12 +00:00
Fred Drake
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
Fred Drake
5fd242b085 Clarified comment about the PS generation when using the all-pdf target. 1998-02-17 18:20:30 +00:00
Fred Drake
30d17825ac Add magic to make PDF generation use maximal compression. 1998-02-17 15:56:55 +00:00
Fred Drake
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
Fred Drake
5c4e648731 Updated date for interim documentation release. 1998-02-17 15:41:45 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
7154d382c3 Update indexsubitem for file attributes correctly. 1998-02-17 02:11:21 +00:00
Fred Drake
a200faac55 \nodename{} must appear immediately after \section{} for the info conversion. 1998-02-17 02:10:41 +00:00
Fred Drake
06e1664c77 Indent {verbatim} environments like in the printed version. 1998-02-16 22:50:06 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
75fc045bf5 Fixed formatting of the program name for crypt.
Added another index entry.
1998-02-16 21:36:57 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
7506298dfb Mark up filename extensions consistently.
Logical markup.
1998-02-16 20:40:37 +00:00
Fred Drake
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