cpython/Doc/lib
Barry Warsaw 00decd7835 Patch #1520294: Support for getset and member descriptors in types.py,
inspect.py, and pydoc.py.  Specifically, this allows for querying the type of
an object against these built-in C types and more importantly, for getting
their docstrings printed in the interactive interpreter's help() function.

This patch includes a new built-in module called _types which provides
definitions of getset and member descriptors for use by the types.py module.
These types are exposed as types.GetSetDescriptorType and
types.MemberDescriptorType.  Query functions are provided as
inspect.isgetsetdescriptor() and inspect.ismemberdescriptor().  The
implementations of these are robust enough to work with Python implementations
other than CPython, which may not have these fundamental types.

The patch also includes documentation and test suite updates.

I commit these changes now under these guiding principles:

1. Silence is assent.  The release manager has not said "no", and of the few
   people that cared enough to respond to the thread, the worst vote was "0".

2. It's easier to ask for forgiveness than permission.

3. It's so dang easy to revert stuff in svn, that you could view this as a
   forcing function. :)

Windows build patches will follow.
2006-07-27 23:43:15 +00:00
..
sqlite3 Text files missing the SVN eol-style property. 2006-05-16 23:24:08 +00:00
archiving.tex Add some chapter introductions (not linked into the LibRef yet) 2005-12-22 20:12:39 +00:00
asttable.tex George Yoshida points out that the special characters 2006-02-28 17:46:48 +00:00
caseless.py
compiler.tex More \exception fixes. 2006-03-17 16:26:31 +00:00
custominterp.tex Add more chapter intros 2005-12-22 20:27:43 +00:00
datatypes.tex Add some chapter introductions (not linked into the LibRef yet) 2005-12-22 20:12:39 +00:00
development.tex Add more chapter intros 2005-12-22 20:27:43 +00:00
distutils.tex
email-dir.py Merge email package 4.0 from the sandbox, including documentation, test cases, 2006-03-18 15:41:53 +00:00
email-mime.py Merge email package 4.0 from the sandbox, including documentation, test cases, 2006-03-18 15:41:53 +00:00
email-simple.py Merge email package 4.0 from the sandbox, including documentation, test cases, 2006-03-18 15:41:53 +00:00
email-unpack.py Merge email package 4.0 from the sandbox, including documentation, test cases, 2006-03-18 15:41:53 +00:00
email.tex More RFC 2231 improvements for the email 4.0 package. As Mark Sapiro rightly 2006-07-21 14:51:07 +00:00
emailcharsets.tex Merge email package 4.0 from the sandbox, including documentation, test cases, 2006-03-18 15:41:53 +00:00
emailencoders.tex Merge email package 4.0 from the sandbox, including documentation, test cases, 2006-03-18 15:41:53 +00:00
emailexc.tex Merge email package 4.0 from the sandbox, including documentation, test cases, 2006-03-18 15:41:53 +00:00
emailgenerator.tex Merge email package 4.0 from the sandbox, including documentation, test cases, 2006-03-18 15:41:53 +00:00
emailheaders.tex Merge email package 4.0 from the sandbox, including documentation, test cases, 2006-03-18 15:41:53 +00:00
emailiter.tex Merge email package 4.0 from the sandbox, including documentation, test cases, 2006-03-18 15:41:53 +00:00
emailmessage.tex Merge email package 4.0 from the sandbox, including documentation, test cases, 2006-03-18 15:41:53 +00:00
emailmimebase.tex Merge email package 4.0 from the sandbox, including documentation, test cases, 2006-03-18 15:41:53 +00:00
emailparser.tex Merge email package 4.0 from the sandbox, including documentation, test cases, 2006-03-18 15:41:53 +00:00
emailutil.tex Merge email package 4.0 from the sandbox, including documentation, test cases, 2006-03-18 15:41:53 +00:00
fileformats.tex Add some chapter introductions (not linked into the LibRef yet) 2005-12-22 20:12:39 +00:00
filesys.tex Add some chapter introductions (not linked into the LibRef yet) 2005-12-22 20:12:39 +00:00
frameworks.tex Add more chapter intros 2005-12-22 20:27:43 +00:00
i18n.tex Add some chapter introductions (not linked into the LibRef yet) 2005-12-22 20:12:39 +00:00
internet.tex
ipc.tex Add some chapter introductions (not linked into the LibRef yet) 2005-12-22 20:12:39 +00:00
language.tex Typo fix 2005-12-22 18:55:43 +00:00
lib.tex If binhex is higher-level than binascii, it should come first in the chapter 2006-07-27 19:12:49 +00:00
libaifc.tex
libal.tex
liballos.tex
libamoeba.tex
libanydbm.tex
libarray.tex More \exception fixes. 2006-03-17 16:26:31 +00:00
libascii.tex
libast.tex fix sectioning: cannot skip section levels 2006-03-31 05:28:38 +00:00
libasynchat.tex
libasyncore.tex fixed example: 2006-01-17 21:31:31 +00:00
libatexit.tex
libaudioop.tex SF [ 1231053 ] audioop - alaw encoding/decoding added, code updated 2006-03-20 05:21:58 +00:00
libbase64.tex Add example 2006-07-27 22:49:54 +00:00
libbasehttp.tex Patch #1417555: SimpleHTTPServer now returns Last-Modified headers. 2006-02-17 13:34:16 +00:00
libbastion.tex
libbinascii.tex Mention base64 module; rewrite last sentence to be more positive 2006-07-27 19:11:07 +00:00
libbinhex.tex
libbisect.tex
libbltin.tex
libbsddb.tex minor documentation cleanup. mention the bsddb.db interface explicitly by name. 2006-06-15 09:23:52 +00:00
libbz2.tex
libcalendar.tex Make firstweekday a simple attribute instead 2006-04-01 20:40:23 +00:00
libcd.tex
libcfgparser.tex
libcgi.tex More \exception fixes. 2006-03-17 16:26:31 +00:00
libcgihttp.tex
libcgitb.tex
libchunk.tex
libcmath.tex
libcmd.tex Remove dots in \version{changed,added} argument and 2006-01-15 07:55:35 +00:00
libcmp.tex
libcmpcache.tex
libcode.tex
libcodecs.tex Correct the grammar 2006-04-21 16:34:17 +00:00
libcodeop.tex avoid ugly markup based on the unfortunate conversions of ">>" and "<<" to 2006-05-03 02:04:40 +00:00
libcollections.tex Typo fixes 2006-04-22 15:10:49 +00:00
libcolorsys.tex
libcommands.tex
libcompileall.tex
libconsts.tex
libcontextlib.tex Get rid of a couple more context object references, fix some markup and clarify what happens when a generator context function swallows an exception. 2006-05-03 13:17:49 +00:00
libcookie.tex Correct typos and markup errors (Raymond, thanks for texcheck) 2006-01-23 21:33:03 +00:00
libcookielib.tex Fix RFC number. 2006-07-07 08:15:12 +00:00
libcopy.tex - Patch 1433928: 2006-02-25 22:38:04 +00:00
libcopyreg.tex
libcrypt.tex
libcrypto.tex Update text 2005-12-22 19:38:57 +00:00
libcsv.tex Change the example classes UnicodeReader and UnicodeWriter so 2006-04-04 17:32:49 +00:00
libctypes.tex Updates for the ctypes documentation. 2006-07-14 18:22:50 +00:00
libcurses.tex
libcursespanel.tex Bug #1484978: curses.panel: clarify that Panel objects are destroyed on garbage collection. 2006-05-10 16:11:44 +00:00
libdatetime.tex Bug #1459103: add inter-section links for strftime section. 2006-03-28 12:48:43 +00:00
libdbhash.tex
libdbm.tex
libdecimal.tex Fix two small errors in argument lists. 2006-05-10 20:09:23 +00:00
libdifflib.tex SequenceMatcher.get_matching_blocks(): This now guarantees that 2006-06-14 04:09:25 +00:00
libdircache.tex
libdis.tex one more place to avoid extra markup (how many will there be?) 2006-05-03 02:29:09 +00:00
libdl.tex Correct typos and markup errors (Raymond, thanks for texcheck) 2006-01-23 21:33:03 +00:00
libdoctest.tex Remove doctest.testmod's deprecated (in 2.4) isprivate 2006-06-05 01:43:03 +00:00
libdocxmlrpc.tex
libdumbdbm.tex
libdummythread.tex
libdummythreading.tex
liberrno.tex
libetree.tex Patch #1504046: Add documentation for xml.etree. 2006-07-10 02:36:41 +00:00
libexcs.tex Document ImportWarning 2006-05-16 18:26:10 +00:00
libfcntl.tex
libfilecmp.tex
libfileinput.tex Fix typpo. 2006-02-19 20:08:18 +00:00
libfl.tex
libfm.tex
libfnmatch.tex
libformatter.tex
libfpectl.tex
libfpformat.tex
libftplib.tex
libfuncs.tex no need to elaborate "string". 2006-07-05 15:50:05 +00:00
libfunctools.tex Add functools.update_wrapper() and functools.wraps() as described in PEP 356 2006-06-08 13:54:49 +00:00
libfuture.tex Typo 2006-01-22 16:11:01 +00:00
libgc.tex Markup fix 2006-03-17 15:56:13 +00:00
libgdbm.tex
libgetopt.tex add missing version identification 2006-01-20 03:30:36 +00:00
libgetpass.tex Use \versionchanged instead of \versionadded for new parameter support. 2006-04-30 03:49:56 +00:00
libgettext.tex Patch #1349274: gettext.install() now optionally installs additional 2006-02-19 13:26:36 +00:00
libgl.tex
libglob.tex
libgopherlib.tex Add deprecation notices to modules deprecated since 2000. 2006-02-17 11:18:58 +00:00
libgrp.tex patch [ 1274630 ] documentation fixes 2005-08-27 17:04:58 +00:00
libgzip.tex
libhashlib.tex Grammar fix 2006-04-02 01:47:38 +00:00
libheapq.tex
libhmac.tex [ sf.net patch # 1121611 ] 2005-08-21 18:45:59 +00:00
libhotshot.tex Added the cProfile module. 2006-02-08 12:53:56 +00:00
libhtmllib.tex
libhtmlparser.tex avoid ugly markup based on the unfortunate conversions of ">>" and "<<" to 2006-05-03 02:04:40 +00:00
libhttplib.tex Move "httpresponses" dict from urllib2 to httplib where it belongs. 2006-02-17 19:17:25 +00:00
libimageop.tex
libimaplib.tex Add versionadded note for new methods 2006-02-07 07:23:26 +00:00
libimgfile.tex
libimghdr.tex
libimp.tex
libinspect.tex Patch #1520294: Support for getset and member descriptors in types.py, 2006-07-27 23:43:15 +00:00
libintro.tex
libitertools.tex Guarantee evaluation order for izip(). Document its creative uses and its limitations. 2006-03-26 01:41:25 +00:00
libjpeg.tex
libkeyword.tex
liblinecache.tex Forgot to mark up a PEP reference 2006-04-11 01:15:28 +00:00
liblocale.tex Patch #1180296: improve locale string formatting functions 2006-05-17 15:51:16 +00:00
liblogging.tex markup fix 2006-07-20 20:11:57 +00:00
libmailbox.tex Reword paragraph 2006-07-27 22:40:05 +00:00
libmailcap.tex
libmain.tex
libmarshal.tex
libmath.tex
libmd5.tex [ 1388141 ] Minor error in md5 docs 2005-12-22 16:15:00 +00:00
libmhlib.tex
libmimetools.tex
libmimetypes.tex Add example 2006-07-27 22:49:38 +00:00
libmimewriter.tex
libmimify.tex
libmisc.tex
libmm.tex
libmmap.tex Patch #1407135, bug #1424041, make mmap.mmap(-1, length) work the same 2006-02-05 05:45:43 +00:00
libmodulefinder.tex added a few missing \versionadded{2.3} tags 2006-01-11 00:14:29 +00:00
libmsilib.tex Correct some formulations, fix XXX comments. 2006-05-03 04:52:04 +00:00
libmsvcrt.tex
libmultifile.tex Document "multifile" as deprecated. 2006-02-21 19:23:49 +00:00
libmutex.tex
libnetrc.tex
libnew.tex SF bug #1323294, Minor error in the Library Reference doc. Will backport 2005-10-11 03:23:45 +00:00
libni.tex
libnis.tex Patch #1422385: Changes to nis module to support multiple NIS domains 2006-02-04 19:12:37 +00:00
libnntplib.tex More \exception fixes. 2006-03-17 16:26:31 +00:00
libobjs.tex
liboperator.tex avoid ugly markup based on the unfortunate conversions of ">>" and "<<" to 2006-05-03 02:04:40 +00:00
liboptparse.tex Resync optparse with Optik 1.5.3: minor tweaks for/to tests. 2006-07-23 16:05:51 +00:00
libos.tex Correct implementation and documentation of os.confstr. Add a simple test 2006-04-20 01:29:48 +00:00
libossaudiodev.tex More \exception fixes. 2006-03-17 16:26:31 +00:00
libpanel.tex
libparser.tex
libpdb.tex Grammar fix 2006-05-11 15:53:27 +00:00
libpickle.tex Bug #1102649: add a note to pickle docs that pickle files should be 2006-02-20 13:12:02 +00:00
libpickletools.tex added a few missing \versionadded{2.3} tags 2006-01-11 00:14:29 +00:00
libpipes.tex Correct misspellings. 2006-01-23 22:00:17 +00:00
libpkgutil.tex
libplatform.tex
libpopen2.tex
libpoplib.tex bug [ 1252706 ] poplib list() docstring fix (and docs too) 2005-08-05 21:01:58 +00:00
libposix.tex
libposixfile.tex
libposixpath.tex Bug #1475009: clarify ntpath.join behavior with absolute components 2006-04-28 16:36:55 +00:00
libpprint.tex pprint functions used to sort a dict (by key) if and only if 2006-06-02 23:22:51 +00:00
libprofile.tex Bug #1482988: indicate more prominently that the Stats class is in the pstats module. 2006-05-10 15:59:06 +00:00
libpty.tex
libpwd.tex
libpyclbr.tex
libpycompile.tex More \exception fixes. 2006-03-17 16:26:31 +00:00
libpydoc.tex
libpyexpat.tex Patch #1377848: typo in pyexpat docs 2005-12-16 19:23:33 +00:00
libpython.tex
libqueue.tex SF Patch #1455676: Simplify using Queues with daemon consumer threads 2006-03-24 20:43:29 +00:00
libquopri.tex
librandom.tex Add punctuation mark; add some examples 2006-07-27 19:07:29 +00:00
libre.tex More \exception fixes. 2006-03-17 16:26:31 +00:00
libreadline.tex
librepr.tex
libresource.tex
librestricted.tex
librexec.tex
librfc822.tex
librgbimg.tex Add deprecation notices to modules deprecated since 2000. 2006-02-17 11:18:58 +00:00
librlcompleter.tex Patch #1472854: make the rlcompleter.Completer class usable on non- 2006-04-30 18:14:54 +00:00
librobotparser.tex
librunpy.tex Revert the __module_name__ changes made in rev 47142. We'll revisit this in Python 2.6 2006-07-06 12:53:04 +00:00
libsched.tex
libselect.tex
libsets.tex More \exception fixes. 2006-03-17 16:26:31 +00:00
libsgi.tex
libsgmllib.tex SF patch 1504676: Make sgmllib char and entity references pluggable 2006-06-16 23:45:06 +00:00
libsha.tex [ sf.net patch # 1121611 ] 2005-08-21 18:45:59 +00:00
libshelve.tex bug [ 1248199 ] shelve .sync operation not documented 2005-08-25 22:40:16 +00:00
libshlex.tex bug [ 1298120 ] shlex does not support unicode 2005-09-29 20:24:06 +00:00
libshutil.tex More \exception fixes. 2006-03-17 16:26:31 +00:00
libsignal.tex Patch #1462496: typo in libsignal.tex 2006-04-01 07:42:41 +00:00
libsimplehttp.tex Patch #1417555: SimpleHTTPServer now returns Last-Modified headers. 2006-02-17 13:34:16 +00:00
libsimplexmlrpc.tex [Bug #1473048] 2006-05-31 14:08:48 +00:00
libsite.tex The site module documentation also described the Windows behaviour incorrectly. 2006-06-12 08:27:13 +00:00
libsmtpd.tex
libsmtplib.tex
libsndhdr.tex
libsocket.tex [Bug #1475554] Strengthen text to say 'must' instead of 'should' 2006-06-03 18:33:35 +00:00
libsocksvr.tex bug [ 957505 ] SocketServer module documentation misleading 2005-07-18 07:38:44 +00:00
libsomeos.tex
libspwd.tex patch [ 1274630 ] documentation fixes 2005-08-27 17:04:58 +00:00
libsqlite3.tex Updated documentation for pysqlite 2.3.0 API. 2006-06-13 22:53:48 +00:00
libstat.tex
libstatvfs.tex
libstdtypes.tex [Bug #1515932] Clarify description of slice assignment 2006-07-03 14:07:30 +00:00
libstdwin.tex
libstring.tex
libstringio.tex Add example 2006-07-27 18:37:33 +00:00
libstringprep.tex added a few missing \versionadded{2.3} tags 2006-01-11 00:14:29 +00:00
libstrings.tex
libstruct.tex
libsubprocess.tex Bug #1223937: CalledProcessError.errno -> CalledProcessError.returncode. 2006-07-14 14:04:45 +00:00
libsun.tex
libsunau.tex
libsunaudio.tex
libsymbol.tex
libsys.tex typo 2006-07-14 21:45:48 +00:00
libsyslog.tex
libtabnanny.tex
libtarfile.tex Patch #1484695: Update the tarfile module to version 0.8. This fixes 2006-05-10 16:26:03 +00:00
libtelnetlib.tex
libtempfile.tex
libtermios.tex
libtest.tex
libtextwrap.tex Bug #1361643: fix textwrap.dedent() so it handles tabs appropriately, 2006-06-11 00:40:49 +00:00
libthread.tex Patch #1454481: Make thread stack size runtime tunable. 2006-06-13 15:04:24 +00:00
libthreading.tex Patch #1454481: Make thread stack size runtime tunable. 2006-06-13 15:04:24 +00:00
libtime.tex Fix bug #1520914. Starting in 2.4, time.strftime() began to check the bounds 2006-07-18 04:41:36 +00:00
libtimeit.tex
libtoken.tex
libtokenize.tex Add \exception markup 2006-05-13 06:53:31 +00:00
libtrace.tex avoid ugly markup based on the unfortunate conversions of ">>" and "<<" to 2006-05-03 02:04:40 +00:00
libtraceback.tex Patch #1376914: traceback.format_exc() has no "file" argument 2005-12-16 19:21:05 +00:00
libtty.tex
libturtle.tex Patch #1519566: Remove unused _tofill member. 2006-07-10 22:11:28 +00:00
libtypes.tex Patch #1520294: Support for getset and member descriptors in types.py, 2006-07-27 23:43:15 +00:00
libundoc.tex Remove the lib-old modules from Doc/lib/libundoc.tex. 2006-03-17 18:47:14 +00:00
libunicodedata.tex Update URL; add example 2006-07-27 18:53:33 +00:00
libunittest.tex Fix markup glitch in unittest docs. Will backport. 2006-04-25 12:28:56 +00:00
libunix.tex
liburllib.tex Bug #947571: By default, urllib.urlopen() does not raise IOErrors 2006-02-20 21:26:18 +00:00
liburllib2.tex Minor rewording 2006-06-03 18:43:24 +00:00
liburlparse.tex Patch #624325: urlparse.urlparse() and urlparse.urlsplit() results 2006-04-01 22:14:43 +00:00
libuser.tex
libuserdict.tex
libuu.tex
libuuid.tex [Bug #1508766] Add docs for uuid module; docs written by George Yoshida, with minor rearrangements by me. 2006-06-28 14:25:20 +00:00
libwarnings.tex Cover ImportWarning, PendingDeprecationWarning and simplefilter() in the warnings module docs 2006-07-06 13:41:34 +00:00
libwave.tex
libweakref.tex SF #1479988: add methods to allow access to weakrefs for the 2006-05-02 06:53:59 +00:00
libwebbrowser.tex Try to resolve the remaining webbrowser issues (backgrounding, local urls) 2006-01-20 21:03:35 +00:00
libwhichdb.tex
libwinreg.tex Correct typos and markup errors (Raymond, thanks for texcheck) 2006-01-23 21:33:03 +00:00
libwinsound.tex
libwsgiref.tex Add versionadded to doc 2006-06-11 05:45:47 +00:00
libxdrlib.tex
libxmllib.tex
libxmlrpclib.tex Mention the xmlrpclib.Error base class, which is used in one of the examples 2006-04-27 12:42:54 +00:00
libzipfile.tex Update url. 2006-06-17 16:39:13 +00:00
libzipimport.tex Update url. 2006-06-17 16:39:13 +00:00
libzlib.tex Patch #1435422: zlib's compress and decompress objects now have a 2006-05-16 07:38:27 +00:00
markup.tex document xmlcore (still minimal; needs mention in each of the xml.* modules) 2006-07-17 05:47:52 +00:00
mimelib.tex Merge email package 4.0 from the sandbox, including documentation, test cases, 2006-03-18 15:41:53 +00:00
minidom-example.py
modules.tex Add more chapter intros 2005-12-22 20:27:43 +00:00
netdata.tex
numeric.tex Add some chapter introductions (not linked into the LibRef yet) 2005-12-22 20:12:39 +00:00
persistence.tex Add some chapter introductions (not linked into the LibRef yet) 2005-12-22 20:12:39 +00:00
required_1.py
required_2.py
tkinter.tex Correct misspellings. 2006-01-23 22:00:17 +00:00
tzinfo-examples.py
windows.tex
xmldom.tex
xmldomminidom.tex More \exception fixes. 2006-03-17 16:26:31 +00:00
xmldompulldom.tex typo 2006-01-09 22:01:18 +00:00
xmletree.tex r1076@spiff: Fredrik | 2005-12-12 22:32:28 +0100 2005-12-12 21:59:44 +00:00
xmlsax.tex
xmlsaxhandler.tex Bug #1397205: doc typo 2006-01-10 21:37:26 +00:00
xmlsaxreader.tex
xmlsaxutils.tex