6c886a8db1
\optional{}: Removed leading word space, allowing more flexibility.
...
{seealso} environment: Always start a new paragraph after the "See Also:"
line; this ensures that formatting is consistent for each subsequent
\see*{} item.
1998-01-12 14:44:33 +00:00
b2c45a8197
Sigh. Apply a similar patch to the *other* occurrence of [^...].
1998-01-12 05:49:05 +00:00
fd49a964bc
Follow current recommended practice in an example: Use isinstance() to
...
perform a type test instead of type(x) == types.FoobarType. In example
for type().
1998-01-11 21:15:23 +00:00
48022db400
"Unix" --> "\UNIX{}"
...
Added index references to referred-to modules.
Added seealso section pointing to the glob module.
Removed description of translate().
1998-01-11 19:06:37 +00:00
0cf785a7a7
Grammatical nit.
1998-01-09 22:37:52 +00:00
cf7e830869
Add module reference for cPickle to index.
...
Consistency: Always use trailing "()" for function and method names in text.
Consistency: Always mark parameter names with \var{} in text.
Change questionable text about CORBA to definate text about XDR; "CORBA" isn't
enough to specify an external representation, and I'm not sure the comment is
right if we say "IIOP". I know its right about XDR if we only mention shared
object references and not recursive structures.
1998-01-09 22:36:51 +00:00
12d9da5827
Use \file{} instead of \code{} or ``\code{}'' to mark file & directory names
...
& name parts.
1998-01-09 22:30:32 +00:00
8d0ff317bc
Simplify markup.
1998-01-09 22:27:55 +00:00
57b935d0d6
The resource module has been documented; remove from list.
1998-01-09 22:25:10 +00:00
bbe6068de0
Added \label{} to allow module references.
...
Added some seealso sections.
1998-01-09 22:24:14 +00:00
aa5dba026a
Add index entry for reference to the math module.
1998-01-09 21:30:03 +00:00
d327a8dddf
Typographical nits: Always set parameter names in \var{} in the running text.
1998-01-09 21:26:51 +00:00
6b3ed7f581
Markup consistency in the mapping object interface description.
1998-01-09 20:36:44 +00:00
0bf6845450
Fix previous nit to really do the right thing.
1998-01-09 16:26:54 +00:00
60a3d2788e
Consistency: Always use lower-case markup; one tag was still given in
...
uppercase. (Makes it easier to see what markup is generated by the
Python manual support and what is generated by standard latex2html.)
1998-01-09 14:39:41 +00:00
0fd8268189
Revise prologue and frontmatter to use latex2e (not in 2.09 compatibility
...
mode) and take advantage of changes in myformat.sty.
Change "C" to "\C{}" and "\code{NULL}" to "\NULL{}" everywhere for consistency
and control.
Started a description of PyArg_ParseTupleAndKeywords().
1998-01-09 05:39:38 +00:00
1f8449af4e
Revise prologue and frontmatter to use latex2e (not in 2.09 compatibility
...
mode) and take advantage of changes in myformat.sty.
1998-01-09 05:36:43 +00:00
031ad4b2a0
\mytableofcontents New macro. Wrapper around \tableofcontents that
...
does the right thing if the openright option is given. Allows a
lot of crud to be removed from the document files' frontmatter
sections.
\endabstract Extend standard macro. (Called as \end{abstract}.)
Does the right thing if the openright option is given.
\optional Adjust to get the brackets right under latex2e.
1998-01-09 05:34:23 +00:00
46fbd7f4a0
Nit.
1998-01-09 05:22:44 +00:00
3c3d7ce7fe
For consistency, always use a trailing "()" on function names in the running
...
text.
Add one index entry.
1998-01-08 04:00:30 +00:00
fcda560e81
Fix a typo (the word "a" was spelled "c"!).
...
Added index entries & \label{} constructs.
1998-01-07 22:05:25 +00:00
c9a32ab26b
Normalize some markup.
...
Use \file{} instead of \code{} for a directory name (Tools/freeze).
Consistently use "()" at the end of a function name in running text.
1998-01-07 18:57:01 +00:00
6279fccf4c
Fixed up index entries.
...
Adjusted one formatting problem (long \code{} in running text).
1998-01-07 13:23:32 +00:00
1566a1d72c
Added index entry for the protocol.
...
Fixed typo (extra char in the word "character").
Minor nits.
1998-01-07 13:17:20 +00:00
15bac5d6e4
Added index items for the RFC and the protocol itself.
1998-01-07 13:13:42 +00:00
799484399d
Fixed index entries to be more consistent.
1998-01-07 03:47:10 +00:00
c4586387f6
In description of \D, revise markup so that the caret shows up in the HTML
...
version as well as the dvi form. Without the fix, it showed up as an extra
zero character.
Bug reported by Hugh Sasse <hgs@dmu.ac.uk>.
1998-01-06 15:46:21 +00:00
85a5c52752
Descriptions for PyRun_String(), PyRun_File(), and PyRun_CompileString() all
...
gave the return type as part of the function field and used an empty return
type field. Fixed.
Function name field for PyLong_FromString() included an asterisk at the
beginning of the function name field; removed.
1998-01-02 03:24:19 +00:00
34252f99d6
lib.dvi target: Added commands to generate the modules index.
1998-01-02 03:01:47 +00:00
c1ce320a4f
Script to convert module index data to module index.
1998-01-02 03:00:27 +00:00
0b1337d674
Add module index before the general index.
1998-01-02 02:59:09 +00:00
da941ef27c
Added support for storing information to build a module index.
...
Enhance the "theindex" environment to add an entry to the table of contents.
1998-01-02 02:57:41 +00:00
875c807c92
In description of the group() method, fix markup of "\(" and "\)" literals;
...
"\code{\\(}" produces "(" in the .dvi file and "<BR> (" in the latex2html
output (the font was right). Changed to "\code{{\e}(}" variation, which
fixes both. Breaks the .texi file generation again. Oh well.
1998-01-02 02:50:13 +00:00
3884e7edf9
Apply fixps.py to allow A4 paper printing.
1997-12-30 23:49:49 +00:00
1f35977bfd
Added BaseHTTPServer to table of contents for chapter.
1997-12-30 23:42:27 +00:00
eb0f066fb8
Correct small nits reported by Rob Hooft.
1997-12-30 20:38:16 +00:00
ccd25d10c4
Final version for 1.5; two tiny corrections.
1997-12-30 18:35:35 +00:00
5793039dce
Clarify that __getinitargs__ is called at pickle time!
1997-12-30 17:44:48 +00:00
4f80b65aa6
Added "docs" for Pareto and Weibull distributions.
1997-12-30 17:38:05 +00:00
1c8b9e4769
Clean out *.texi and *.info* as well for "make clean".
1997-12-30 04:57:58 +00:00
7779619524
Add obsolescence note.
1997-12-30 04:54:47 +00:00
b1b8f23903
Add URL of Andrew Kuchling's nifty re conversion page...
1997-12-30 04:53:49 +00:00
8e94489882
Add a note that up to 1.4, translate() produced Emacs style syntax; in
...
1.5, it produces Perl style syntax. Also change "Python's regular
expressions" into plain "regular expression" in the intro.
1997-12-30 04:43:36 +00:00
e33e903461
Updated release date to match boilerplate.tex.
...
Removed implied future availability of an info/texi version of the other
manuals (the word "yet").
Guido, you might want to check this file to see if any other changes are
required.
1997-12-30 04:42:49 +00:00
5de1eb9b84
Added ConfigParser.py to list of undocumented miscellaneous useful utilities.
1997-12-30 04:41:56 +00:00
dccc298e3d
Took out some disclaiming text (even from the title!). Rewritten
...
abstract. Alas, I didn't get to do anything else before the release
:-(
1997-12-30 04:40:25 +00:00
5b8a523538
A whole bunch of typos fixed by Andrew Kuchling.
...
Added a warning about the incompleteness to the front.
Added a reminder about CObject to the back.
1997-12-30 04:38:44 +00:00
5b943ca1a9
Set the release date for 1.5 (final).
1997-12-30 04:29:30 +00:00
13704a8928
Added .PHONY annotation for lib.info target; the real target is
...
python-lib.info. The annotation is needed to prevent at least GNU make from
building a second set of info files with the lib.info base name.
1997-12-29 22:04:44 +00:00
e66e9c5562
Remove more commented-out text that is no longer needed.
1997-12-29 21:43:04 +00:00
29d3b9368c
Remove the commented-out warning at the top. It shouldn't be there
...
for the 1.5 release version of the file.
1997-12-29 21:42:03 +00:00
43c9350f7a
Getting uglier. But it doesn't completely bomb except for some table stuff.
...
I'll get to it when I can.
1997-12-29 21:40:35 +00:00
78f8e98232
Lots of minor nits that allow this file to get processed without failures by
...
the info generation phases. Most of the errors had occurred in the makeinfo
step.
Commented out the warning at the top; this should still really be removed
before 1.5, but that's not my call. It generated problems for the info
conversion as well.
1997-12-29 21:39:39 +00:00
6810a29c64
Ignore generated info files.
1997-12-29 21:37:21 +00:00
a007c13094
Reduce warning count from partparse.py.
...
Removed BaseHTTPServer.py from list of undocumented modules.
1997-12-29 21:32:26 +00:00
3d913ad370
Revised lib1.texi target to deal with some conversion nastiness. See comment.
1997-12-29 21:31:23 +00:00
1b6cf78c15
Reduce warning count from partparse.py.
1997-12-29 20:28:33 +00:00
588f38ec2a
Ignore another intermediate file from the info generation.
1997-12-29 20:03:46 +00:00
d7feffdd5f
Reduce warning count from partparse.py.
1997-12-29 20:02:55 +00:00
9cb64803aa
Added Greg Stein's docs for BaseHTTPServer.py.
...
Moved docs for "re" to before docs for "regex".
1997-12-29 20:01:55 +00:00
b0744c5a28
Make "{" and "}" in code sample visible instead of a group (it's supposed to
...
be a dictionary...).
1997-12-29 19:59:38 +00:00
bef9b0b039
Added missing "\" to "\var{address}, var{length}" in buffer_info() description.
1997-12-29 19:33:45 +00:00
6884e3b94b
Reduce warning count from partparse.py.
1997-12-29 19:09:37 +00:00
c416445d7e
Use tableii environment for the table instead of tabular. This makes it
...
consistent with other 2-column tables in the Python documentation.
1997-12-29 19:02:01 +00:00
671fe9dd31
Reduce warning count from partparse.py.
1997-12-29 18:53:31 +00:00
a3e672b574
Nit adjustments to remove warnings when processed with partparse.py.
1997-12-29 18:21:37 +00:00
f0867315e9
Normalized the word "Unix" to "\UNIX{}".
...
Changed "{\tt crypt}" to "\sectcode{crypt}" in section heading.
1997-12-29 17:31:22 +00:00
a4541af0ba
A bunch of minor stuff.
...
Lots of support for new macros defined in myformat.sty; including the new
indexing macros, seealso environment & friends, and the byte code instruction
support.
1997-12-29 17:19:22 +00:00
05dd3c09ab
Added back info generation. Still buggy in the final phase (makeinfo run).
...
Does not conflict with any other targets.
1997-12-29 17:17:54 +00:00
cc97454987
Added missing "\" to "var{P}.\var{M}" in load_module() description.
1997-12-29 17:16:24 +00:00
f3e6df1e2d
Remove unneeded "{}" that confused makeinfo.
1997-12-29 17:11:55 +00:00
6ccaaf1a08
Change name of temporary file to avoid possible filesystem issues; matches
...
similar renaming of the @buildno file elsewhere in the Python tree.
1997-12-29 16:58:46 +00:00
1656d17c42
Changed all \verb\...\ markup to either \code{...} or \samp{...}.
1997-12-29 16:55:50 +00:00
2cd0b9b1ba
Removed "-*-texinfo-*-" from first line; this can cause emacs/xemacs to stop
...
and ask the user for permission to set buffer-local variables depending on
the user's configuration. Not really needed since this doesn't get edited
often.
Bumped the version number to 1.5; date still needs to be set.
1997-12-29 16:54:11 +00:00
f9951818a6
Normalized the \seetext markup to match the only other instance: should be
...
"\seetext{...}" instead of "\seetext ...".
1997-12-29 16:37:04 +00:00
45c9df6636
Changed some \verb\...\ markup to the more common \code{...}. \verb\...\ is
...
rarely needed and should be avoided where possible since it doesn't behave
well with some processing tools (like partparse.py).
1997-12-29 15:55:10 +00:00
0ee358529e
do_env_tableii(), do_env_tableiii(): Align the table in the center, just
...
like LaTeX does. There's no need to diverge on this.
1997-12-28 03:41:07 +00:00
dd79bd3539
Checking in fixed PS, with A4 capability.
1997-12-24 18:32:36 +00:00
b9973d9060
Script to edit one line in the PS to allow A4 printing.
1997-12-24 18:31:53 +00:00
7f96291ee2
Convert a couple of three-column tables with an empty third column to
...
two-column tables. This improves the rendering of the HTML version on
(at least) some browsers.
1997-12-23 04:21:20 +00:00
d665e8b5b0
Removed unnecessary \small{} block; latex2html got it wrong and its no
...
longer needed for printed output.
1997-12-23 04:10:35 +00:00
d21759ba47
Removed unnecessary \small{} block; latex2html got it wrong and its no
...
longer needed for printed output.
1997-12-23 04:03:26 +00:00
0148bbf966
AMK's latest
1997-12-22 22:41:40 +00:00
9597daf220
do_env_tableii(), do_cmd_lineii(),
...
do_env_tableiii(), do_cmd_lineiii(): New functions to handle tableii and
tableiii environments.
Small changes to not add a superfluous space between a function name and the
comma in the index.
1997-12-22 22:37:34 +00:00
e903aab833
Replace unprotected tilders by \~ -- an unprotected tilde is a
...
non-breaking space!
1997-12-18 16:28:56 +00:00
b2c6ef83f4
Change {\em ...} to \emph{...}; this seems to be the developing preference
...
throughout the manuals, and seems easier to read.
1997-12-18 15:56:05 +00:00
616b23b2e4
img_tag(), top_navigation_panel(): Generate markup the same case as other
...
functions in this file.
1997-12-18 14:16:46 +00:00
8da9e6a8a0
make_mod_index_entry(): Generate markup the same case as other functions in
...
this file.
1997-12-18 14:14:16 +00:00
304474f315
Make the word "Module" in the section header start with an upper-case "M".
...
Include "()" when naming functions in the text.
Fixed reference to the built-in str() function.
Format constant names using \code{}.
1997-12-17 15:30:07 +00:00
20417b7afb
Make the word "Module" in the section header start with an upper-case "M".
...
Added index entry for RFC 1014.
1997-12-17 14:17:35 +00:00
b78da332fa
Make the word "Module" in the section header start with an upper-case "M"
...
for all three modules described here.
Added a \label{} for each of the two modules missing it.
1997-12-17 14:12:31 +00:00
a47bce54a6
Make the word "Module" in the section header start with an upper-case "M".
...
Added a \label{} for the module.
Fixed one minor grammatical nit: use plural pronoun to refer to a pair of
referents.
Include "()" when naming functions in the text.
1997-12-17 14:11:18 +00:00
9c483191d6
Make the word "Module" in the section header start with an upper-case "M".
1997-12-17 14:08:01 +00:00
2303d31cc0
Make the word "Module" in the section header start with an upper-case "M".
...
Added a \label{} for the module.
Changed one \code{} to a \samp{}.
1997-12-17 14:07:25 +00:00
bcda484bc4
Make the word "Module" in the section header start with an upper-case "M".
1997-12-17 14:01:52 +00:00
36499b8e62
Make the word "Module" in the section header start with an upper-case "M"
...
for both modules documented here.
1997-12-17 14:01:31 +00:00
14f8521952
Make the word "Module" in the section header start with an upper-case "M".
1997-12-17 13:52:04 +00:00
7372e5793d
Make the word "Module" in the section header start with an upper-case "M".
...
Minor grammatical nit.
1997-12-17 13:51:08 +00:00
045c7fc9b9
Make the word "Module" in the section header start with an upper-case "M".
...
Remove the leading comment declaring this to be a template for module
documentation.
1997-12-17 13:47:39 +00:00
6f070108df
Make the word "Module" in the section header start with an upper-case "M"
...
for both modules documented here.
1997-12-17 13:45:50 +00:00
dccd9dbf52
Make the word "Module" in the section header start with an upper-case "M"
...
for both built-in and standard modules. They were different.
1997-12-17 13:44:37 +00:00
819b789f36
gen_index_id(): New function. Construct an index key such that the sort
...
is stable and the form is only defined in one place, since we do
some fancy footwork with the keys to separate the defining instance
of a module reference from other references in the HTML index.
make_index_entry(): Override the standard definition to use get_index_id().
make_str_index_entry(): Moved to myformat.perl; only needed there.
index_key_eq(): Override the standard definition. Add key transforms to
remove extra junk from the end of the keys; it was only there to
maintain ordering.
clean_key(): Remove key transform no longer needed at this stage, because
keeping it makes the sort unstable.
add_idx(): Add key transforms to undo the mess we do to separate a module's
defining and reference entries. Don't make the text bold.
1997-12-17 03:08:27 +00:00
84818d7aad
make_mod_index_entry(): New function. Create the index entry for a module.
...
my_module_index_helper(): Do the actual work for \*modindex{}, including
both the defining and reference forms.
make_str_index_entry(): Moved from .latex2html-init; it's really specific
to the presentation.
1997-12-17 02:59:39 +00:00
e4eb2231fd
AMK's latest
1997-12-17 00:23:39 +00:00
72df9bcba2
do_cmd_refbimodindex(), do_cmd_refstmodindex(): New functions, handle the
...
reference form of \bimodindex{} and \stmodindex{}.
my_parword_index_helper(): Fixed to include proper anchor in result text.
1997-12-16 21:13:20 +00:00
5ca9033062
Index the RFC822 reference (some other RFC references were alreaddy indexed).
...
Add index reference to mailbox module; also remove comment that it's
undocumented (it has been).
1997-12-16 15:19:47 +00:00
8e0799817e
The \indexsubitem definition for the actual exceptions did not actually
...
change the \indexsubitem value; fixed.
1997-12-16 14:54:32 +00:00
9d2f7d414d
Oops, ".pythonrc.py" should *always* be marked with \file{}; one occurrance
...
escaped with \var{}.
1997-12-16 14:43:37 +00:00
5493205ba4
Module names should be in \code{}.
...
Added index reference to site module.
1997-12-16 14:41:36 +00:00
0514ce126a
Descriptions for delitem(), __delitem__(): These delete a value, not set it.
...
Lots of little nits: parameter names in text should be \var{}, etc.
1997-12-16 14:29:48 +00:00
4f496cc5b1
Fixed index module reference.
1997-12-16 04:08:24 +00:00
90f2e5e202
Added a named target for referencing.
1997-12-16 04:06:33 +00:00
bfc28bcfdf
Used a named target to form the reference to the Built-in Functions section.
1997-12-16 04:06:06 +00:00
6d2bdb682d
Fixed index module reference.
...
Changed references to regex/regsub modules to point to re.
1997-12-16 04:04:25 +00:00
3aa289537c
Fixed index references to modules. (This is *not* the spam module!)
1997-12-16 00:02:01 +00:00
e14388c4b8
Fixed index references to modules.
1997-12-15 22:28:38 +00:00
19d58273c5
Fixed index references to modules.
...
Made references to files use \file{} instead of \code{}.
1997-12-15 22:23:52 +00:00
356818eccb
Fixed index references to modules.
1997-12-15 22:20:33 +00:00
8274f32a6d
Fixed index references to modules.
...
Changed regex reference to re.
1997-12-15 22:19:46 +00:00
f5eaa2efb8
Fixed index references to modules.
...
Added new index entry for mimetools module.
1997-12-15 22:13:50 +00:00
a51f5a48e5
Fixed index references to modules.
1997-12-15 22:09:42 +00:00
4af1814858
\refmodindex{}: New macro, used to make an index reference to a module which
...
is neither standard nor built-in. (Used for sitecustomize entry.)
1997-12-15 22:08:14 +00:00
9ab2b2ec5b
Fixed index references to modules.
...
Placed references closer to usage.
1997-12-15 21:59:33 +00:00
54820dc8e4
Fixed index references to modules.
1997-12-15 21:56:05 +00:00
6206394a4b
Changed illegal \stmodindex{} to \refstmodindex{}, added index reference
...
to the stat module.
1997-12-15 21:42:51 +00:00
8a528bd10d
Added some module references to the index.
1997-12-15 21:40:15 +00:00
207e57b617
Added definitions of \refbimodindex{} and \refstmodindex{}, which should be
...
used to add index references for built-in and standard modules, respectively.
Modified \bimodindex{} and \stmodindex{} to make the page number bold, to
allow the defining instance of a module to stand out in the index.
Check-ins which fix improper use of \bimodindex{} and \stmodindex{} will be
made as fixes are applied. Misc. indexing updates will occur as a side
effect in some cases.
1997-12-15 21:37:45 +00:00
d9dbfbd33c
At the top, made it clear that the \bimodindex{} and \stmodindex{} are only
...
used for the defining entry for the module, not every index reference.
1997-12-15 21:20:03 +00:00
c0cc6351e5
regex -> re
1997-12-15 17:53:31 +00:00
095f35ad60
Changed \indexsubitem from ({\tt HTMLParser} method) to just
...
(HTMLParser method).
This makes it more consistent with other modules. All three *mllib modules
need this change.
1997-12-12 05:34:35 +00:00
1247ceab94
Changed \indexsubitem from ({\tt SGMLParser} method) to just
...
(SGMLParser method).
This makes it more consistent with other modules. All three *mllib modules
need this change.
1997-12-12 05:33:34 +00:00
0add4c120d
Changed \indexsubitem from ({\tt XMLParser} method) to just (XMLParser method).
...
This makes it more consistent with other modules. All three *mllib modules
need this change.
1997-12-12 05:32:31 +00:00
d56924258a
add_idx(): Don't add unnecessary markup around the little markers stuck in the
...
index to cross-references; an image doesn't benefit by being bold!
1997-12-11 21:46:07 +00:00
48d0437d1d
AMK's latest version.
1997-12-11 20:19:08 +00:00
bd49ac4492
The 'l' flag (locale specific matching) has been renamed to 'L'.
1997-12-10 23:05:53 +00:00
d58daff686
Planned release date for 1.5b2.
1997-12-10 18:56:48 +00:00
736fe5e918
Document binary format and __init__-free unpickling. Added a pointer
...
to cPickle.
1997-12-09 20:45:08 +00:00
a42c17851c
Turn the table for flags into a nested itemized environment.
1997-12-09 20:41:47 +00:00
eefcba61f4
Fix a little mess (Likecode{...} -> Like \code{...}) in recently added text.
1997-12-09 19:47:24 +00:00
8291bb3693
Reference to PYTHONPATH should be PYTHONSTARTUP.
1997-12-09 19:46:45 +00:00
28f9a68deb
Added note about the module's obsolescence.
1997-12-09 19:45:47 +00:00
138dac5a1b
Added more warnings about ni's demise.
1997-12-09 15:03:41 +00:00
a2e268aa40
Mark file names with \file{} instead of \code{}.
1997-12-09 03:28:42 +00:00
c5aec05967
Separated the definitions of ntohs(), ntohl(), htons(), htonl(). Separate
...
descriptions really make things look a bit better, and should improve the
ability to re-purpose the content.
1997-12-08 21:25:41 +00:00
8ca70069a6
Added Emacs turd so this file has the correct mode in Emacs / X/Emacs, even
...
if you don't have .perl in your mode table.
1997-12-08 20:59:54 +00:00
a5a3cdcf4d
Added Emacs turd so this file has the correct mode in Emacs / X/Emacs.
...
clean_key(): Override the standard LaTeX2HTML clean_key() to remove a
leading HTML tag, if present. This broke the indexes for the library
reference (at least) since many of the strings began with <code> or
something similar.
1997-12-08 20:58:13 +00:00
a417b66204
Updated the README to the current status. Added a note about the
...
"times" option.
1997-12-08 20:51:26 +00:00
0b334104ac
New version from AMK -- with minor corrections to make it legal latex.
1997-12-08 17:33:40 +00:00
f3d729c8f9
Fixed SFT #23842 : leave in non-standard style options when checking in an
...
update. ;-(
1997-12-08 15:48:35 +00:00
e907208b30
Some reorganization (all limit operations & constants together, and all usage
...
functions and constants together).
Make explicit datadesc sections for each of the constants which might appear,
and have a description of each. (Descriptions are based on the Linux
documentation and sources and the Solaris man pages.)
Hopefully Jeremy won't mind, because I didn't ask. ;-)
1997-12-06 07:25:41 +00:00
Fred Drake
Guido van Rossum