Commit Graph

7292 Commits

Author SHA1 Message Date
Fred Drake 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
Guido van Rossum 0980bd9233 Add case checking feature on import.
This is an option for OS-es with case-insensitive but case-preserving
filesystems.  It is currently supported for Win32 and MacOS.  To
enable it, #define CHECK_IMPORT_CASE in your platform specific
config.h.  It is enabled by default on those systems where it is
supported.  On Win32, it can be disabled at runtime by setting the
environment variable PYTHONCASEOK (to any value).

When enabled, the feature checks that the case of the requested module
name matches that of the filename found in the filesystem, and raises
a NameError exception when they don't match.
1998-02-13 17:18:36 +00:00
Fred Drake 4c6896304b Fix weirdness with single-page table of contents, reported by Guido. 1998-02-13 16:58:49 +00:00
Guido van Rossum e60142f2c1 Adding output of test_xmllib.py 1998-02-13 16:35:21 +00:00
Fred Drake 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
Fred Drake fb74a463ad Add "Pretty Good Privacy" as well as "PGP" to the index. 1998-02-13 14:52:17 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake 2a4646c660 Remove obsolete pagenumbering / pagestyle cruft. 1998-02-13 07:08:56 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake fe82acc3b1 Fixed typo in docstring: "__ version__" --> "__version__" 1998-02-13 03:24:48 +00:00
Fred Drake 6eab2fb0f1 Clean up some of the definitions related to info generation. 1998-02-13 03:23:33 +00:00
Guido van Rossum 8a666e7c56 Fix a horrible race condition -- various routines were storing the
most recently opened URL in self.openedurl of the URLopener instance.
This doesn't really work if multiple threads share the same opener
instance!

Fix: openedurl was actually simply the type prefix (e.g. "http:")
followed by the rest of the URL; since the rest of the URL is
available and the type is effectively determined by where you are in
the code, I can reconstruct the full URL easily, e.g. "http:" + url.
1998-02-13 01:39:16 +00:00
Fred Drake e5bc49785c "ASCII" --> "\ASCII{}" 1998-02-12 23:36:49 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake f44617d298 For sections describing the "Foo Protocol", consistently use the capitalized
"Protocol" and not "protocol".
1998-02-12 20:57:15 +00:00
Fred Drake faa1afe2d7 Py_Exit(status) calls exit(status), not exit(0). 1998-02-12 20:51:02 +00:00
Barry Warsaw f7e4793660 fixed initial color 1998-02-12 19:53:01 +00:00
Barry Warsaw 4b0d67d592 typo 1998-02-12 19:52:46 +00:00
Barry Warsaw 29fe4ddd20 Added color strip widgets 1998-02-12 19:52:31 +00:00
Barry Warsaw 9d882bc4de Initial revision 1998-02-12 19:51:57 +00:00
Barry Warsaw f64b4054af (py-compute-indentation): Several changes made to improve navigation
over and around triple-quoted strings:

    - move the beginning-of-line to above the p-p-s call

    - in the `t' clause of the big cond, where we skip over
      triple-quoted strings, first find out if we're looking at a
      single or TQS, then skip over it in one fell swoop, instead of
      trying to loop over skipage of SQS's.

(py-parse-state): Implement XEmacs only hack to more accurately figure
out whether we're in a string or not.  Can't do this in Emacs because
it lacks the necessary primitive, so we just do it the old (and mostly
accurate, but foolable) way for Emacs.
1998-02-12 16:52:14 +00:00
Guido van Rossum da62398139 Correct description of BUILD_SLICE. 1998-02-12 03:53:02 +00:00
Fred Drake 63221124c0 Comment out the times package in the distributed version. 1998-02-12 03:48:50 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake 71c1ef34bf Remove second index entry for UserList. 1998-02-12 03:10:55 +00:00
Fred Drake 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
Fred Drake 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
Guido van Rossum 692b87db15 Added \nodename; added index entry for UserList. 1998-02-11 23:00:08 +00:00
Guido van Rossum f6a7b443c2 Added entries for stat, commands modules. 1998-02-11 22:58:55 +00:00
Guido van Rossum 6d659b3e51 Added entries for re, soundex modules. 1998-02-11 22:57:10 +00:00
Guido van Rossum 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
Guido van Rossum f5370f4019 Turn the space in [\^ ...] into a hard space: [\^\ ...]. 1998-02-11 22:52:47 +00:00
Guido van Rossum 1c974db134 Split UserDict and UserList on two separate lines; added entries for
modules symbol and token.
1998-02-11 22:36:17 +00:00
Guido van Rossum ee833cca7b Don't break a long line at an unpleasant point. 1998-02-11 22:34:51 +00:00
Guido van Rossum 8b0927eddc Added missing entry for cmath. 1998-02-11 22:33:57 +00:00
Guido van Rossum c57aff20e3 Replace $math$ with \code{}. 1998-02-11 22:33:28 +00:00
Guido van Rossum c4452fd08f Swap ni and imp (so they are in the same order as their sections are). 1998-02-11 22:32:23 +00:00
Guido van Rossum 34122fa99c Remove a spurious space from the title. 1998-02-11 22:31:54 +00:00
Fred Drake ed68854b40 "lists objects" --> "list objects" (Section "More on Lists".) 1998-02-11 22:29:17 +00:00
Fred Drake 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