Commit Graph

1963 Commits

Author SHA1 Message Date
Guido van Rossum a096a2e6a2 Warn that AddModule doesn't import the module. 1998-11-02 17:02:42 +00:00
Fred Drake 9ed1a0afb9 Moved zmod and poly descriptions to the Obsolete section. 1998-11-02 15:46:21 +00:00
Barry Warsaw 4a1cdd7f22 Document the new features of this module 1998-10-31 23:19:00 +00:00
Fred Drake 130072d663 Don't describe something as "below"; that won't make sense for the
HTML version.  Give a reference to the actual section to allow a
hyperlink to be built.
1998-10-28 20:08:35 +00:00
Fred Drake c024c99faf Fix typo reported by Gerry Weiner <gerry@ucar.edu>. 1998-10-28 18:19:16 +00:00
Andrew M. Kuchling c1cea208bc Added URL to HOWTO page, with reference to Regex HOWTO.
Corrected error: {,5} is not equivalent to {0,5}.
1998-10-28 15:44:14 +00:00
Fred Drake 566b6d5b59 Support the use of bibtex. This is transparent to the user.
Switch from bash to ksh, in the hope that more systems support it (one
report of a site without an available bash).
1998-10-27 21:59:03 +00:00
Guido van Rossum 04101960e6 Indicate that os.environ may not be a real dictionary. 1998-10-24 20:16:56 +00:00
Guido van Rossum c62cf36e76 The last two example functions in the section about default argument
values (4.7.1) should return l, not a.  Reported by Axel Boldt.
1998-10-24 13:15:28 +00:00
Fred Drake 803b340888 Update the date. 1998-10-21 14:50:52 +00:00
Fred Drake a76b63c4f4 Bump the release to 1.5.2a2. 1998-10-21 14:49:48 +00:00
Fred Drake d29cf379b9 Added --tools option, to package only the framework (no documents). 1998-10-21 14:26:26 +00:00
Fred Drake 9beee80fd7 Remove a couple of unnecessary "%" characters that cause problems with
the latest latex2html beta.
1998-10-21 00:44:49 +00:00
Fred Drake dad11321eb Remove a bunch of unnecessary "%" characters that cause problems with
the latest latex2html beta.
1998-10-21 00:26:56 +00:00
Fred Drake 3041b0715b Remove an unnecessary "%" character that seems to cause a minor glitch
with the latest latex2html.
1998-10-21 00:25:32 +00:00
Fred Drake 28e7b4cce1 add_link(): Fix to use $section_info instead of $toc_section_info,
based on email from Ross Moore <ross@mpce.mq.edu.au>.

Set $HTML_VERSION to 4.0, since that's what we really generate (well,
4.0 "transitional").
1998-10-20 18:14:20 +00:00
Fred Drake fbddddee49 Reflect new name of index style file. 1998-10-19 21:48:05 +00:00
Fred Drake 7f77db9530 Renamed myindex.ist to something more reasonable. 1998-10-19 21:45:52 +00:00
Fred Drake 9dcc9f7764 No longer needed since we have nice, contributed navigation buttons. 1998-10-19 21:40:45 +00:00
Fred Drake a5de730d2d If building HTML and the icons should be served from the same
directory as the HTML (--iconserver .), copy the icons into place.

Clarify that lynx is needed for --text in the usage message.

Fix a typo in a comment.
1998-10-19 19:14:42 +00:00
Fred Drake 649e8c1f7f ArabictoRoman(): Removed, since it wasn't used anywhere. 1998-10-19 16:33:06 +00:00
Guido van Rossum 18fa7d2800 Typo: JIFF -> JFIF. 1998-10-19 13:30:01 +00:00
Guido van Rossum 0a0f11b6d4 PyMapping_SetItemString() returns int, not an object. 1998-10-16 17:43:53 +00:00
Fred Drake b521095952 In build_html(), strip off leading "./" from filename, added by
kpsewhich.  This caused a problem with the latest latex2html beta.
1998-10-16 17:34:34 +00:00
Guido van Rossum f35b884c91 Clarify that close() of a stream opened by popen() returns None if the
exit status is zero.
1998-10-15 13:28:29 +00:00
Guido van Rossum 7d447aabbf Moved search and match around so that search is documented first. 1998-10-13 16:03:52 +00:00
Barry Warsaw afd974c2ab Document the new list.extend() method. Interesting enough, the
canonical definition of extend() is very similar to append() except
that the former doesn't list-ify the argument!
1998-10-09 16:39:58 +00:00
Fred Drake 2e23c3125a Make the dependencies really work for the HTML version. 1998-10-07 22:03:45 +00:00
Fred Drake 437ff8600a Change the default split level to not split on marked \paragraph and
\subparagraph sections.  Indicate the default in the --help message.
1998-10-07 16:46:54 +00:00
Fred Drake b0b1900198 If --debug was used, don't delete the temporary .perl file used to
pass options to latex2html.
1998-10-07 16:41:40 +00:00
Fred Drake 8c1e114d1a Don't attempt to add paragraph and subparagraph sections to the PDF
outline.

Work around font-long bogosity caused by ' in docstring.
1998-10-07 14:12:20 +00:00
Fred Drake 09b295754f Remove extra } at end of method description parameters. 1998-10-01 20:43:13 +00:00
Fred Drake c456d36bde Fix encoding of \ in some string literals in the discussion of "raw"
strings.  Reported by Lorenzo M. Catucci <lorenzo@argon.roma2.infn.it>.
1998-10-01 20:41:57 +00:00
Fred Drake 82385872e9 Fix some confusion in the __repr__() and __str__() descriptions.
Reported by Lorenzo M. Catucci <lorenzo@argon.roma2.infn.it>.
1998-10-01 20:40:43 +00:00
Fred Drake d4c3352288 Fix encoding of \n in a couple of places (reported by Lorenzo
M. Catucci <lorenzo@argon.roma2.infn.it>).
1998-10-01 20:39:47 +00:00
Barry Warsaw b2031f72d3 Document that apply() can now take any sequence in argument 2. 1998-10-01 15:35:43 +00:00
Guido van Rossum 9814a943a5 Add warning that on Windows it only works on sockets. 1998-09-28 14:28:38 +00:00
Guido van Rossum 954b9adcd2 Document new urllib features by Eric Raymond. 1998-09-28 14:08:29 +00:00
Fred Drake f4cbb9c7fa Added realclean and distclean targets to match ../Makefile. 1998-09-23 17:37:14 +00:00
Guido van Rossum 5fb2631ff9 Explicitly document the fact that the search method returns a MatchObject.
(Reported by Gary Herron.)
1998-09-21 19:26:16 +00:00
Guido van Rossum 6ac06b39b3 Patch by Greg Stein to document the 'P' flag. 1998-09-21 14:44:34 +00:00
Fred Drake 10a7985565 re.findall(): Mark as added in 1.5.2. 1998-09-18 17:11:49 +00:00
Guido van Rossum 43b655c0ab Get rid of 'ppp' that accidentally crept in. 1998-09-17 17:07:15 +00:00
Guido van Rossum 6442116029 Richard Wolff's changes, documenting his changes to pdb.py. 1998-09-17 15:11:51 +00:00
Fred Drake b7833d3c0c Add a \label to the section "Fancier Output Formatting" (it's referenced from
the KOE docs).

Some markup nits.
1998-09-11 16:21:55 +00:00
Fred Drake d16d4981d1 Markup nits. 1998-09-10 20:21:00 +00:00
Fred Drake d64a40dbc0 do_cmd_methodlineni(): New function, needed because the ref. manual now
actually uses this markup.
1998-09-10 18:59:13 +00:00
Fred Drake 9b134bf716 Added comment about support for rational numbers, and pointer to
Demos/classes/Rat.py.
1998-09-10 18:42:55 +00:00
Fred Drake 7a2f0668e4 Markup nits.
Fixes/index improvements from Michael Ernst <mernst@cs.washington.edu>.
1998-09-10 18:25:58 +00:00
Fred Drake 3494e4a31f Fix typo in URL; reported by Michael Ernst <mernst@cs.washington.edu>. 1998-09-10 17:55:32 +00:00
Fred Drake f9acc59c55 \itembreak,
\itemjoin:  Remove obsolete macros.

\itemnewline:  Rename to \py@itemnewline, since it's only used internally.
1998-09-09 15:27:43 +00:00
Fred Drake 525d7024ab Ignore the generated README file. 1998-08-28 21:34:50 +00:00
Fred Drake 2335a305e5 When building the tarball of the PostScript files, also generate & include a
little README giving the page count of each file when printed.
1998-08-28 21:17:58 +00:00
Fred Drake 7c86c594ea Target to generate a little README file with the page counts of the PostScript
files.
1998-08-28 21:17:07 +00:00
Fred Drake 47f69067d5 Script to generate page counts of the PostScript files. 1998-08-28 21:16:28 +00:00
Fred Drake e1feb8f2dc Support long options that take arguments of the form --option=value as well
as --option value.

Minor nits cleaned up.
1998-08-28 20:21:04 +00:00
Fred Drake d82575d5bf Markup changes in the section on disciplines to match method descriptions
a little better, and produce better HTML.

Add some index entries.
1998-08-28 20:03:12 +00:00
Guido van Rossum f5a80a4a88 Describe what happens when ``raise C, x'' is called where C is a class
and x is not an instance of C (nor of a class derived of C).
1998-08-25 14:45:41 +00:00
Guido van Rossum dbf7956e52 Clarify Y2K behavior when a tuple with a 2-digit date is passed to
mktime() and such.
1998-08-25 14:44:49 +00:00
Fred Drake 607f802886 round(): Mark the second (optional) parameter as optional, since it's
described that way.

setattr():  Clarify that the attribute doesn't need to exist to be set.
1998-08-24 20:30:07 +00:00
Fred Drake c859350fa6 Added some cross-references to the end. 1998-08-24 18:46:14 +00:00
Fred Drake d0421dd448 spoking --> speaking
object whose method this is --> object on which the method operates
1998-08-24 17:57:20 +00:00
Fred Drake 637af13dca There is no <ISINPUT> element, just <ISINDEX>. ;-) 1998-08-21 20:02:06 +00:00
Andrew M. Kuchling 42db27fedc Added an example that uses signal.alarm() to time out an os.open() that
takes too long. This example relies on the fact that raising an
    exception in a signal handler causes the exception to be re-raised
    when the main line of the program resumes execution.  Is this guaranteed
    in CPython, or is this something that just happens to work by accident?

Also fixed a typo.
1998-08-18 19:38:54 +00:00
Fred Drake 664dcd5b5e Clean up the HTML a bit; update the version number. 1998-08-17 14:11:00 +00:00
Fred Drake e7210dad6c Fix arguments for renames(); bug spotted by Oliver Andrich
<oli@rhein-zeitung.de>.
1998-08-17 13:29:06 +00:00
Fred Drake a5aefbad5a Fix markup where C include files get named in <...> form; bug reported by
Lorenzo M. Catucci <lorenzo@argon.roma2.infn.it>.
1998-08-14 17:05:17 +00:00
Fred Drake a0e4b78233 img_tag(): For \n to be interpreted as a newline, the string must use double
quote, not single quotes.  Ugh.
1998-08-14 15:03:48 +00:00
Andrew M. Kuchling d22e25002a Clarify wording in the description of re.split
Simplify the patterns in the examples for re.split
1998-08-14 14:49:20 +00:00
Fred Drake 7cfca6de2b Don't need these anymore.... 1998-08-13 22:05:09 +00:00
Fred Drake 062bc6e598 Do the magic to use the new buttons (with shorter names!) instead of the old
ones.  Get the <IMG> width & height right.  New design for the navigation
bars, including the document title as well as the navigation links/buttons.
1998-08-13 22:03:46 +00:00
Fred Drake 54c52052ce Add l2hinit.perl to COMMONPERL. 1998-08-13 19:03:19 +00:00
Fred Drake 564e444a7c New icons from Christopher Petrilli <petrilli@dworkin.amber.org>.
Cool!
1998-08-13 18:32:35 +00:00
Guido van Rossum 3a5a02f3da Second definition of popen2 should be popen3. 1998-08-13 01:27:01 +00:00
Fred Drake 9f6f0da084 Improved some error messages for command line processing.
Added --all to produce all formats at once.
1998-08-12 18:07:51 +00:00
Fred Drake 00c468b0c5 Added more informaton about the mkhowto.sh script. 1998-08-12 17:53:46 +00:00
Fred Drake 78b8c3d0d6 Oops, the --text option wasn't documented! 1998-08-12 17:52:16 +00:00
Fred Drake c794c38187 Added a comment about not using a symbolic link to access the script. 1998-08-12 17:50:07 +00:00
Fred Drake 697c1c7325 Some minor updates. 1998-08-12 17:13:28 +00:00
Fred Drake eb7fe4f5a1 Massive cleanup: Use Makefiles in subdirs properly, move most of the
detailed build rules to the subdirs.  Allow pretty much every useful target
to be built directly from the top dir (no change in output location).
1998-08-12 17:08:37 +00:00
Fred Drake 07b12f2497 Re-written to actually perform the conversion instead of using a sub-make
with the parent Makefile.  Will also force the auxillary files to be
created if they need to be.
1998-08-12 17:06:03 +00:00
Fred Drake 3069c976cf Update date & version number for release 1.5.2a1. 1998-08-12 17:02:50 +00:00
Fred Drake 06098e45af New Makefile; includes ../paper-letter/Makefile and sets PAPER=a4. 1998-08-12 17:01:27 +00:00
Fred Drake d48d62cabd New Makefile, contains rules for building typeset versions. 1998-08-12 17:00:24 +00:00
Fred Drake 3d865424a7 New makefile which only contains the source dependencies specific to each
document.  The main Makefile will only contain rules and "system" dependencies.
1998-08-12 16:16:49 +00:00
Fred Drake 370f3c9eb6 Bump RELEASE to 1.5.2a1. 1998-08-11 19:38:00 +00:00
Fred Drake f832f4cd34 Clean things up just a bit. 1998-08-11 19:36:35 +00:00
Fred Drake 15c417eb77 Helper script used in creating navigation buttons. 1998-08-11 19:35:03 +00:00
Fred Drake 9f7adc4f22 Get the <IMG> sizes right for the navigation buttons. 1998-08-11 19:33:38 +00:00
Fred Drake a69ada66d0 Ok, blank.pbm is free to go.
The rest of these are new or replaced.  The buttons are now all the same
width.  They have the transparency set right.  They still need the attention
of a designer.  But they work, and we have a real button for the Modules
Index.
1998-08-11 18:52:33 +00:00
Fred Drake 1b9b210abf I think this is the last of them. 1998-08-11 18:50:04 +00:00
Fred Drake 7aac918029 Gosh, there's a lot of them.... 1998-08-11 18:47:26 +00:00
Fred Drake 704be95237 More files never used here..... 1998-08-11 18:42:30 +00:00
Fred Drake e528458155 Icons only needed if using the change control marks, which are bogus. 1998-08-11 18:40:03 +00:00
Fred Drake c83d7cac07 Remove files we never used; l2h would only use these if you use the
special "html" package, which we don't and won't.
1998-08-11 18:31:35 +00:00
Fred Drake af06a0b4ee Use Perl's rename() function instead of system(); there's no need for two
additional processes for each name change!
1998-08-11 18:17:47 +00:00
Fred Drake 211f22c1b1 Added the test package under "Frameworks". 1998-08-11 18:13:31 +00:00
Fred Drake ee9306b610 Template file for \documentclass{manual}. 1998-08-11 17:59:07 +00:00
Fred Drake 0618f5e55b Added step 0: copy this file to <somedir>/lib<module>.tex, and edit the copy. 1998-08-11 17:43:45 +00:00
Fred Drake bd4009493e Updated to reflect recent changes. 1998-08-11 17:41:20 +00:00
Fred Drake 2f343eb5cf Moved to ../templates/module.tex. 1998-08-11 17:30:02 +00:00
Fred Drake 1334147558 Relocating file to Doc/templates. 1998-08-11 17:25:48 +00:00
Fred Drake bd65706fe3 Added new files to the LIBFILES variable. 1998-08-11 15:50:35 +00:00
Fred Drake 5bdf88a364 Removed now-documented modules from the list. 1998-08-11 15:49:09 +00:00
Fred Drake 23f414c539 Added new sections. 1998-08-11 15:47:16 +00:00
Fred Drake e72e1e02fe Documentation for the compileall module. 1998-08-11 15:46:42 +00:00
Fred Drake 4756bb3e54 Documentation for the py_compile module. 1998-08-11 15:46:25 +00:00
Fred Drake 64c105d3d2 Added index entries.
Small markup nits.
1998-08-11 15:18:45 +00:00
Fred Drake f6b6bbceb6 Add a comment explaining that this script is probably not useful outside the
standard Python documentation, since the mkhowto.sh script is.  Let there be
no doubts....
1998-08-11 14:10:40 +00:00
Fred Drake 4d46487fe8 Make sure the icons/ directory is created even if only one document is
converted.
1998-08-11 13:18:52 +00:00
Fred Drake 916f7c1e7c Better check in the date from the last magic-fix-release. ;-) 1998-08-11 13:14:08 +00:00
Fred Drake 6aa5d482fb Control when/where navigation bars will appear: top & bottom of each page.
Include an additional button to the module index in the nav. bars if we
generate a module index.  Still need a button image, but the ALT text should
do for now.
1998-08-11 03:14:50 +00:00
Fred Drake bc74ca5203 Add a link to the Macintosh Module Reference here, too. 1998-08-10 21:48:31 +00:00
Fred Drake 295da24eaf New section header style.
Fix up a few synopses.
1998-08-10 19:42:37 +00:00
Fred Drake 62e436955b do_cmd_moduleauthor(),
do_cmd_sectionauthor():  Parallel the new macros.
1998-08-10 19:40:44 +00:00
Fred Drake b75c615389 \moduleauthor,
\sectionauthor:  New macros to record attributions; no output.
1998-08-10 18:41:43 +00:00
Fred Drake c817e27501 New style section headers. 1998-08-10 18:40:22 +00:00
Fred Drake 23329d41bc Some logical markup, some nits. 1998-08-10 17:46:22 +00:00
Fred Drake 4d10b43c26 insert_index(): Take two additional parameters: $columns and $letters. Call
buildindex.py appropriately.

add_idx(),
add_module_idx():  Add the appropriate parameters to the calls to
	insert_index().
1998-08-07 20:51:58 +00:00
Fred Drake 077fffa874 The letter headings must be requested explicitly with --letters. 1998-08-07 20:49:54 +00:00
Fred Drake aa3f9fb7d5 By default, use a two-column index. 1998-08-07 19:52:37 +00:00
Fred Drake 7cbf462acf Allow multi-column indexes to be produced. 1998-08-07 19:50:13 +00:00
Fred Drake 66da9d69fc re is standard, not built-in. 1998-08-07 18:57:18 +00:00
Guido van Rossum ed9dcc10f8 Clarify that the Python interpreter lock need *not* be held by
PyInterpreterState_New() and PyThreadState_New() -- but that you may
use it to serialize calls to them.
1998-08-07 18:28:03 +00:00
Guido van Rossum cdf6af1233 Document gethostbyname_ex(). 1998-08-07 18:07:36 +00:00
Fred Drake 96e11029b8 Updated list of Library Reference files.
Added some dependencies to some of the HTML generation targets.
1998-08-07 18:01:37 +00:00
Guido van Rossum aee5e26f4b Add warning that mutable argument defaults are evaluated only once;
with examples and workaround.  This keeps coming up, and I believe
that this section in the tutorial may have been (in part) the source
of the confusion.  While it didn't show examples with [] for a default,
it also didn't emphasize enough why that would be a bad idea, and
while it did say that defaults are evaluated at the point of function
definition, the example was not relevant for this issue.
1998-08-07 17:45:09 +00:00
Fred Drake 1a0b872665 At least mark the URL to the Packages essay using \url. 1998-08-07 17:40:20 +00:00
Fred Drake 5ee808db51 Fix synopsis. 1998-08-07 17:37:15 +00:00
Guido van Rossum 730d83797e Clarify that quit() and close() render the instance useless. 1998-08-07 17:36:59 +00:00
Fred Drake 161edc29a6 Added file transfer to example. 1998-08-07 17:30:49 +00:00
Fred Drake 0cb76200ef Guido's white background. 1998-08-07 16:43:29 +00:00
Barry Warsaw 92a6ed9940 Minor refilling of a paragraph... 1998-08-07 16:33:51 +00:00
Fred Drake 70da192f63 im_function --> im_func 1998-08-07 16:28:13 +00:00
Fred Drake 60c3cafc24 In the example, make sure all the imports are done. 1998-08-07 16:03:32 +00:00
Fred Drake 3700b6f94e Markup nits. 1998-08-07 16:02:28 +00:00
Fred Drake c18a6f3bfe Clarify xdrlib synopsis. 1998-08-07 16:01:15 +00:00
Fred Drake 2d62395a8e Fix typo in binascii synopsis. 1998-08-07 16:00:30 +00:00
Fred Drake 150ee43c64 Removed obsolete chapter header. 1998-08-07 15:58:54 +00:00
Fred Drake f44c4851e9 New organization of internet modules into protocols/support and data
chapters.
1998-08-07 15:58:31 +00:00
Fred Drake 29fe944787 New chapter headers for Internet Protocols and Internet Data chapters,
which replace the existing internet chapter.
1998-08-07 15:56:52 +00:00
Fred Drake d795c5cbd1 Fix synopsis for multifile. 1998-08-07 15:55:14 +00:00
Fred Drake 399fea89cb Shorten the module synopsis. 1998-08-06 21:30:32 +00:00
Fred Drake 72d157e998 Shorten the module synopsis. 1998-08-06 21:23:17 +00:00
Fred Drake 9940bd717c Variant of AMK's patch to produce text versions of HOWTO documents.
This ensures that the text version uses latex2html's -split 1 option, without
affecting HTML produced in the same run, and also minimizes the number of
l2h runs needed if --split 1 was used for an HTML run.
1998-08-06 20:15:20 +00:00
Fred Drake 23a163454a Markup nit. 1998-08-06 15:33:55 +00:00
Fred Drake 1a3c2a0ede Markup nits. 1998-08-06 15:18:23 +00:00
Fred Drake 56fa8a7e4b Marked makedirs(), removedirs(), renames() as added in 1.5.2. 1998-08-06 13:45:42 +00:00
Fred Drake 11300cc71e build_html(): Simplify, so there's only one version of the latex2html
command line.

l2hoption():  Convenience function, to write out an option to the aux. init.
	file only if set.

Added --iconserver option to set the $ICONSERVER variable in latex2html; this
requires the use of an auxillary init. file since this can't be initialized
using a standard latex2html command-line option.  So the aux. init. file is
used for just about all the special options since it has to be written anyway
when $ICONSERVER needs to be set.
1998-08-05 04:48:18 +00:00
Fred Drake 1ca8fdc446 Remove modified setting of $ICONSERVER; this isn't the right way to do it. 1998-08-05 04:36:09 +00:00