cpython/Misc
Tim Peters 1fc240e851 Generalize dictionary() to accept a sequence of 2-sequences. At the
outer level, the iterator protocol is used for memory-efficiency (the
outer sequence may be very large if fully materialized); at the inner
level, PySequence_Fast() is used for time-efficiency (these should
always be sequences of length 2).

dictobject.c, new functions PyDict_{Merge,Update}FromSeq2.  These are
wholly analogous to PyDict_{Merge,Update}, but process a sequence-of-2-
sequences argument instead of a mapping object.  For now, I left these
functions file static, so no corresponding doc changes.  It's tempting
to change dict.update() to allow a sequence-of-2-seqs argument too.

Also changed the name of dictionary's keyword argument from "mapping"
to "x".  Got a better name?  "mapping_or_sequence_of_pairs" isn't
attractive, although more so than "mosop" <wink>.

abstract.h, abstract.tex:  Added new PySequence_Fast_GET_SIZE function,
much faster than going thru the all-purpose PySequence_Size.

libfuncs.tex:
- Document dictionary().
- Fiddle tuple() and list() to admit that their argument is optional.
- The long-winded repetitions of "a sequence, a container that supports
  iteration, or an iterator object" is getting to be a PITA.  Many
  months ago I suggested factoring this out into "iterable object",
  where the definition of that could include being explicit about
  generators too (as is, I'm not sure a reader outside of PythonLabs
  could guess that "an iterator object" includes a generator call).
- Please check my curly braces -- I'm going blind <0.9 wink>.

abstract.c, PySequence_Tuple():  When PyObject_GetIter() fails, leave
its error msg alone now (the msg it produces has improved since
PySequence_Tuple was generalized to accept iterable objects, and
PySequence_Tuple was also stomping on the msg in cases it shouldn't
have even before PyObject_GetIter grew a better msg).
2001-10-26 05:06:50 +00:00
..
RPM Update a beopen.com e-mail 2001-08-13 15:14:13 +00:00
ACKS Fix two typos, one noted by Noah Spurrier in SF bug #475166, the 2001-10-26 03:38:46 +00:00
AIX-NOTES Rename Setup.in to Setup.dist, and assume that configure will create 2000-10-26 17:07:40 +00:00
BeOS-NOTES Completely revamped BeOS notes, by Donn Cave (SF patch 411834). 2001-04-10 21:51:29 +00:00
BeOS-setup.py This is for BeOS users who want to build all the modules. It's 2001-04-10 21:50:09 +00:00
cheatsheet Update cheatsheet to 2.0 from Brunning/Gruet's quick reference 2001-08-06 17:43:49 +00:00
find_recursionlimit.py script that reports a fairly safe recursionlimit for a specific platform 2000-08-31 19:24:17 +00:00
gdbinit PyObject_Dump() -> _PyObject_Dump() 2001-01-24 04:18:13 +00:00
HISTORY Added release dates (in some cases detemined by looking at the mtime 2000-09-04 17:24:24 +00:00
HPUX-NOTES Added note about libpython1.5.a. 1997-07-19 20:44:33 +00:00
indent.pro Some new files... 1994-09-14 14:06:46 +00:00
Makefile.pre.in Separate CFLAGS and CPPFLAGS. CFLAGS should not contain preprocessor 2001-06-02 06:16:02 +00:00
NEWS Generalize dictionary() to accept a sequence of 2-sequences. At the 2001-10-26 05:06:50 +00:00
Porting Patch #411138: Rename config.h to pyconfig.h. Closes bug #231774. 2001-07-26 13:41:06 +00:00
PURIFY.README Updated for Python 1.5, including my experiences with Purify on 1997-10-07 15:50:58 +00:00
python-mode.el (py-version): Hopefully fixed my XEmacs settings so this doesn't get 2001-07-06 20:27:29 +00:00
python.man SF patch #467455 : Enhanced environment variables, by Toby Dickenson. 2001-10-12 22:17:56 +00:00
README Removed NEXT-NOTES, the NeXT is no longer supported. 2001-08-19 21:18:04 +00:00
RFD Initial revision 1994-01-26 10:20:16 +00:00
setuid-prog.c correct bogus instructions 'ccoment out' -> 'uncomment' 1998-09-10 20:18:09 +00:00
unicode.txt Replace the text with a link to the PEP-ified version. 2001-06-27 17:14:04 +00:00
vgrindefs Add 'yield' as a keyword 2001-08-06 17:42:53 +00:00

Python Misc subdirectory
========================

This directory contains files that wouldn't fit in elsewhere, in
particular the UNIX manual page, an Emacs mode for Python source code,
and a list of Frequently Asked Questions (and their answers).  Some
documents are only of historic importance.

Files found here
----------------

ACKS		Acknowledgements
AIX-NOTES	Notes for building Python on AIX (all new!)
BLURB		A quick description of Python for newcomers
BLURB.LUTZ	A testimonial from a converted Tcl/Perl hacker :-)
BLURB.WINDOWS	First announcement of Python for Windows
HISTORY		News from previous releases -- oldest last
HPUX-NOTES	Notes about dynamic loading under HP-UX
HYPE		More hype about Python
Makefile	Used for administrative chores like cleaning up
Makefile.pre.in	Generic Makefile template for building extensions
NEWS		News for this release
PURIFY.README	Information for Purify users
Porting		Mini-FAQ on porting to new platforms
README		The file you're reading now
RFD		Request For Discussion about a Python newsgroup
cheatsheet	Quick summary of Python by Ken Manheimer
comparisons	(Old) comparisons to some other languages
editline-fix	A news article on how to fix R$'s editline for Python
faq2html	FAQ to HTML converter by Ka-Ping Yee
find_recursionlimit.py  Script to find a value for sys.maxrecursionlimit
fixfuncptrs.sh	Shell script to fix function pointer initializers
indent.pro	GNU indent profile approximating my C style
python-mode.el	Emacs mode for editing Python programs
python.man	UNIX man page for the python interpreter
renumber.py	Script to renumber the sections in the FAQ
setuid-prog.c	C helper program for set-uid Python scripts
unicode.txt	Marc-Andre Lemburg's specification of the Unicode API
vgrindefs	Python configuration for vgrind (a generic pretty printer)