Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity
10,800 Commits 6 Branches 593 Tags 2.5 GiB
Commit Graph

2417 Commits

Author SHA1 Message Date
Fred Drake 8b88093b95 Re-written mkhowto in Python; this should be at least a little more 
portable.

Several things that had been done by running a python script are now a
matter of importing the right module and running a function with a few
parameters.
 1999-03-03 20:24:30 +00:00
Fred Drake 749f943a6b process(): New function that contains the "orchestration" of the 
actual work.

main():  Just handle the command line and filename determination,
	 calling process() to do the work.

These changes make this more import-friendly.
 1999-03-03 19:36:23 +00:00
Fred Drake 7c8754fafb process(): New function that contains the "orchestration" of the 
actual work.

main():  Just handle the command line and filename determination,
	 calling process() to do the work.

These changes make this more import-friendly.
 1999-03-03 19:25:56 +00:00
Fred Drake aa99a5071e Be a little more friendly for the generation of the text version: for 
"blank" navigation icons, use ALT="" instead of ALT="blank"; also add
ALIGN=CENTER for the table, to get a slightly better affect in the
text (the table is full-width, so this doesn't change the appearance
when browsing the HTML).
 1999-03-03 16:21:34 +00:00
Fred Drake a54a887f66 "\platform{UNIX}" should really be spelled "\platform{Unix}". 1999-03-02 17:03:42 +00:00
Fred Drake f6863c1909 Added \platform annotations. 1999-03-02 16:37:17 +00:00
Fred Drake 46a9438c43 Add information about adding the portability statement. 1999-03-02 16:24:22 +00:00
Fred Drake 7f492ad7b8 Be more flexible to support platform annotations. 1999-03-02 16:22:56 +00:00
Fred Drake 75ab7a6fa4 Clean up *.pla files -- platform annotation information. 1999-03-02 16:22:26 +00:00
Fred Drake 521835c541 Ignore *.pla -- the platform annotation information. Also, remove it for 
'make clean'.
 1999-03-02 16:20:42 +00:00
Fred Drake d70091eade Ignore *.pla -- the platform annotation information. 1999-03-02 16:19:37 +00:00
Fred Drake 0c275fa856 Added support for \platform, \platformof, and \ignorePlatformAnnotation. 1999-03-02 16:17:44 +00:00
Fred Drake 557460cb7a swallow_newline(): Removed function; not really needed. Modified all call 
sites.

do_cmd_ignorePlatformAnnotation(),
do_cmd_platform(),
do_cmd_platformof():  New functions to support platform dependency
		      information.

process_all_platformofs():  New function to post-process \platformof macros
	using information collected during the initial pass.

process_python_state():  New function. Call all post-processing functions
	defined in this file to avoid having to have too much knowledge of
	the internals for this stuff in l2hinit.perl.
 1999-03-02 16:05:35 +00:00
Fred Drake 2383f6dbbc Improve handling of module index, to deal with platform annotations a little 
better.
 1999-03-02 16:00:37 +00:00
Fred Drake 01bc01c82e Changes to accomodate the global module index and platform annotations. 1999-03-02 15:58:20 +00:00
Fred Drake 368b16ad2b Only use 4 columns in the module index, to accomodate platform annotations. 1999-03-02 15:56:19 +00:00
Fred Drake 43b34da656 extract_tb(): Only describe this function once. Problem reported by 
Jonathan Giddy <jon@dgs.monash.edu.au>.
 1999-02-26 18:51:21 +00:00
Fred Drake 390636382a Typo: "Availabilty" --> "Availability" 
Thanks to /F!
 1999-02-26 14:05:02 +00:00
Fred Drake 51027c4173 Added note about comments, from Christopher Petrilli. 1999-02-24 22:36:44 +00:00
Fred Drake 16e81f4484 Update some of the top comments and shorten title of the first 
section.
 1999-02-24 19:57:14 +00:00
Fred Drake 093c97a36f ignore_from_idx(): Fixed bug in regular expression. 1999-02-24 18:39:47 +00:00
Fred Drake 684f78fafe Add target for modindex.html; a combined lib+mac module index. Also 
built with target "all".
 1999-02-24 17:34:12 +00:00
Fred Drake 2ef38a7a42 Script to combine module index files. Given a list of files that look 
like modindex.html, create a combined modindex.html file that lists
all the modules.  Takes the same parameters as buildindex.py.
 1999-02-24 17:33:07 +00:00
Fred Drake 1b102456a6 Ignore a file called modindex.html. 1999-02-24 17:13:54 +00:00
Fred Drake 711fe02ac3 process_nodes(): New function. 
main():  Moved the node processing between input and ouptut to
	 process_nodes().
 1999-02-24 16:36:48 +00:00
Barry Warsaw f2b4554403 Document the correct class hierarchy for SystemExit. It is not an 
error and so it derives from Exception and not SystemError.
 1999-02-24 00:27:14 +00:00
Fred Drake b6cf9a4fc4 Script to help identify undocumented modules. Use -h or --help for 
usage information.
 1999-02-23 23:07:48 +00:00
Fred Drake 8cdee961bf Dictionaries are created using the "{...}" notation, not the "..." 
notation.  Problem reported by Magnus L. Hetland <mlh@idt.ntnu.no>.
 1999-02-23 18:50:38 +00:00
Guido van Rossum 264bd59221 1. Clarify that immutability isn't entirely the same as unchangeable 
value (because of immutable containers containing mutable objects).

2. Document that func_code, func_defaults and func_doc / __doc__ are
now writable.
 1999-02-23 16:40:55 +00:00
Fred Drake 1ec71cb556 Incorporated updates to describe geturl() by Sjoerd Mullender 
<Sjoerd.Mullender@cwi.nl>.
 1999-02-22 22:42:14 +00:00
Fred Drake ba21d10d9b Added note about *static* after description of *shared*. 1999-02-22 18:21:17 +00:00
Fred Drake 00a3a65cc0 Refer to the right RFC in the intro. 1999-02-22 17:12:42 +00:00
Fred Drake 0fb7a37667 Reflect the released version. 1999-02-22 15:58:09 +00:00
Fred Drake 9226d8e8a8 Removed "This will be discussed later." where it's not. Reported by 
Clay Spence <cspence@sarnoff.com>; see entry in ../TODO.
 1999-02-22 14:55:46 +00:00
Fred Drake 7d9b13325d Other chapter titles refer to collections of modules as "Services"; do 
the same here.
 1999-02-22 14:48:00 +00:00
Fred Drake 8ece8041c5 Noted report of missing material in the extending & embedding manual, 
as reported by Clay Spence <cspence@sarnoff.com>.
 1999-02-22 14:37:18 +00:00
Fred Drake c411fa6861 Revised description of blank line handling for the interpreter, based 
on a comment from /F.
 1999-02-22 14:32:18 +00:00
Fred Drake fab41f1788 BabylMailbox description: Properly escape the backslashes in the 
string representations.
 1999-02-22 14:26:16 +00:00
Fred Drake b63e77ccb0 Oops, used a \label twice - fix one of them. 1999-02-22 14:14:48 +00:00
Fred Drake 180b68b3cf More reasonable section titles. 1999-02-22 13:45:09 +00:00
Fred Drake 76991ec75a Shorten section title. 1999-02-20 05:20:49 +00:00
Fred Drake 199b79c37b Added descriptions for BabylMailbox and Maildir (Qmail) mailbox 
objects.
 1999-02-20 05:04:59 +00:00
Fred Drake 67d229ea76 Shorten section title. 1999-02-20 04:51:16 +00:00
Fred Drake bbac43223c Shorten a few section titles. 1999-02-20 00:14:17 +00:00
Fred Drake da57365337 Give subsections reasonable file names in the HTML. 1999-02-19 23:48:05 +00:00
Fred Drake 342501142d Added an index entry. 1999-02-19 23:45:06 +00:00
Fred Drake 50cdd97ec4 do_cmd_arabic(): Override the l2h-provided version to remove that 
obnoxious <SPAN CLASS="arabic">...</SPAN> markup.
 1999-02-19 23:04:59 +00:00
Fred Drake df5d50d889 Specify the sizes of H? relative to the normal font size as 
percentages; using "large", "x-large" makes them too big for
some troublemakers.  ;-)

(Not specifying them at all causes some browsers to make them the same
size as normal text.  ;-(  )
 1999-02-19 23:03:04 +00:00
Fred Drake 56f8185a53 Shortened the short synopsis -- too long. 1999-02-19 22:59:56 +00:00
Fred Drake 9f03380d1c Use more current approach to recording authors. 1999-02-19 22:56:08 +00:00
Fred Drake c60047575d Shortened the short synopsis -- way too long. 1999-02-19 22:33:51 +00:00
Fred Drake d8a41e6391 Fix an amazing number of typos & malformed sentences reported by Detlef 
Lannert <lannert@uni-duesseldorf.de>.
 1999-02-19 17:54:10 +00:00
Fred Drake f6346345b0 Noted that the module was added in 1.5.2. 1999-02-19 15:46:38 +00:00
Fred Drake 4e7c205470 Update description of what modules "look like" when printed. 1999-02-19 15:30:25 +00:00
Fred Drake cd71aa2a38 Use current approach to record documentation author. 1999-02-18 21:13:03 +00:00
Fred Drake 2a2f1fe4d5 Record module & documentation author. 1999-02-18 21:10:32 +00:00
Fred Drake 6b103f1e12 Documentation for pyclbr and tokenize modules. 1999-02-18 21:06:50 +00:00
Fred Drake 4d358b5d23 Added sections for pyclbr and tokenize. 1999-02-18 20:40:26 +00:00
Fred Drake 7c829b3179 Remove the "Parsing Python" section. Hurray! 1999-02-18 20:39:44 +00:00
Fred Drake 3d7707a87d More files. 1999-02-18 20:39:04 +00:00
Fred Drake 93d762fc7a Mark <verbatim> elements that represent interactive sessions; these 
become <interpreter-session> elements.
 1999-02-18 16:32:21 +00:00
Fred Drake 997eec7cca Minor adjustments to reflect esis2sgml.py changes. 
Added "esis" target to only generate the ESIS data.
 1999-02-18 16:31:05 +00:00
Fred Drake 607aed7a2c Some adjustments, mostly to make it more general. 1999-02-18 16:30:16 +00:00
Fred Drake 4cc902f464 Make the _rmtt regular expression deal with the new CSS-friendly 
changes to the HTML documentation.
 1999-02-18 16:11:12 +00:00
Fred Drake 70a66c9d6d Add notes to __builtin__.float() and string.atof() that the NaN and Inf 
results are possible but non-portable.
 1999-02-18 16:08:36 +00:00
Fred Drake 29fb54f0ca Update note about the (...) format specifier for PyArg_ParseTuple(). 1999-02-18 03:50:01 +00:00
Fred Drake 951eea4733 atof() description: Add information about accepting 'NaN' to produce 
the NaN value.
 1999-02-18 03:49:20 +00:00
Fred Drake 127ed0a71e Updated list of standard exceptions in section 4.1. 1999-02-17 23:09:05 +00:00
Fred Drake 8e0151725d Small updates and grammatical adjustments. 
Remove comment about this manual being out of date from the abstract.
 1999-02-17 18:12:14 +00:00
Fred Drake 33698f818b Removed old dynamic linking chapter. 
Integrated information on Windows DLLs from Chris Phoenix (Thanks!).

Added "Acknowledgements" area to thank contributing authors.
 1999-02-16 23:06:32 +00:00
Fred Drake 2f7bfafe26 Remove all email addresses. 1999-02-16 22:51:09 +00:00
Fred Drake 3de61bc13f Integrated notes on building extension modules on Windows, by Neil 
Schemenauer <neil_schemenauer@transcanada.com>.

Thanks, Neil!
 1999-02-16 21:14:16 +00:00
Fred Drake f6838c0f5e Copy in the stylesheet after latex2html is done. 1999-02-16 20:43:53 +00:00
Fred Drake fcf57ad959 Copy in the stylesheet after latex2html is done. 1999-02-16 20:28:25 +00:00
Fred Drake 90fdda5404 Become more stylesheet-friendly. 1999-02-16 20:27:42 +00:00
Fred Drake 00d98ee5cc CSS style sheet for the documentation. 1999-02-16 20:27:08 +00:00
Fred Drake 63f217741e Bump release to 1.5.2b2. 1999-02-16 20:23:55 +00:00
Fred Drake f43ce00531 Make sure errors get propogated. 1999-02-16 20:05:43 +00:00
Fred Drake 85a59dd68b The _O_* constants are defined as O_* in the os module. 1999-02-16 19:41:01 +00:00
Fred Drake 9329e5ec75 Remove "_" from the P_* symbols used with the spawn*() functions. 1999-02-16 19:40:19 +00:00
Fred Drake c7b72dbbca Added chapter on Windows modules, including msvcrt and winsound. 1999-02-16 19:18:38 +00:00
Fred Drake a5fab7f8c8 Added some files to the library reference. 1999-02-16 19:08:16 +00:00
Fred Drake abfd7d6701 Small grammatical fix; missing comma. 1999-02-16 17:34:51 +00:00
Fred Drake 295fb434ed Make it clear that Demo/embed/ is from the source distribution. 1999-02-16 17:29:42 +00:00
Fred Drake beb27bfef7 Make navigation panels more CSS-friendly. 
Make sure the contents page always has the "table of child links"
turned off; this wasn't being handled properly by latex2html for
"howto" ("article") documents, so just do it ourselves for all
document types.
 1999-02-16 17:22:32 +00:00
Fred Drake e96a31da96 Use the same markup for email addresses as is produced by using \email 
in the LaTeX sources.
 1999-02-16 16:16:37 +00:00
Fred Drake cce8d2a85a Adjust cellspacing attribute of the navigation bar tables to get some 
space between cells on all (major) browsers.
 1999-02-16 14:21:54 +00:00
Fred Drake 6f9dd5d719 Remove stuff related to copying the icons directory around -- just 
isn't needed.
 1999-02-15 21:43:55 +00:00
Fred Drake b8a7d72857 Moved icons into the html directory to avoid pollution of the top level. 1999-02-15 21:42:47 +00:00
Fred Drake 66b989c805 Be explicit about the reference count of the original value of the 
first parameter to PyString_Concat().
 1999-02-15 20:15:39 +00:00
Fred Drake 4d33e4e1a8 HTMLBASE: New variable. Make it easier to check an "installed" copy 
of the HTML documents using the webcheck target.

When there's not a usable .aux file, use mkdvi.sh --aux instead of
building the .dvi completely.  This makes the most difference for the
library reference.
 1999-02-15 19:29:08 +00:00
Fred Drake efa641c45a Add an optional parameter to make the script run latex only once to 
generate an .aux file.  This can make HTML generation a bit faster
when print formats aren't needed.

Explained parameters in a comment.
 1999-02-15 19:27:07 +00:00
Fred Drake 3618c14f72 Use a common definition for $(SUBMAKE) instead of repeating everything 
all over the place.
 1999-02-15 16:50:28 +00:00
Fred Drake aa1afa8d30 Added availability notes for samefile(), sameopenfile(), samestat() 
since these are not available on Windows.
 1999-02-15 16:34:00 +00:00
Fred Drake 5d59d3df7f Added --l2h-config option to add additional initialization files for 
latex2html.  Can be useful in setting up things like the upward
external link for the top of the documents.
 1999-02-15 16:27:42 +00:00
Fred Drake ec9fbe90be Added section "Providing a C API for an Extension Module" by Konrad 
Hinsen.

"\C{}" --> "C"
 1999-02-15 16:20:25 +00:00
Fred Drake efd146c916 Markup nits. 
Added section on module objects; described functions in
moduleobject.c.
 1999-02-15 15:30:45 +00:00
Fred Drake 69d49d6378 Set target. 1999-02-15 15:02:21 +00:00
Fred Drake f32834c206 Minor fix that helps out with the index. 1999-02-12 22:06:32 +00:00
Fred Drake 9474d86242 Make sure all HTML pages generated from this section have reasonable 
names.

Markup nits.
 1999-02-12 22:05:33 +00:00
Fred Drake 5761b766b2 L2HARGS: Specify the HTML version we're producing, since this is what 
we generate anyway.
 1999-02-12 21:42:23 +00:00
Fred Drake 2d2b6a0074 Markup nits. 1999-02-12 20:40:49 +00:00
Fred Drake 99cd5735f0 Minor markup nits. 1999-02-12 20:40:09 +00:00
Fred Drake 7b84972450 Use the shorter form of Christopher Petrilli's email address. 1999-02-12 20:09:59 +00:00
Fred Drake 28bc711f5f Added section for MimeWriter, contributed by Christopher Petrilli 
<petrilli@amber.org>.

This spells the end of another whole section in the undoc chapter!
 1999-02-12 19:26:09 +00:00
Fred Drake f7bf3b2b06 Added entry for MimeWriter module. 1999-02-12 19:24:02 +00:00
Fred Drake 15799edd34 Make table headers the same color as the navigation bars so they stand 
out a little better.

Make sure the boxes for the last column of tables always get drawn;
these are often left empty of content when used as a "Notes" column.
They look a little better this way.
 1999-02-12 19:23:17 +00:00
Fred Drake 7a9ed71e95 Moved the navigation-bar background color to a variable. 1999-02-12 19:00:38 +00:00
Fred Drake 26b698fa4d Document <complex #>.conjugate(). 1999-02-12 18:27:31 +00:00
Fred Drake 15988fdbbb Documented __complex__(), made sure all the discipline names hit the 
index.
 1999-02-12 18:14:57 +00:00
Fred Drake 2e1ee3eb19 Fix up some routines to coordinate the "indexsubitem" stuff so that 
the subitem text is updated correctly when each module section is
processed.

Print [<modulename>] when we start on \declaremodule so we can more
easily track progress during the library reference.
 1999-02-10 21:17:04 +00:00
Fred Drake 72e5a901c2 Remove unnecessary <p> from top navigation bar. 1999-02-10 17:35:41 +00:00
Fred Drake ec5c0b41ae Revert previous change; there's a better way to do it. 1999-02-10 17:08:00 +00:00
Fred Drake 95474f9696 Change the navigation bar to be a little prettier and more consistent 
with the python.org style.
 1999-02-09 18:45:50 +00:00
Fred Drake 446ab75fcf New blank icon to match the others in size & color, with without any 
symbol on it.
 1999-02-09 18:27:21 +00:00
Fred Drake 2d1f81ea22 do_cmd_maketitle(): Small nit in creating the "title page". 1999-02-09 16:03:31 +00:00
Fred Drake 1a4c5392b5 Back out some of the fine tuning; something in all that interacted 
badly in practice and botched the whole thing.  Wasn't obvious when
looking at the local effects (which worked), but completely broke
entire pages.  ;-(
 1999-02-09 15:31:52 +00:00
Guido van Rossum ce67f06491 Update documentation to reflect changes to Queue.py by Tim Peters. 1999-02-08 18:43:13 +00:00
Fred Drake dfb4e24431 Respond to suggestion from "Albert" <hat@se-46.wpa.wtb.tue.nl> to add 
document titles to the list of files.

Also added total page count and a note that comments should be
directed to python-docs@python.org.
 1999-02-05 20:50:59 +00:00
Fred Drake 2ff880e2cf More magic to tighten up a little of the formatting. 1999-02-05 18:31:29 +00:00
Fred Drake f9918f25b1 Minor nit to prevent dropping a space in the HTML generation. 1999-02-05 18:30:49 +00:00
Fred Drake d673d481f5 Document sameopenfile(), samestat(). 1999-02-03 22:31:30 +00:00
Fred Drake 0256c1f453 Document splitdrive(). 
For all split*(), these split path *into* pairs, not split path *in*
pairs.  "Into" can be used for transformations, "in" is for
containment.
 1999-02-03 19:24:44 +00:00
Guido van Rossum 0c9608cf1b Portability fix for [f]statvfs() return tuple: no longer return the 
f_fsid field, since it's not a scalar on all systems supporting this
call (in particular, it's a tuple of two longs on AIX).  Since it's
not particularly useful, just nuke it.  Adapted the doc strings too.
 1999-02-03 16:32:37 +00:00
Fred Drake dbd37dfcff Remove three items. 1999-02-02 19:03:09 +00:00
Fred Drake 215fe2f204 Fix the os/posix documentation issue. 1999-02-02 19:02:35 +00:00
Fred Drake dda199b261 Moved \versionadded to end of description sections. 1999-02-02 19:01:37 +00:00
Fred Drake 12ba7868e4 Moved posixpath to os.path. 1999-02-02 19:00:37 +00:00
Fred Drake 560bcae0f0 Added posixpath, winsound. 1999-02-02 18:59:58 +00:00
Fred Drake a9b9bf96fe Change this to be os.path. 
Use consistent parameter naming with the os documentation (paths
always named "path" or "path1", "path2"...).
 1999-02-02 18:58:33 +00:00
Fred Drake bb79438d26 This seems to fix a problem with targeting from the indexes. 1999-02-02 18:57:12 +00:00
Fred Drake 2116d983bf Make \versionadded and \versionchanged less prominant -- neither bold 
nor a separate paragraph.
 1999-02-02 18:02:48 +00:00
Fred Drake d0bceeeb59 Move \versionadded macros to end of descriptions. 1999-02-02 18:00:40 +00:00
Guido van Rossum 09da65ef2f Patch by Sjoerd Mullender to placate /F: 
Clarified (hopefully :-) the documentation of elements and attributes
variables.
 1999-02-02 17:55:12 +00:00
Fred Drake dbd72a4e4f Added module synopsis. 1999-02-01 21:27:59 +00:00
Fred Drake 68a8c69499 Take out just about everything and refer the reader to the os module. 1999-02-01 20:23:02 +00:00
Fred Drake b23ee1d899 Make the text generic, and call it os.path instead of posixpath. 1999-02-01 20:20:39 +00:00
Fred Drake 59d8b73cef Remove all references to posixpath; only refer to os.path. 
Formalize the xstat() documentation.
 1999-02-01 20:19:38 +00:00
Fred Drake 98be47e737 OSError description: "as the by the" --> "as the" 1999-02-01 16:17:40 +00:00
Fred Drake 7281b3b779 Updated comments on version of XML package needed. 1999-01-29 22:35:23 +00:00
Fred Drake 28e66d1c5e Added the info tarball to the tarballs target. Added the README to 
the info tarball.
 1999-01-29 22:23:25 +00:00
Fred Drake b2c59ab367 A README file for the info tarball. 1999-01-29 22:22:03 +00:00
Fred Drake 1dd152d036 Added support to handle \versionadded in a reasonable way. 1999-01-29 22:12:29 +00:00
Fred Drake 9b0dc53d89 Define %descriptor.class, since it's used. 1999-01-29 21:38:14 +00:00
Fred Drake 279ca75a5b Be a little smarter on some attribute values, making an assumption about 
the DTD.
 1999-01-29 21:35:50 +00:00
Fred Drake 3a7ff998ac fixup_descriptors(): Change the way we look for descriptor nodes; 
this takes 5 minutes off the conversion of the whole tree by
	reducing the number of tree-traversals from 14 to 1.
 1999-01-29 21:31:12 +00:00
Fred Drake 666e60095b Added the Doc/sgml/ directory to the tarball. 1999-01-29 21:22:55 +00:00
Fred Drake cb65781d93 Rewrite code that converts the little descriptor environments to build 
the right <signature>s and <description>.  This seems to work a lot
better now!
 1999-01-29 20:55:07 +00:00
Fred Drake 75930b31e2 Added table entries for \funcline and \funclineni. 1999-01-29 20:09:27 +00:00
Guido van Rossum 1804dc3c07 Document abspath() (implementation is forthcoming). 1999-01-29 18:05:05 +00:00
Fred Drake f339632da0 Define a general entity "&version;" that can be used as the current major 
version of the Python interpreter.  This is \version in the LaTeX format
of the documentation.
 1999-01-29 16:42:37 +00:00
Fred Drake fdfd50f815 Convert <version> to &version;. 1999-01-29 16:29:25 +00:00
Fred Drake 7859f17608 A few scribbles toward the DTD. 1999-01-29 16:21:20 +00:00
Fred Drake 6bcc53c109 Standard ISO entities. 1999-01-29 16:20:24 +00:00
Fred Drake 2eb07f0945 The OASIS Exchange table model public text. 1999-01-29 15:57:31 +00:00
Fred Drake 7dab6affba Update the docstring. 
Lots of changes to get the paragraph marking to work, and not go into
an infinite recursion.

Start to rationalize markup of method signatures; not complete.

find_all_elements():  similar to getElementsByTagName(), but operates
	on the not-quite-legal fragments we deal with here.
	Simplifies several individual transforms.

fixup_sectionauthors():  Convert \sectionauthor items to <author> just
	after the <section>'s <title>.
 1999-01-28 23:59:58 +00:00
Fred Drake 3f3b09657f Added table entries for \methodline, \methodlineni. 1999-01-28 23:49:37 +00:00
Fred Drake ae3e574170 "numberic" --> "numeric", two places 1999-01-28 23:21:49 +00:00
Fred Drake 1453a8caf9 Constructor arguments for classes should be called <args>. 1999-01-28 23:10:48 +00:00
Fred Drake 703b70e260 Added \modulesynopsis. 1999-01-28 19:30:49 +00:00
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