847207acff
SF bug #719367 , string exceptions are deprecated
...
Remove references to string based exceptions in the doc.
2003-05-29 02:17:23 +00:00
36a4d8c20e
Remove mentionings of DOS.
2002-10-10 18:24:54 +00:00
d80032b009
Update some comments about what version of the documentation tools
...
code to use.
2002-09-25 21:41:22 +00:00
e134158f23
Finish & commit some docs for markup that's been in use for a while.
2002-09-25 18:44:21 +00:00
b8c20a723f
More updates describing FutureWarnings.
2002-08-14 16:40:54 +00:00
8b46c71d5b
Typo fix.
2002-06-29 01:23:45 +00:00
f79f2f94d5
Add additional comments on the use of \deprecated.
2002-05-21 16:27:20 +00:00
77c18951fb
Remove the warning about the Cygwin directions not working -- the latest
...
change to Doc/tools/node2label.pl (revision 1.13) makes this work.
2002-05-02 21:10:48 +00:00
eb2b8334d5
Added some notes on setting up the documentation tools on Cygwin.
2002-05-01 22:05:30 +00:00
176bda4cde
fix duplicate label
...
add index turds
2002-04-19 04:50:44 +00:00
1251b0eb24
Document the cmemberdesc environment.
2002-04-15 20:10:23 +00:00
79bf99c505
Document the \csimplemacro macro and the csimplemacrodesc environment.
2002-04-09 20:17:42 +00:00
e789ea19c1
Extend the list of special characters and magic markup used to produce them
...
to include various characters used in code samples, URLs, and other special
contexts.
This closes SF bug #525684 .
2002-03-13 02:48:24 +00:00
d6bdb075ca
Update the list of output formats.
2002-01-17 12:35:20 +00:00
6ca33771f8
Add a new environment for whole-paragraph (or longer) notes & warnings.
2001-12-14 22:50:06 +00:00
5ed35fd149
Add a new environment in the Python docs markup: seealso*. This is similar
...
to seealso, but does not add the "See also:" header or put the content in a
box in the HTML version.
Updated the description of \seeurl to better indicate when it should be used;
the old description was written before we had \seetitle.
2001-11-30 18:09:54 +00:00
64a5aaf05c
Describe the content given as the parameter to the \note and \warning macros
...
in more detail, and use them where appropriate.
2001-10-20 04:18:14 +00:00
92350b3a1f
New markup: \note{...} and \warning{...}
2001-10-09 18:01:23 +00:00
203d91a461
Note that the colon following a mail header name should not be included
...
when using the \mailheader markup.
Change a couple of inline examples to show the markup rather than the
result.
2001-09-26 18:43:20 +00:00
8b3a7b58b9
Move the \mailheader description to the right place.
...
Clarify the \mimetype description; it can be used to refer to a part of a
MIME type name, so \mimetype{text} or \mimetype{plain} can be used, not
just \mimetype{text/plain}.
2001-09-26 17:01:58 +00:00
f9dc04341d
Fix a minor markup typo.
2001-08-29 02:34:10 +00:00
b5f17f2dc5
Revise comments about TeX & LaTeX for accuracy.
...
This closes SF bug #456222 .
2001-08-28 18:09:11 +00:00
0cac5f697b
Added some examples of table markup.
2001-08-14 21:36:19 +00:00
7eac0cb04c
Define the \mailheader macro and document conventions for using it.
2001-08-03 18:36:17 +00:00
f1b3de8d5c
Add labels to all \section and \subsection headings for use in references.
2001-07-24 14:38:34 +00:00
f269e59232
Define new markup for 5-column tables.
2001-07-17 23:05:57 +00:00
9120df388c
Add a little more information about the usage of some terms where the
...
style guide can use a little clarification, and present some minor
specific markup.
Make a few adjustments to conform to the style guide.
2001-07-14 02:34:12 +00:00
07178d237a
For \kbd, be more prescriptive regarding how keystrokes should be
...
written.
2001-07-12 02:08:29 +00:00
67f193faab
Add a little bit more about the XML migration plan. This still needs a lot
...
of work, but mostly it needs time spent doing the work to make the
generated XML useful.
2001-07-09 16:04:03 +00:00
432cef0d0b
Add new material on some markup that will be checked in shortly. This
...
includes some minor new inline markup and markup to generate hyperlinked
grammar productions.
Adopt a "style guide" document -- this beats writing our own and means
we'll have a chance at consistency, without having to make it all up
ourselves.
2001-07-06 22:34:33 +00:00
66eed24415
Add some information on the use of \verbatiminput to display sources from
...
an external file.
2001-06-18 14:59:58 +00:00
9f2376de7a
Document the new classdesc* environment, and the previously undocumented
...
excclassdesc environment.
2001-05-11 01:01:12 +00:00
3151f44d49
Add description of the "explanation" optional parameter added to the
...
\versionadded macro.
Note: this should not be merged into the 2.1 maintenance branch.
2001-04-18 05:19:06 +00:00
4c6f17a537
Make a number of small clarifications and correct a whole bunch of typos,
...
all reported by Bruce Smith.
2001-04-18 05:12:47 +00:00
2bbc6974d0
Fix a number of small issues; this closes SF bug #411063 .
2001-03-28 16:51:20 +00:00
b7a52c9de3
Minor typo: \subsubsections --> \subsubsection
2000-11-27 20:10:18 +00:00
8fdb6383dc
Update author information.
2000-10-28 04:08:38 +00:00
d097d48200
Flesh out the "LaTeX Primer" some more.
2000-10-20 20:51:31 +00:00
63568aa9bb
Revise the capitalization policy of \versionchanged explanation; the
...
explanation must now be capitalized. This is more consistent with the
\see* explanation fields.
Added a lot of material to the "LaTeX Primer" section.
2000-10-19 05:36:10 +00:00
da72b93a01
Add new environments: longtableii, longtableiii, and longtableiv, to
...
support long tables which might break across page boundaries. Otherwise
identical to tableii, tableiii, and tableiv.
2000-09-21 15:58:02 +00:00
02997491c1
Document directories are not always named with three characters any more;
...
reported by Detlef Lannert <lannert@uni-duesseldorf.de>.
2000-09-21 05:26:43 +00:00
7be440da1a
Document \cfuncdesc, \ctypedesc, and \cvardesc.
2000-09-16 21:23:25 +00:00
6a547c7878
Fix a link -- there is no starship.python.org!
2000-09-15 22:11:24 +00:00
af2b71466a
\shortversion,
...
\setshortversion: New markup to help deal with Python having a "real"
version number and an abbreviated version number
used to create pathnames to the library installation.
2000-09-14 20:11:05 +00:00
b7cf378023
Add note that the various \see* macros are only defined in the context
...
of a seealso environment.
2000-09-12 19:58:10 +00:00
48449985f4
\seetitle: New macro for building reference list content.
2000-09-12 17:52:33 +00:00
08c5d0cdcb
Add documentation for the \pep and \seepep macros.
2000-09-11 05:22:30 +00:00
31edf4defb
Wrap some long lines.
...
Note that \file and \filenq do not work inside section titles.
2000-09-07 20:06:07 +00:00
7932ed0ac4
Added material about documenting packages, so that the use of module
...
markup for packages is clear.
2000-08-11 17:37:33 +00:00
1cb3a9ecef
Add entries for the distutils documents to the directories table.
2000-07-25 19:27:17 +00:00
Neal Norwitz
Martin v. Löwis
Fred Drake
Barry Warsaw
Greg Ward
Skip Montanaro