summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libfuncs.tex
Commit message (Collapse)AuthorAgeFilesLines
* Fix SF bug #766288, property() example gives syntax errorNeal Norwitz2003-07-051-1/+1
|
* Fix nits found by Tools\scripts\texcheck.pyRaymond Hettinger2003-05-161-1/+1
|
* backports:Neal Norwitz2003-02-021-2/+95
| | | | | | | | | | | | | | | | | | | | | | | | revision 1.127 date: 2003/01/04 02:16:22; author: rhettinger; state: Exp; lines: +1 -1 SF bug #655271: Slightly modify locals() doc Clarify the operation of locals(). revision 1.125 date: 2002/12/17 01:08:06; author: nnorwitz; state: Exp; lines: +6 -1 Fix SF # 641111, Undocumented side effect of eval Try to clear up confusion about the current globals being copied into a globals dict passed to eval(). This wording (more or less) was suggested in bug report. It should probably be made clearer. revision 1.124 date: 2002/12/17 01:02:57; author: nnorwitz; state: Exp; lines: +78 -0 Fix SF #642742, property() builtin not documented Added doc for functions new to 2.2: classmethod property staticmethod super Taken from docstrings. Could use review. Hope there wasn't a reason why these shouldn't have been added.
* Document that apply() is deprecated. See:Fred Drake2003-01-021-0/+3
| | | | http://mail.python.org/pipermail/python-dev/2003-January/031556.html
* Update example for the type() function to use the currently acceptedFred Drake2002-11-011-2/+13
| | | | | | | preference of using "is" instead of "==" to compare types, use built-in names where available, and point to the isinstance() function. Closes SF bug #632196.
* Backport 1.108 documenting Py2.3's impending deprecation of divmod()Raymond Hettinger2002-10-061-0/+3
| | | | for complex numbers.
* Another try at clarifying what goes into and comes out of Unicode objects.Fred Drake2002-09-241-4/+0
|
* Clarify that len() of a Unicode string returns the number of storage units,Fred Drake2002-09-241-0/+4
| | | | not abstract characters.
* Fix typoRaymond Hettinger2002-09-041-1/+1
|
* Add a note that apply() is needed since the extended call syntax isFred Drake2002-08-221-0/+2
| | | | completely equivalent.
* reduce(): Clarified what is returned in the case of a sequence 1 item long andFred Drake2002-07-171-6/+6
| | | | initial/default value.
* Note that unicode() can raise LookupError for unknown codecs.Fred Drake2002-07-091-1/+2
| | | | Closes SF bug #513666.
* Fix typo: "an Unicode string" --> "a Unicode string"Fred Drake2002-07-081-2/+2
| | | | Clarify the return value when the parameter is a Unicode object.
* Clarify the version information for the unicode() built-in.Fred Drake2002-06-291-6/+9
| | | | Closes SF bug #575272.
* Add a version annotation for the help() function.Fred Drake2002-04-171-0/+1
|
* Added missing version annotation for dict().Fred Drake2002-03-061-0/+2
|
* backport tim_one's checkin ofMichael W. Hudson2002-02-231-9/+22
| | | | | | | | | | | | | | | | | revision 1.101 of libfuncs.tex SF bug #501591: dir() doc is old Bugfix candidate. + Updated dir() description to match actual 2.2 behavior. + Replaced the dir(sys) example with dir(struct), because the former was way out of date and is bound to change frequently, while the latter is stable. + Added a note cautioning that dir() is supplied primarily for convenience at an interactive prompt (hoping to discourage its use as the foundation of introspective code outside the core).
* Add documentation for the help() built-in; contributed by Ka-Ping Yee.Fred Drake2001-12-181-0/+10
| | | | This is part of SF patch #494622.
* Ensure that complex() only accepts a string argument as the first arg,Fred Drake2001-12-131-3/+5
| | | | | and only if there is no second arg. This closes SF patch #479551.
* Minor clarification of the zip() description, based on a comment sent toFred Drake2001-12-031-1/+1
| | | | python-docs.
* Remove most references to __members__ and __methods__, leaving only one pairFred Drake2001-12-031-2/+2
| | | | | | of references that now state that these attributes have been removed, directing the reader to the dir() function. This closes SF bug #456420.
* When referring to a formal parameter from the description, use the name givenFred Drake2001-11-071-1/+1
| | | | with the signature, not an ad hoc abbreviated form.
* apply() documentation: Remove a detail about the implementation that doesFred Drake2001-11-071-5/+6
| | | | | not affect the API. Clean up the text about call syntax apply() is equivalent to. Based on comments by Thomas Guettler.
* Rename "dictionary" (type and constructor) to "dict".Tim Peters2001-10-291-7/+7
|
* Some style changes and typo fixes.Fred Drake2001-10-261-6/+9
|
* Generalize dictionary() to accept a sequence of 2-sequences. At theTim Peters2001-10-261-2/+24
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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).
* Additional test and documentation for the unicode() changes.Marc-André Lemburg2001-10-191-13/+27
| | | | This patch should also be applied to the 2.2b1 trunk.
* Update the documentation for the isinstance() function to reflect recentFred Drake2001-10-091-221/+226
| | | | | changes in the implementation. Indented all descriptions consistently.
* Make clear that tuple() accepts the same kind of arguments as list().Tim Peters2001-10-041-1/+3
|
* The execfile() docs imply it acts on locals same as exec. But in truthTim Peters2001-09-301-0/+7
| | | | | it acts more like assigning to keys in locals(), i.e. modifications to function locals aren't reflected in the locals when execfile() returns.
* Correct docs for long(float).Tim Peters2001-09-301-2/+1
|
* Fix two typos in the text about compile(), and add two caveats fromGuido van Rossum2001-09-291-2/+9
| | | | | recent user feedback: you must end the input with \n and you must use \n, not \r\n to represent line endings.
* Document new file() constructor, with the body of open()'s text, plus aTim Peters2001-09-201-37/+45
| | | | | "new in 2.2" blurb at the end. Replace open()'s text by pointing back to file().
* Document the built-in iter() function.Fred Drake2001-09-061-0/+17
|
* New restriction on pow(x, y, z): If z is not None, x and y must be ofTim Peters2001-09-031-6/+12
| | | | | integer types, and y must be >= 0. See discussion at http://sf.net/tracker/index.php?func=detail&aid=457066&group_id=5470&atid=105470
* Docs for the PEP 264 changes.Michael W. Hudson2001-08-271-1/+20
|
* SF bug #444510: int() should guarantee truncation.Tim Peters2001-07-261-3/+1
| | | | It's guaranteed now, assuming the platform modf() works correctly.
* On int/long to the negative int/long power, let float handle itGuido van Rossum2001-07-121-7/+10
| | | | | | | instead of raising an error. This was one of the two issues that the VPython folks were particularly problematic for their students. (The other one was integer division...) This implements (my) SF patch #440487.
* Fix up a few style nits -- avoid "e.g." and "i.e." -- these makeFred Drake2001-07-061-56/+56
| | | | | translation more difficult, as well as reading the English more difficult for non-native speakers.
* Beef up the unicode() description a bit, based on material from AMK'sFred Drake2001-05-151-4/+12
| | | | "What's New in Python ..." documents.
* Update the filter() and list() descriptions to include information aboutFred Drake2001-05-021-12/+14
| | | | the support for containers and iteration.
* Backed out the unistr() builtin.Marc-André Lemburg2001-01-191-7/+0
|
* Minor markup cleaning, and one required fix in the unistr() description.Fred Drake2001-01-181-7/+7
|
* This patch adds a new builtin unistr() which behaves like str()Marc-André Lemburg2001-01-171-0/+6
| | | | | | | | | | except that it always returns Unicode objects. A new C API PyObject_Unicode() is also provided. This closes patch #101664. Written by Marc-Andre Lemburg. Copyright assigned to Guido van Rossum.
* Description of long(): A string parameter is no longer required to beFred Drake2001-01-041-1/+1
| | | | | | *decimal*. This closes SF bug #127273.
* Added information about the %r string formatting conversion. Added noteFred Drake2000-11-171-4/+8
| | | | | | | | about the interpretation of radix 0 for int(), and added description of the optional radix argument for long(). Based on comments from Reuben Sumner <rasumner@users.sourceforge.net>. This closes bug #121672.
* When referring to namespaces, always say "namespaces" instead ofFred Drake2000-09-121-1/+1
| | | | | | "name spaces". Inconsistency noted by Keith Briggs <keith.briggs@bt.com>.
* Various clarifications and minor nits fixed. Affected descriptions ofFred Drake2000-09-091-7/+21
| | | | input(), locals(), reload(), unicode(), and zip().
* Small cleanups, and note when zip() entered the menagerie.Fred Drake2000-08-171-3/+1
|
* int() description: Fix markup to avoid image generation for math mode.Fred Drake2000-08-031-5/+6
| | | | | | zip() description: Fix broken markup, three small markup consistency nits, and one really minor usage nit. Introduce use of \moreargs instead of hardcoding "..." with \optional.