ed79783bb2
Converted to use new macros. This example demonstrate \method{} and, more
...
importantly, \url{}.
1998-01-22 16:11:18 +00:00
55f4492859
Converted to use semantic markup. This is an example of how many of the new
...
constructs should be used.
1998-01-22 15:56:41 +00:00
dd28d57fd0
Revised new macros after discussion with Guido: Always use full names of
...
semantic concepts.
Added two new ones (not discussed with Guido:
\constant{}: Markup for constants defined in Python modules.
\cfunction{}: Markup for C functions; these should probably be distinguished
by font, but are not at this time (since they're typically \code{} at
this point).
1998-01-22 15:55:21 +00:00
0f35495563
Add entry for copy_reg module.
1998-01-21 05:04:52 +00:00
6eb9f10063
Removed entry for copy_reg module.
1998-01-21 05:00:28 +00:00
251fed3e56
$(LIBFILES): Added libcopyreg.tex.
1998-01-21 04:59:44 +00:00
2d754437d4
Add entry for copy_reg module.
1998-01-21 04:58:39 +00:00
1abf0df5b4
Simple documentation of the copy_reg module.
...
Guido, you should probably look at this. The pickle documentation is out of
date; I don't see anything about the __reduce__() stuff or the
__safe_for_unpickling__ attribute.
1998-01-21 04:58:10 +00:00
d1cc9c2b92
Update comment about relative URL internet draft to reflect current RFC status;
...
index references the appropriate RFCs.
Consistency: Always use trailing "()" on function names in running text.
1998-01-21 04:55:02 +00:00
61b0452626
Added a bunch of "concept" index entries.
...
Use trailing "()" on function names in running text.
1998-01-20 05:52:23 +00:00
a46f84d293
Added index entry and \label{} for exceptions module. This isn't in the
...
normal modules portion of the manual, but that's the basic effect of this
section with the 1.5 change in exception support.
1998-01-20 05:26:12 +00:00
73a973bf8d
Always mark variables in the "Notes" following a table the same way as in the
...
tables: \var{}
Add a couple of index entries to the File Objects section.
1998-01-20 05:20:39 +00:00
cbe50f4829
Removed bogus index entry for the type() built-in.
...
Marked title of the Python Reference Manual as \emph{}, like other Python
manual titles.
1998-01-20 05:12:36 +00:00
311c19688d
Proposed new macros: see comments. These are not yet used.
...
These are intended to support semantic markup. There are a number
of places in the documentation where the exact meaning of an
indentifier marked \code{} in the running text is ambiguous (could
be a module or a class, a function or a method, etc.). These are
intended to clarify the intent of the identifier for processing
applications and more intelligent style processing.
1998-01-20 05:07:19 +00:00
cb42f7c295
Consistency: "{\tt ...}" ==> "\code{...}"
1998-01-20 04:55:47 +00:00
9eb5e5097e
Consistency: "{\it ...}" ==> "\emph{...}"
1998-01-20 04:54:23 +00:00
c520b695fe
The soundex module is built-in, not standard.
...
"--" ==> "---"
1998-01-20 04:45:44 +00:00
ca12b9df7b
Consistency: {\it ...} ==> \emph{...}
1998-01-20 04:43:29 +00:00
dd17d1ce62
ni is a standard module, not a built-in module. The only other reference to
...
it already got it right.
1998-01-20 04:40:41 +00:00
bac354cd80
Consistency: (Yes, I know this section is not formatted by default, and
...
isn't likely to be of much interest these days....)
{\tt ...} ==> \code{...}
Added \label{module-blat} for the two supporting modules.
Added index entries for referred-to modules.
1998-01-20 04:32:09 +00:00
79a6a9e882
Removed a confusing note about coercions and __r*__ operators.
1998-01-19 23:16:55 +00:00
46503922a0
Various updates to the effect that the group argument is always optional.
...
Also documented that groups() now always returns a tuple.
1998-01-19 23:14:17 +00:00
7d4ecb8785
Add note about dropping latex 2.09 compatibility.
1998-01-19 23:10:21 +00:00
8095ebfc4a
Consistency: Replaced 4 {\it ...} with \emph{...}.
1998-01-19 04:02:41 +00:00
94e8f690dd
Consistency: Replaced one {\tt ...} with \code{...}.
1998-01-19 02:55:11 +00:00
b6ce6427e8
Consistency: In two places, change {\it ...} to \emph{...}.
1998-01-19 02:51:02 +00:00
53396f66c1
Consistency: In two \section{} headers, change {\tt ...} to \sectcode{...}.
1998-01-19 02:48:37 +00:00
9e24309bb5
\funcitem{}, \dataitem{}, \excitem{}: Removed obsolete macros; there are no
...
longer used anywhere. Use the {*desc} environments instead.
\var{}: Ensure that the argument is always set in roman italic, in case an
alternate font is being used for code. These keeps the result of
\var{} consistent.
Some minor changes to allow easier exploration of alternate fonts for code in
the running text. Haven't changed the selected font; I haven't found one that
has everything required! (The best non-monospaced font so far was missing
the <, >, and | characters, or at least had them at the wrong locations. It
also allowed confusion between upper-case I and lower-case L.)
1998-01-18 05:09:54 +00:00
b660b63edf
Use \emph{} for all references to the other documents, not just some of them.
1998-01-16 16:34:34 +00:00
5081b227f1
Ouch: "accounces" ==> "announces"
...
(In description of AbstractWriter class.)
1998-01-15 05:49:00 +00:00
af8a015c93
Consistency: "{\bf ...}" ==> "\strong{...}"
...
"{\em ...}" ==> "\emph{...}"
Not at all sure what to do with "{\rm ...}".
Leaving it for now.
1998-01-14 14:51:31 +00:00
b215137224
Added the standard \label{module-*} for the two supporting modules.
1998-01-14 05:47:15 +00:00
8ac34c2928
Consistency: "Unix" ==> "\UNIX{}"
...
Always include the comma *inside* the \optional{} markup!
1998-01-13 22:41:33 +00:00
737e73ec3d
Augment \tableofcontents to do the right thing.
1998-01-13 22:40:08 +00:00
4d4f9e726a
Removed \mytableofcontents; just use \tableofcontents.
1998-01-13 22:25:02 +00:00
3e9ce54eff
Removed one hack!
1998-01-13 22:23:30 +00:00
a809064166
Consistency: "Unix" ==> "\UNIX{}"
1998-01-13 19:10:02 +00:00
6862b46b70
Consistency: "unix" ==> "\UNIX{}"
1998-01-13 19:03:36 +00:00
c9dc5151b6
Consistency: "unix" ==> "\UNIX{}"
...
Added \label{} for referring to the module.
1998-01-13 19:01:57 +00:00
efc1e0f43b
Consistency:
...
"Unix" ==> "\UNIX{}"
1998-01-13 19:00:33 +00:00
3f20592c3e
Consistency:
...
"Unix" ==> "\UNIX{}"
"C" ==> "\C{}"
"C++" ==> "\Cpp{}"
1998-01-13 18:56:38 +00:00
b0a78738ea
Consistency:
...
"Unix" ==> "\UNIX{}"
"C" ==> "\C{}"
"C++" ==> "\Cpp{}"
1998-01-13 18:51:10 +00:00
18f9f539f2
Removed obsolete \kwindex{} call.
...
Added "user configuration file", ".pythonrc.py file" to the index.
Made reference to site module a {seealso} environment.
1998-01-13 18:45:34 +00:00
2b67bee8e1
Added "module search path" to the index.
1998-01-13 18:35:51 +00:00
cf75754357
Removed obsolete \kwindex{} calls.
...
Added "module search path" to the index.
"Unix" ==> "\UNIX{}"
1998-01-13 18:34:40 +00:00
bc5062f664
\kwindex{}: Removed obsolete macro.
1998-01-13 18:31:39 +00:00
b5dac4e02e
&do_cmd_kwindex: Removed obsolete function.
1998-01-13 18:30:31 +00:00
8362d005cf
Added command at end to use times fonts; commented out. Instructions to use
...
times are there as well.
Doing it here means the switch only affects one file and gets everything
rebuilt as needed.
1998-01-13 17:29:31 +00:00
95810e4d18
Removed tarps2, tardvi targets based on comments from Guido.
...
Added -9 option to gzip. This doesn't save much space, but it's "free" and
appreaciated by those with slow modems. (With these tarballs, that means
"those with modems"...!)
Remove the two tarballs in the clean target.
1998-01-13 17:18:57 +00:00
657cb148c3
After discussion with Guido, agreed to only support double-sided PostScript,
...
so we'll not need this shell whackery after all.
1998-01-13 16:57:13 +00:00
dca8792b52
Added openright option the the \documentclass{} for each of the manuals.
1998-01-13 16:53:23 +00:00
33d05b9d88
Added targets:
...
tarps - one-sided PostScript
tarps2 - two-sided PostScript, with ref.ps added as-is.
tardvi - yes, some people want the .dvi files
all-ps2 - Create the .ps files, but make sure the LaTeX openright option
is used in the \documentclass.
1998-01-13 16:33:09 +00:00
bc3b1c6fce
Script to add & remove LaTeX \documentclass options. Run "./texoption.sh"
...
for usage information.
1998-01-13 16:29:08 +00:00
ab0b65d0c9
&make_mod_index_entry: Wrap a long comment, store the additional data needed
...
to create a module index in the HTML version.
1998-01-13 04:05:11 +00:00
9b6f1d24f9
Override several functions from the stock latex2html to support the module
...
index. It works, it's ugly, and would probably have to be completely redone
if we changed latex2html versions. See the comments. ;-(
On the other hand, it works. ;-)
(Wait for myformat.perl checkin as well.)
1998-01-13 04:03:02 +00:00
1af9e79708
Added support for \funcline{} and \dataline{}.
...
For all generated cases of <strong>...</strong> (from this module), change to
<b>...</b>. This, from me? This is entirely to reduce the size of the
generated markup, which is more of an issue than semantics here. Since
<strong> isn't very meaningful anyway, this should be good.
1998-01-12 23:15:29 +00:00
023f87fbf8
Lots of minor markup nits, all consistency related.
...
Consistently use trailing "()" on function / method names.
Wrapped some long lines.
1998-01-12 19:16:24 +00:00
97546399c7
Document maxsplit arg for split(), with incompatibility note about 1.5
...
release bug.
Document groups() changed behaviour (now always returns tuple).
1998-01-12 18:58:53 +00:00
054f8fd12c
Wrapped some long lines.
...
Added trailing "()" for function and method names.
Added index entries for referenced modules.
1998-01-12 18:28:20 +00:00
74947ac473
Modify command descriptions to use \optional{} instead of ad-hoc markup.
...
There are still weirdnesses, but less of them.
1998-01-12 15:38:30 +00:00
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
Fred Drake
Guido van Rossum