Commit Graph

2257 Commits

Author SHA1 Message Date
Guido van Rossum 6b86a42c7f Document -OO; "unsafe" optimization that removes docstrings.
Marc-Andre Lemburg.
1999-01-28 15:07:47 +00:00
Fred Drake ffd511248e Add the info "dir" fragment to the info tarball. 1999-01-27 18:50:21 +00:00
Fred Drake 8d7919d754 Fragment of an info "dir" file for the Python documentation. 1999-01-27 18:49:44 +00:00
Fred Drake ffc4811a40 Simplify slightly. 1999-01-27 18:40:36 +00:00
Fred Drake c5efde8522 Don't build info for the Macintosh module reference by default; it
doesn't do well.
1999-01-27 18:30:16 +00:00
Fred Drake aa2aea0e79 \py@linkToName: New macro to consolidate support for most internal
hyperlinking in the PDF version.  This also allows many of the
	macros that do this stuff to be a good bit more readable.
	Takes the target name and link content as parameters.

Use \py@linkToName for all internal links.
1999-01-27 17:37:36 +00:00
Fred Drake 580f4ab5dc Added the files for the repr and ConfigParser modules. 1999-01-27 17:21:09 +00:00
Fred Drake 9d814c6805 Document the repr module. This removes the entire "Code objects and
files, debugger etc." section from "Undocumented Modules"!
1999-01-27 17:20:33 +00:00
Fred Drake da452bf6a7 Don't say that the module defines the "following functions" and then
only describe one; say "following function" instead!

Merge the two one-sentence paragraphs into a single paragraph, so it
doesn't look too stupid.
1999-01-27 15:48:23 +00:00
Fred Drake ebe2a12de8 Incorporate changes for patched version of ConfigParser. 1999-01-26 21:49:05 +00:00
Fred Drake 9f253dc3ff \py@modindex: Format the index entry for the module index more like
that used in the "normal" index.  No visual difference, but
	more easily processed by helper scripts.
1999-01-26 19:23:09 +00:00
Fred Drake bc866ce2e3 Documentation for the ConfigParser module, by Christopher G. Petrilli
(petrilli@amber.org).
1999-01-26 15:47:59 +00:00
Guido van Rossum 9700e9becc Document the default for tabsize in expandtabs(). 1999-01-25 22:31:53 +00:00
Fred Drake a49a4eabbf Add "term" to AUTOCLOSE. 1999-01-22 22:48:24 +00:00
Guido van Rossum d1dbf633ed Header for PyObject_DelItem() mentioned non-existing 3rd argument. 1999-01-22 20:10:49 +00:00
Fred Drake 43278f01dc convert(): Added parameter "autoclose", which should be a sequence of
general identifiers for which closing tags will be omitted
	when SGML is generated.  This can be used to tell the markup
	generator to drop stuff like </para>.  Note that it needs to
	be possible for the closing tag to *always* be omitted for it
	to be included in "autoclose".

main():  Added command-line option "-a" / "--autoclose" to set the
	list of general identifiers passed to the convert() function
	as the "autoclose" parameter.  The list may only be specified
	once (not additive) and GIs should be comma-separated.  The
	default list includes only "para".
1999-01-20 20:35:05 +00:00
Fred Drake 0a5b8de5e2 Modified the "sgml" and "xml" targets to stop if the sub-makes fail in
any subdirectory; don't continue with remaining subdirs.

Added "api", "ext", "lib", "mac", "ref", and "tut" targets to only do
submakes in those directories.  This is just a lot easier to use than
to cd into the subdir and use make.rules directly.
1999-01-20 17:26:56 +00:00
Fred Drake 19a0dba342 Add caveat on partial dependence on the "cl" module, only available on
IRIX systems.
1999-01-20 16:26:09 +00:00
Fred Drake 9ea3e36419 Move the jpeg module to the SGI section; it is dependent on the "cl"
module available on IRIX.
1999-01-20 15:55:20 +00:00
Fred Drake 4259f0db04 create_module_info(): If there's a \moduleauthor, move it to an
<author> inside the <moduleinfo> element.

Fix problems with paragraph identification.
1999-01-19 23:09:31 +00:00
Fred Drake 36dfe58694 isnmtoken(), istoken(): Fix to ensure the regex has to match the
entire attribute value.

Add ability to save list of "empty" elements to a file -- enabled by
constant in the code.
1999-01-19 23:03:04 +00:00
Fred Drake 2664db9f76 handle_labels(): Fix problem for document fragments containing more
than one "root" that prevented all the <label id=...> items
	from being promoted to id attributes on the enclosing chapter/
	section/... properly.
1999-01-19 21:46:48 +00:00
Fred Drake a7998f650a Revised comments on null bytes in pattern string.
Removed "New" from module synopsis.
1999-01-19 20:00:08 +00:00
Fred Drake 6ffa445832 Fix second description of handling 2-digit years (last item in
introductory text).
1999-01-19 19:35:18 +00:00
Fred Drake d6ced7d199 convert(): Change the element name remapping to convert <refmodule>
to <module link>.
1999-01-19 17:11:23 +00:00
Fred Drake f82e4ab617 format_attrs(): Attempt a bit more minimization for SGML output. 1999-01-19 17:10:31 +00:00
Fred Drake 9bbdce5945 add_module_idx(), add_idx_hook():
Change the message printed before running buildindex.py;
	"Doing the index..." wasn't clear and could be misinterpreted
	with an inappropriate mindset.  ;-)
1999-01-19 16:30:10 +00:00
Fred Drake 7eca8e5017 Fix typo spotted by Jeff MacDonald <jam@ans.net>. 1999-01-18 15:46:02 +00:00
Fred Drake 589bc63e84 Add a "tarball" target. 1999-01-14 22:35:05 +00:00
Fred Drake 6038f54b74 Adjust so that we are no longer using special entities for well-known
names.  These are too much of a pain for occaissional authors.
1999-01-14 21:44:56 +00:00
Barry Warsaw 53610caee2 for method getaddrlist(): Added a note clarifying that all named
headers and their continuation lines are parsed.
1999-01-14 21:26:54 +00:00
Fred Drake 3effeedad3 Shorten the name of the <rfc> "number" attribute to "num". 1999-01-14 21:18:52 +00:00
Fred Drake d24167baf2 Make <rfc> no longer an empty element but a container. The text
currently generated by the LaTeX and LaTeX2HTML processes is generated
here as well, making it more flexible in the SGML version.

Reduce the <args> element so that <optional> goes away; just use
square brackets to indicate what's optional.  This makes it easier to
read than the LaTeX, and the processor can do any checking it needs to
in order to make sure it's legit.  Possible shortcoming: DSSSL
processors may need more explicit markup.  Can probably hack around it
for this case, but we'll see.
1999-01-14 21:18:03 +00:00
Fred Drake f8ebb5521d Several new functions to re-write tables to be at least partly
conformant with the OASIS Exchange model.  There's a little more
massage left to do, but not much.
1999-01-14 19:45:38 +00:00
Fred Drake a50a1df588 Added clean and clobber targets. 1999-01-14 18:26:23 +00:00
Fred Drake 54bad44f25 Update to the latest version of Michael Ernst's script. 1999-01-14 18:17:07 +00:00
Fred Drake 3a7a3d745d "Driver" makefile to convert all documents to SGML or XML at once. 1999-01-14 18:13:59 +00:00
Fred Drake 7727416686 Add usage of the "driver" Makefile. 1999-01-14 18:12:33 +00:00
Fred Drake 9d1c3b565f Elaborate a comment on the format of the table that drives the
conversion.
1999-01-14 18:10:09 +00:00
Fred Drake d7acf02290 Adjustments to allow elements with subelements as parameters. This is
used to deal with the table headings and entries.

An additional flag in the element table is used to indicate elements
which have no "general" content, but which do have subelement
content.  These must be flagged distinctly from empty elements.
Currently used for \lineii, \lineiii, and \lineiv.
1999-01-14 17:38:12 +00:00
Fred Drake 79cbadc194 Added fixinfo.el to the list of dependencies. 1999-01-14 17:13:03 +00:00
Fred Drake 79ad1f19dc Escape special characters on output. 1999-01-14 17:06:09 +00:00
Fred Drake da71e315bb Update the comments on info files. 1999-01-13 23:02:38 +00:00
Fred Drake e36e4e6778 Use \refmodule when we say "use the XXX module instead".
For the whatsound module, point to sndhdr.
1999-01-13 17:11:52 +00:00
Fred Drake da94374a86 \seemodule: Fix so that each \seemodule entry gets its own paragraph,
so they don't get run together when there's no blank line
	between them in the source.  The HTML conversion already did
	the right thing.

\refmodule:  Refer to a module, using a hyperlink in the PDF version.
	Visually the same as \module.
1999-01-13 17:09:06 +00:00
Fred Drake 2581704dfa do_cmd_refmodule(): New function to support new \refmodule macro. 1999-01-13 17:06:34 +00:00
Fred Drake 8d43a2937b Added a few items. 1999-01-12 21:31:16 +00:00
Fred Drake fcb7adb6aa Fix the HTML tarball target to generate the HTML if needed instead of
bombing.
1999-01-12 20:32:39 +00:00
Fred Drake dd7610cac9 Bump the date. Seems like fun. ;-) 1999-01-12 19:51:03 +00:00
Fred Drake 701f10fbea Simplify command that extracts the number of pages from a PostScript
file; use "grep -c" instead of "grep | wc -l | cut ... | tr ...".
1999-01-12 19:28:41 +00:00
Fred Drake 39cddb7439 Added \modulesynopsis. 1999-01-12 19:22:11 +00:00
Fred Drake 03dd3efd5a <writer>.send_paragraph(): Clarify what needs to be done by this
method and what it should not do.  (Specifically: handling
	breaking of last line of preceeding paragraph.)
1999-01-12 18:33:47 +00:00
Fred Drake 5a0ca4e55c do_cmd_methodline(): Fixed reference to method name when generating
the output HTML.
1999-01-12 04:16:51 +00:00
Fred Drake 4856d01797 Removed a lot of unnecessary comment markers which cause unexplained
numbers to appear in the HTML version of the manual.
1999-01-12 04:15:20 +00:00
Fred Drake 8e2c9457a2 output_body(): For <address> elements, just skip, since they're
always part of the page trailer.
1999-01-11 22:30:34 +00:00
Fred Drake bb3b0028ba Patches describing the statvfs() and fstatvfs() functions. Additional
text about large file support.

All new text by Steve Clift <clift@mail.anacapa.net>, with only minor
revision / addition of markup.
1999-01-11 18:36:23 +00:00
Fred Drake b6584cac1e Remove the "lib-" prefix from the name of the info archive. 1999-01-08 15:49:45 +00:00
Fred Drake ed94dde4b9 No longer useful. 1999-01-08 15:48:47 +00:00
Fred Drake dd21c32169 It's finally gone! 1999-01-08 15:40:16 +00:00
Fred Drake f2b5374ba1 Remove obsolete files. 1999-01-08 15:34:06 +00:00
Fred Drake 78104a9b77 Replace most everything but the comment at the top. 1999-01-08 15:33:38 +00:00
Fred Drake c4e9263010 Add a few comments. 1999-01-08 15:32:27 +00:00
Fred Drake c58f346374 New support scripts for HTML->info conversion that use Michael Ernst's new
conversion tools.
1999-01-08 15:27:17 +00:00
Fred Drake 3fe1d32693 New conversion tools for HTML->info from Michael Ernst
<mernst@cs.washington.edu>.

Thanks!
1999-01-08 15:25:29 +00:00
Fred Drake 637ad47e61 convert(): Make sure no line has trailing whitespace. (docfixer.py
checks for \n\n as a paragraph separator, LaTeX allows white
	space between the newlines.)
1999-01-07 18:47:07 +00:00
Fred Drake c7dd3e11da Markup nit.
Add module synopsis.
1999-01-07 15:45:55 +00:00
Guido van Rossum cf3ce92ef4 Explain how come that pickle and cPickle, while using the same data
format, can produce different pickle strings for the same object.
1999-01-06 23:34:39 +00:00
Guido van Rossum e51aa5b2cd Minor clarifications by Sean Reifschneider:
- add example of string literal concatenation
- add clarifying comment to the example of the if statement
1999-01-06 23:14:14 +00:00
Guido van Rossum 87e611e441 Replace the docs for reduce with an adaptation of its docstring, which
was actually clearer!
1999-01-06 23:10:51 +00:00
Guido van Rossum 74429eacb5 Add doc for access() and ttyname(). Patch by Sean Reifschneider. 1999-01-06 23:03:43 +00:00
Fred Drake fcc5910090 Preliminary code to mark paragraphs. Seems to work, but very slow. 1999-01-06 22:50:52 +00:00
Fred Drake c553358c63 Remove documentation for whatraw() since it's gone now. 1999-01-06 15:21:19 +00:00
Fred Drake 60adb362df Document the sndhdr module.
Document that the whatsound module is obsolete.
1999-01-05 23:09:12 +00:00
Fred Drake a2e4017394 Shorten the synopsis that gets into the table of contents. 1999-01-05 22:54:49 +00:00
Fred Drake ccc627200a write_idxfile(): New function. Isolate format of the external index
data file used by buildindex.py.

next_argument_id():  Removed; no longer used.

next_argument():  Doesn't use next_argument_id(), just does the work.

gen_target(), gen_target_name():  Removed, no longer used.  The only
	place that used them now does the (trivial) work directly.


Lots of little changes so we never have to pass around $br_id values
all over the place.  The only places they're used now new IDs are
generated as needed.
1999-01-05 22:16:29 +00:00
Fred Drake 02e18b4b84 Added missing "from" in IOError description. 1999-01-05 21:42:18 +00:00
Fred Drake 26f0f65653 Remove obsolete comment. 1999-01-05 20:53:43 +00:00
Fred Drake 5d56d3665f Make the documents that have indexes dependent on the buildindex.py
script.
1999-01-05 15:49:39 +00:00
Fred Drake 7d45f6dcc4 do_cmd_methodline(): New function, implements indexing version of
\methodline.

Fixed up support for \withsubitem, hopefully improving the fidelity of
the index a bit.
1999-01-05 14:39:27 +00:00
Fred Drake 3b07480a17 trim_ignored_letters(): Simplify a little. 1999-01-04 22:00:56 +00:00
Fred Drake 8d7e11a8c1 Update information on the version of latex2html to use, including
complaint about 98.2b8 problems.
1999-01-04 18:25:38 +00:00
Fred Drake b75d021081 Typo: "TWELV" --> "TWELVE"
Added note at top, since LaTeX style writers like to force name
changes when someone else makes a change to the style.  I'm sending a
note to the author reporting the error and asking for an updated
version.

This cannot be distributed in this form.  This will be resolved when I
get a response from Ulf Lindgren.

Typo reported by rwolff@noao.edu (Richard Wolff).
1999-01-04 16:15:02 +00:00
Andrew M. Kuchling f07c328c07 Document the optional mode argument (Z_FLUSH, Z_SYNC_FLUSH, etc.)
to the flush() method of compressor objects.
1998-12-31 21:14:23 +00:00
Fred Drake 94c4a7976f Added index entries to make it easier to locate directory & file operations. 1998-12-28 21:58:57 +00:00
Fred Drake 8692998018 Added index entries to make it easier to locate directory operations. 1998-12-28 21:58:15 +00:00
Fred Drake cc09e8dc82 Clarified what Python versions the interactivity chapter applies to,
and what it doesn't apply to.
1998-12-28 21:21:36 +00:00
Fred Drake 76fa3b73d6 Remove recently documented modules from the undoc list. 1998-12-28 20:53:19 +00:00
Fred Drake 03a0235793 Print a line to the console reporting the number of index nodes
processed.  This can be interesting to see.
1998-12-28 20:46:53 +00:00
Fred Drake 566c8327f7 Added entry for libshutil.tex. 1998-12-28 20:17:33 +00:00
Fred Drake 449e18f459 Add documentation for shutil module. 1998-12-28 20:16:58 +00:00
Fred Drake cd058539a8 Adjust a few niggles that affected the HTML conversion (a couple of
"^"s were being dropped in the context of [^...]).
1998-12-28 19:03:24 +00:00
Fred Drake d82af0b8ec Remove all use of $* in commands; some makes (Solaris 2.5, IRIX 6.X)
only expand this in dependency lists.  Thanks for Sjoerd Mullendar for
pointing this out.
1998-12-28 15:17:22 +00:00
Guido van Rossum d358afeec0 Document 'N' format character for Py_BuildValue -- like 'O' but doesn't INCREF. 1998-12-23 05:02:08 +00:00
Fred Drake 32f7ae0066 Fix many of the specific targets in links from the index.
In a number of places, I called next_argument() instead of
next_argument_id() when the ID was also needed.  (7 places)
1998-12-22 23:41:07 +00:00
Fred Drake 7d65d388b8 Add the getpass module to $(LIBFILES). 1998-12-22 23:38:11 +00:00
Fred Drake 99e2c39b31 Add the getpass module. 1998-12-22 23:37:46 +00:00
Fred Drake 5ac2a07fca Basic documentation for the getpass module. 1998-12-22 23:37:21 +00:00
Fred Drake 85220410e0 Bump $(RELEASE). 1998-12-22 22:17:41 +00:00
Fred Drake 5cb48a4c98 Added a \versionchanged since the API changed to support
namespaces with 1.5.2.

Added an index entry.

Fixed XML expansion:  XML is the "Extensible Markup Language", not the
"eXtended Markup Language".
1998-12-22 18:46:13 +00:00
Fred Drake 292b9ebfba Added information on when this was added, allowing us to release the
documentation on the Web while people are still using < 1.5.2b1.
1998-12-22 18:40:50 +00:00
Fred Drake ae48aabb10 Update the date. 1998-12-22 18:27:22 +00:00
Fred Drake 1189fa98eb Adjust markup to match current conventions, and make it formattable. 1998-12-22 18:24:13 +00:00
Fred Drake 768ac6b804 Start of text that describes differences between match and search.
Strengthen pointers to the search() function and method.
1998-12-22 18:19:45 +00:00
Fred Drake 5eecd7b3bd Improve a couple of comments. 1998-12-22 18:15:04 +00:00
Fred Drake 191f2857f5 Use \moduleauthor and \sectionauthor instead of a comment to credit
the author (just happened to notice this one).
1998-12-22 18:06:02 +00:00
Fred Drake 7be0cde3a0 Add an explanation about what the example does and doesn't do.
Fix an appearantly new behavior with latex2html with quoting.  (Good
incentive to work on the SGML conversion! ;)
1998-12-22 18:04:48 +00:00
Fred Drake 2eff3c5273 do_cmd_rfc(): Make the "RFC ###" a hyperlink to the master RFC
repository.
1998-12-22 18:02:25 +00:00
Fred Drake 782c973cb9 Added libnetrc.tex and libshlex.tex to LIBFILES. 1998-12-22 17:40:43 +00:00
Guido van Rossum 5e97c9dff9 Adding libshlex and libnetrc by Eric Raymond. 1998-12-22 05:18:24 +00:00
Guido van Rossum b1f97d6765 Suggestion by Tim Peters clarifying what "before global" means.
(Also added an XXX comment requesting clarification of module
initialization -- TBD later.)
1998-12-21 18:57:36 +00:00
Fred Drake e848976fba Clarify descriptions of some operations; it's not always clear that
strings are not actually modified.  Problem reported by Dr. Peter
Stoehr <peter.stoehr@weihenstephan.org>.
1998-12-21 18:56:13 +00:00
Fred Drake 3b02ddfa41 Add a bunch of index entries related to retrieving information from
the process table.
1998-12-21 18:52:53 +00:00
Guido van Rossum b083a9fb54 Sjoerd Mullender writes:
Here is my current version of xmllib.py and the documentation.  This
version has some API changes with respect to the version currently in
Python (also the one in 1.5.2a).
This version supports XML namespaces.
1998-12-18 20:17:13 +00:00
Fred Drake aaed9710e9 create_module_info(): New function: Modify a <section> to create a
<moduleinfo> element based on various meta information, and
	strip some cruftiness.  This is more usable for information
	extraction, and organizes the information more clearly.

cleanup_synopses():  Rewrite to use create_module_info(), so this
	will work with multi-rooted "documents".
1998-12-10 20:25:30 +00:00
Fred Drake fee6abea90 Remove another {\rm ...} construct.
Sheesh, where do these things come from?
1998-12-10 19:57:52 +00:00
Fred Drake 4abcffb233 Don't pass around a list of known empty elements, since the ESIS
contains "e" events for them.  This wasn't used anyway.
1998-12-10 18:31:37 +00:00
Fred Drake fba0ba2a6f Added a transform to start cleaning up the modulesynopsis stuff a
little; more thinking is needed about what we really want.
1998-12-10 05:07:09 +00:00
Fred Drake e9e05968e3 Nits. 1998-12-10 05:04:21 +00:00
Fred Drake c166331cd3 Handle SGML variant as well as XML variant. SGML is *much* more
likely to be used.
1998-12-10 04:56:00 +00:00
Fred Drake 0ad55fb241 Update the descriptions of strftime() and strptime() to avoid
confusion, and describe what the "directives" are about.
1998-12-08 19:59:36 +00:00
Guido van Rossum aac399b80b Correct the poplib example. Stephan Richter pointed out some problems
with it.
1998-12-08 16:30:10 +00:00
Fred Drake 64583d3f87 Rename the parameters of atan2(), based on comments from Guido & Peter
A. Koren <pkoren@hex.net>.
1998-12-08 16:10:44 +00:00
Guido van Rossum f484a3366b Sjoerd writes:
When literal mode is entered it should exit automatically when the
matching close tag of the last unclosed open tag is encountered.  This
patch fixes this.
1998-12-07 21:59:56 +00:00
Fred Drake d83675f344 "singed" --> "signed" (3 places)
Noticed by Andrew MacIntyre <andymac@bullseye.apana.org.au>.
1998-12-07 17:13:18 +00:00
Guido van Rossum e039439e3b Clarify evaluation of default arguments at def time with more text and
an example.
1998-12-04 19:37:10 +00:00
Guido van Rossum 8c2da61811 Add explicit example on how to import a submodule of a package using
__import__ and getattr().
1998-12-04 15:32:17 +00:00
Fred Drake 86bc7b01b5 General comments on what's here and how to try it out. Note
dependence on the XML package.
1998-12-02 17:21:35 +00:00
Barry Warsaw 6d26f4b188 Moved NotImplementedError into alphabetical order, and reword
description.
1998-12-01 19:48:04 +00:00
Barry Warsaw 1e151322fb Added documentation for NotImplementedError. Fred (I'm sure) will
sanitize for your protection :-)
1998-12-01 19:19:21 +00:00
Fred Drake 3695b1212c Support conversions to both SGML and XML; SGML is the "default".
Add dependency on esistools.py for the ESIS intermediate files.
1998-12-01 19:05:56 +00:00
Fred Drake aeea9810cd Use esistools.
Lots of changes to the conversion table.
1998-12-01 19:04:12 +00:00
Fred Drake 4db5b4636c Use esistools.
Generate ESIS data instead of XML.
Misc. changes to some transforms.
1998-12-01 19:03:01 +00:00
Fred Drake f077b9d61f Use esistools, getopt. 1998-12-01 19:01:53 +00:00
Fred Drake 3843bae969 Utility functions and misc. classes used in handling ESIS data. 1998-12-01 19:00:58 +00:00
Fred Drake 2f8592cbea Ignore the byproducts of SGML/XML conversions for now. 1998-12-01 18:58:28 +00:00
Fred Drake eabfab1048 Nits to support conversions. 1998-12-01 18:37:59 +00:00
Fred Drake 1e270f0e03 Nits to support conversions. 1998-11-30 22:58:12 +00:00
Fred Drake f954b6516e Remove $(CUTCRUFT) garbage; now in fixgenents.sh.
Separate ESIS generation from XML generation.  This will evolve a bit
more in a couple of days.
1998-11-30 22:31:45 +00:00
Fred Drake 3d5e2c032d Move nasty cruft from make.rules' $(CUTCRUFT) here, mostly to clean up
make.rules.
1998-11-30 22:30:29 +00:00
Fred Drake 50b804dc88 Fix minor nit with respect to conversion.
Update some logical markup.
1998-11-30 22:14:58 +00:00
Fred Drake caa3379c4f Remove {\rm ...} constructs. 1998-11-30 21:53:47 +00:00
Fred Drake 84538cd076 Remove some remaining {\rm ...} constructs.
Update logical markup in a few spots.
1998-11-30 21:51:25 +00:00
Fred Drake f790b16d00 Change "for" explanation slightly based on comment passed along by
Blake Winton <BlakeW@pcdocs.com>.
1998-11-30 20:37:24 +00:00
Fred Drake ca6d6355d7 l2hoption: Do the "right thing" to quote the right-hand-side of Perl
assignments.  This allows '"', '$', and '@' to be included in
	the values passed to parameters like --address.
1998-11-30 20:30:26 +00:00
Fred Drake a8ba364700 Add a --address parameter to the mkhowto command line to direct
documentation comments appropriately.  In response to comment from
Martijn Faassen <faassen@vet.uu.nl>.

Add dependency to about.dat.
1998-11-30 20:28:35 +00:00
Fred Drake 7777e36c21 Add a -address parameter to the LaTeX2HTML command line to direct
documentation comments appropriately.  In response to comment from
Martijn Faassen <faassen@vet.uu.nl>.
1998-11-30 20:27:31 +00:00
Fred Drake 1ea5848b7b Oops, remove LaTeX2HTML version number. Could become wrong and isn't
needed, since it's always added to the comments in the page header
anyway.
1998-11-30 19:29:34 +00:00
Fred Drake 15796f791a do_cmd_textohtmlinfopage(): Rip out most of the boilerplate and move
it to the about.dat file.  Only what really needs to be
	generated is, and the remainder is easier to maintain than
	Perl code.
1998-11-30 19:25:47 +00:00
Fred Drake d83c8bd95f New file. Contains boilerplate text for the "About this document..."
section of LaTeX2HTML-generated documents.

Includes credit to Christopher Petrilli for the navigation icons.
1998-11-30 19:24:13 +00:00
Fred Drake 1776556f8f Markup nit to ease conversions. 1998-11-30 19:00:16 +00:00
Fred Drake 3d29955a6e Markup improvements to help with conversions. 1998-11-30 18:59:44 +00:00
Fred Drake 01d5d94020 Remove cruft from the old Texinfo conversion. This simplifies some of
the newer processing.
1998-11-30 17:33:38 +00:00
Fred Drake 5208823158 Remove bogus \@. 1998-11-30 16:27:37 +00:00
Fred Drake d61975e179 Minor markup nit to ease conversion processing. 1998-11-30 16:26:50 +00:00
Fred Drake f6c59e8fff Do all the right imports. Problem reported by Martijn Faassen
<faassen@vet.uu.nl>.
1998-11-30 15:07:26 +00:00
Fred Drake 42f5298ab5 Several small adjustments. 1998-11-30 14:45:24 +00:00
Fred Drake fa1cceb91f Make \var work correctly in math mode. 1998-11-30 14:42:59 +00:00
Fred Drake 87dfd3cfbf Handle output of \geq and \leq. 1998-11-30 14:36:26 +00:00
Fred Drake 4471f20ed4 Logical markup.
Fix a few things for the conversion to structured markup.

Removed texinfo special cases, since there's likely a new info
process.
1998-11-25 22:38:24 +00:00
Fred Drake f65e323101 Fix remaining {\rm ...} construct. 1998-11-25 20:55:03 +00:00
Fred Drake af2590a991 Remove some optional parameters that are unnecessary in context. 1998-11-25 20:15:52 +00:00
Fred Drake 72554e476f Remove bogus \@. 1998-11-25 20:07:35 +00:00
Fred Drake b6d45c6ad1 Remove bogus \@. 1998-11-25 19:55:47 +00:00
Fred Drake 4c5e533693 Do the right stuff to convert what was originally \e, \ldots, and ---
in the LaTeX sources.
1998-11-25 19:28:02 +00:00
Fred Drake d03268feaa Remove two remaining {\tt ...} constructs. 1998-11-25 19:23:33 +00:00
Fred Drake 78eebfdbf4 Remove two remaining {\tt ...} constructs. 1998-11-25 19:09:24 +00:00
Guido van Rossum 5eabf3823b Clarify that min and max also take multiple arguments. 1998-11-25 18:53:05 +00:00
Fred Drake 1e42d8aaab Massive change to just about every construct that impacts the index.
Blame it on Just.  ;-)
1998-11-25 17:58:50 +00:00
Fred Drake ea81edf059 Markup nits.
Fixed an index entry, added three more.
1998-11-25 17:51:15 +00:00
Fred Drake 1475e88a35 Minor fixups to some index entries. 1998-11-25 17:48:10 +00:00
Fred Drake 2b3730e284 Minor adjustments to a few index entries. 1998-11-25 17:40:00 +00:00
Fred Drake 1cbd196f96 Minor nit that fixes a bunch of indexing: the way the classdesc
environment saves the name of the last class described, method and
member descriptions were not picking it up correctly.  Thus, many
index entries were described as "( method)" instead of "(FooClass
method)".  Multiple entries were collapsed in the index when
methods/members from multiple classes share the same name.
1998-11-25 17:13:28 +00:00
Fred Drake e839199014 Fix indexing of func_code attribute; this is on a function, not a code
object.

Add "()" to method names indexed using \ttindex{}.
1998-11-25 17:09:19 +00:00
Fred Drake d8faf85d40 Supplemental rules to convert a .tex file to a .xml file. Both XML and
SGML will be supported soon, probably using an ESIS representation saved
in a temp file.
1998-11-24 17:40:33 +00:00
Fred Drake 6942e57f87 Script to convert things like <C/> and <Cpp/> to &C; and &Cpp;. This is
something that con't be done with the DOM as far as I can tell.
1998-11-24 17:38:49 +00:00
Fred Drake e743fd01ac Rationalize a word-space markup to not break in the LaTeX->*ML
conversion tools currently being constructed.

Add a chapter from Jim Fulton on using Misc/Makefile.pre.in.  Still
preliminary.  The "Dynamic Loading" chapter needs to be updated (and
possibly removed, since it's no longer an issue for most (any?)
users.
1998-11-24 17:07:29 +00:00
Fred Drake 1cb330c383 The & character is also escaped using \. 1998-11-23 23:11:12 +00:00
Fred Drake 1ff6db484f Add some additional cleanup transformations. 1998-11-23 23:10:35 +00:00
Fred Drake 5701482ea7 Fix comment regex so we don't screw up structured comments with
different internal indentation levels.
1998-11-23 18:21:54 +00:00
Guido van Rossum 04307ce789 Rewrote the section on sys.exit(), documenting other argument types
than integers and recommending sys.exit("message").
(I see this as Python's answer to Perls ``die "message";''.)
1998-11-23 17:49:53 +00:00
Fred Drake 0320473a29 Script to squirrel around with the DOM tree of document fragments from the
LaTeX-based ESIS streams to be a little better structured, and generally
perform clean-up.

Preliminary.
1998-11-23 17:02:03 +00:00
Fred Drake 30a68c7a2b Moved into tools/sgmlconv/. 1998-11-23 16:59:39 +00:00
Fred Drake 63de8f6d55 Moving to sgmlconv/ subdir. 1998-11-23 16:58:48 +00:00
Fred Drake bbd7509dbe Fix up the extraction of optional parameters a little.
Be more informative in an exception message.
1998-11-23 16:30:18 +00:00
Fred Drake c16149b17b Some cleanup.
Don't duplicate the information on what's empty; rely on the input
data for that.  (This means that the DOM may need more work.)
1998-11-23 15:14:18 +00:00
Fred Drake 96b07a9453 Fix some minor problems.
Make the table of attribute information contain only one kind of
entry.  Simplifies some stuff in subconvert().
1998-11-23 15:12:00 +00:00
Fred Drake 99ff8c4361 First cut at a script to generate SGML/XML from an ESIS event stream,
probably only usable for the Python docs.  But also probably more
useful than latex2esis.py.
1998-11-18 23:28:24 +00:00
Fred Drake 95f4f92b47 First cut at a script to generate ESIS events from LaTeX source,
probably only usable for the Python docs.
1998-11-18 23:27:24 +00:00
Fred Drake db70d06464 Eliminate remaining \verb/.../ constructs; there's no need for them. 1998-11-17 21:59:04 +00:00
Guido van Rossum da30f4ca6b Fix typo in doc for handle(): client_request should be client_address.
Noted by Stefan Witzel.
1998-11-16 19:07:04 +00:00
Fred Drake 5e8aa549d1 Update the example in "Calling Python Functions from C" to use
METH_VARARGS conventions and PyArg_ParseTuple(), and document the flag
and where to look for PyArg_ParseTuple() info.

Response to comment from Don Bashford <bashford@scripps.edu>.
1998-11-16 18:34:07 +00:00
Fred Drake c46973c89b Document the user and password parameters to the NNTP constructor. 1998-11-16 17:11:30 +00:00
Fred Drake 2510d22048 Clarify the default buffering for open(). (Comment from Andrew Dalke
<dalke@bioreason.com>).
1998-11-02 18:57:34 +00:00
Fred Drake cab91efd34 Fix Barry's markup. 1998-11-02 17:23:25 +00:00
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