Commit graph

5994 commits

Author SHA1 Message Date
Raymond Hettinger
88821f7c20 Important usability fix in itertools documentation. 2003-07-22 06:33:13 +00:00
Fred Drake
f1c9869ab0 Avoid a 301 permanent redirect.
Part of SF patch #773007.

Also fixed a number of mostly cosmetic markup errors.
2003-07-22 01:09:22 +00:00
Fred Drake
644a08c735 Avoid a 301 permanent redirect.
Part of SF patch #773007.
2003-07-22 01:09:22 +00:00
Fred Drake
700c890631 Avoid a few 301 permanent redirects.
Part of SF patch #773007.
2003-07-22 00:52:42 +00:00
Fred Drake
ef13949e00 Avoid a 301 permanent redirect.
Part of SF patch #773007.
2003-07-22 00:49:11 +00:00
Fred Drake
6c4970995a Merge the old dumbdbm documetation into the new docs that have been added.
Make some module references hyperlinks.
2003-07-21 15:30:15 +00:00
Andrew M. Kuchling
0ceb9b1603 Change \code to \verb, because TeX merges the two dashes into a
hyphen, resulting in the output '-list-classifiers', not the correct
'--list-classifiers'.  I've verified that the line is now correct
in the DVI, PDF, HTML, and ASCII versions.
2003-07-21 12:49:46 +00:00
Raymond Hettinger
476fcae4d7 SF bug #774411: Typo in socket documentation 2003-07-20 01:10:15 +00:00
Andrew M. Kuchling
95be8bdab7 Add introductory paragraphs
Remove comment about MacOS changes; I'm not going to have time to figure
    out what they are
Move PEP 273 section into numeric order
2003-07-18 02:12:16 +00:00
Andrew M. Kuchling
6e73f9e5db Add a few more items 2003-07-18 01:15:51 +00:00
Andrew M. Kuchling
8744f12a2f Complete the rewrite pass; add a few more items; bump version number to 0.90; remove comment about draft status 2003-07-17 23:56:58 +00:00
Fred Drake
7a6b4f0284 more markup chages 2003-07-17 16:00:01 +00:00
Fred Drake
0106e1dd20 Include the GNU info format in the edist target since we're now
building a fair portion of the documentation as info.
2003-07-17 15:29:16 +00:00
Fred Drake
8836e567b9 - remove mention of the isprivate flag, since that isn't directly
documented here, and according to Tim, should never have been there
- misc. cleanups for consistency
2003-07-17 15:22:47 +00:00
Raymond Hettinger
943277ecd3 Minor corrections. 2003-07-17 14:47:12 +00:00
Fred Drake
de7cdb26d1 - put the GNU info packages in the same place as everything else
- add a convenience target to create the package list directly
2003-07-17 11:55:18 +00:00
Fred Drake
e5f15ff8cb - update the list of documents for which GNU info is built
- convert tabs to spaces
2003-07-17 05:36:19 +00:00
Fred Drake
7262ca8abf Bump version numbers. 2003-07-17 05:30:38 +00:00
Fred Drake
ea690c4b25 - improve the description of how user-defined method
objects get made
  - improve the description of attribute retrieval from
    classes and class instances
  - add brief documentation of static method and
    class method objects.
2003-07-17 05:26:53 +00:00
Fred Drake
38d7c1bb78 Note that Unicode strings are now supported in sys.path.
SF patch #764594.
2003-07-17 04:22:44 +00:00
Fred Drake
e8e241b732 Make the howto document class work properly with the pypaper.sty
paper-size hook.
SF patch #772550.
2003-07-17 04:15:35 +00:00
Skip Montanaro
bfa6872260 Zap the C API subsection altogether for now. It's not actually usable from
C yet anyway.
2003-07-16 21:14:35 +00:00
Andrew M. Kuchling
aa9b39f910 Mention list.index; more small textual changes 2003-07-16 20:37:26 +00:00
Andrew M. Kuchling
c760c6c442 Add reminder list of things to document; mention sys.getcheckinterval() and socket.timeout exception 2003-07-16 20:12:33 +00:00
Skip Montanaro
2491cd98c4 expose the C API subsection which was hidden from LaTeX in a comment. In
the info conversion the \comment LaTeX macro mapped to a Texinfo @ignore
macro.  Unfortunately, py2texi.el is not smart enough to avoid generating
links to the @ignore'd section, which causes makeinfo to croak.

Exposing this text is probably not the most correct thing to do, as this
documentation really belongs in the C API manual.  This does get the info
files generated, however, which is a more practical goal considering the
impending release of 2.3rc1.
2003-07-16 19:46:07 +00:00
Raymond Hettinger
4d6e8fe5d1 Clarify the lack of relationship between rich comparison operators.
Prompted by a discussion on comp.lang.python.
2003-07-16 19:40:23 +00:00
Raymond Hettinger
71adf7e9d8 Doctest now examines all docstrings by default. Previously, it would
skip over functions with private names (as indicated by the underscore
naming convention).  The old default created too much of a risk that
user tests were being skipped inadvertently.  Note, this change could
break code in the unlikely case that someone had intentionally put
failing tests in the docstrings of private functions.  The breakage
is easily fixable by specifying the old behavior when calling testmod()
or Tester().  The more likely case is that the silent failure was
unintended and that the user needed to be informed so the test could be
fixed.
2003-07-16 19:25:22 +00:00
Fred Drake
853276e16d Lots of markup cleanups to avoid warnings from the GNU info generation;
these make sense even without that processing chain.
2003-07-16 17:58:38 +00:00
Fred Drake
788617f8f0 Remove \versionchanged; the text was too complex for the GNU info
conversion to support.  Keep the content as normal content, with a
note that this applies starting in Python 2.3.
2003-07-16 16:19:08 +00:00
Andrew M. Kuchling
2cd773160d Minor text changes; update bug/patch count (quite a jump!) 2003-07-16 14:44:12 +00:00
Fred Drake
bd5fdd93a9 Make it easier to figure out the where a menuselection starts and ends
by controling the font.
2003-07-16 14:01:56 +00:00
Fred Drake
a66b6c1267 Cygwin instructions:
- added missing period
- added markup so it's easier to tell which names are special
2003-07-16 13:50:28 +00:00
Fred Drake
d24c767d5b A variety of markup-level adjustments. 2003-07-16 05:17:23 +00:00
Raymond Hettinger
46f681cc07 Discussion of signatures for unicode.translate() and str.translate()
were in the wrong file.  Moved out of libstring.tex and into
libstdtypes.tex.
2003-07-16 05:11:27 +00:00
Fred Drake
6c85bcb2aa - update some comments
- add support for the "What's New" document
- add short aliases for individual documents; nice for debugging
  conversions
2003-07-16 04:02:58 +00:00
Fred Drake
fa00f91897 Pass along the selected "What's New" document to the make file for the
GNU info conversion.
2003-07-16 04:01:04 +00:00
Fred Drake
15b3dba85e Adjust description of the internationalized domain name encoding to
better accomodate the GNU info conversion.
2003-07-16 04:00:14 +00:00
Fred Drake
0bb242b67c Map \envvar to the TeXinfo equivalent, @env. 2003-07-16 03:44:48 +00:00
Fred Drake
850026308b Simple support for the alltt environment. 2003-07-16 03:35:41 +00:00
Fred Drake
3605ae5966 In the description of enumerate(), the indexing operators should not
be included in the \var.  This produced weird results in general, but
broke the GNU info conversion.
2003-07-16 03:26:31 +00:00
Fred Drake
7769bb9224 Teach this script about \AA and \aa (the Scandanavian A-ring
characters); \AA is used in whatsnew23.tex.
2003-07-16 03:16:34 +00:00
Raymond Hettinger
b233e54409 Nits. 2003-07-15 23:16:01 +00:00
Fred Drake
d51ce7de97 Indexing is a mess; try to get the link targets closer to the relevant
text.  There needs to be a better way.
2003-07-15 22:03:00 +00:00
Fred Drake
4e72e0533d process_commands_wrap_deferred:
- fix comment describing what this is for
  - add lots of indexing macros to this call
Closes SF bug #518989.
2003-07-15 22:00:36 +00:00
Fred Drake
b3be52eaf4 Try to clean up some indexing relevant to the import statement.
Pertains to SF bug #518989.
2003-07-15 21:37:58 +00:00
Fred Drake
e37b4ed24e Discuss calling new-style types.
Closes SF bug #453683.
2003-07-15 20:45:16 +00:00
Fred Drake
d9cf8e7e7c Markup consistency nits. 2003-07-14 21:07:05 +00:00
Fred Drake
9753ae1237 Added missing markup. 2003-07-14 20:53:57 +00:00
Raymond Hettinger
708c2a877e Fix unbalanced parenthesis in text. 2003-07-14 18:36:47 +00:00
Raymond Hettinger
0e53d234eb Fix missing parenthesis 2003-07-14 18:24:26 +00:00