Commit graph

6527 commits

Author SHA1 Message Date
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
Skip Montanaro
7233117960 update norobots link 2003-07-14 17:04:50 +00:00
Skip Montanaro
a2d3d93ee3 + libdumdbm 2003-07-14 12:13:27 +00:00
Skip Montanaro
0f59b54f32 + libdumbdbm 2003-07-14 12:12:56 +00:00
Skip Montanaro
d54c5ddd28 minimal dumdbm module doc 2003-07-14 12:12:37 +00:00
Raymond Hettinger
9bb33868af SF bug #738090: Section 13.3: htmllib.HTMLParser constructor definition
amendment

Add a clarifying cross-reference to the formatter module.
2003-07-14 08:15:47 +00:00
Raymond Hettinger
5c5fca9844 SF bug #706546: u''.translate not documented
Clarified the difference between translate methods for string objects and
Unicode objects.
2003-07-13 02:06:47 +00:00
Raymond Hettinger
627273733f SF bug #770107: Typo in documentation of resource module 2003-07-13 00:46:40 +00:00
Martin v. Löwis
162f081fb3 Patch 549151, rev4: redirect posts for 301 also. Will backport to 2.2. 2003-07-12 07:33:32 +00:00
Raymond Hettinger
a685f52256 Fix missing parenthesis 2003-07-12 04:42:30 +00:00
Raymond Hettinger
6122d0267f SF patch #726751: Clarify docs for except target assignment
Brett found that the tutorial didn't really explain what was happening
with exception targets.  Hopefully, this sheds some light on the subject.
2003-07-12 01:05:37 +00:00
Raymond Hettinger
92f21b13ea Document Jim Fulton's docttest extensions. 2003-07-11 22:32:18 +00:00
Raymond Hettinger
fa6cce1fdd Minor fixups and added sections for iterators and generators. 2003-07-11 18:58:11 +00:00
Fred Drake
e7f343d0f1 normalize whitespace 2003-07-11 03:36:15 +00:00
Fred Drake
192b95bb6c update the reference to the Apple Publications Style Guide 2003-07-11 03:34:17 +00:00
Raymond Hettinger
9de3c21865 SF #767592: unittest docs don't suggest "unittest.main()"
Expanded docs to have a quick start example showing how
to create and run tests.
2003-07-10 22:14:41 +00:00
Fred Drake
7adcfad4c2 fix stupid typo 2003-07-10 17:04:45 +00:00
Raymond Hettinger
8ccf4d751d Missing markup. 2003-07-10 15:48:33 +00:00