[pypy-svn] r38830 - pypy/dist/pypy/doc

[cfbolz at codespeak.net]

Author: cfbolz
Date: Wed Feb 14 15:06:08 2007
New Revision: 38830

Modified:
   pypy/dist/pypy/doc/object-optimizations.txt
Log:
add a lot of config links


Modified: pypy/dist/pypy/doc/object-optimizations.txt
==============================================================================
--- pypy/dist/pypy/doc/object-optimizations.txt	(original)
+++ pypy/dist/pypy/doc/object-optimizations.txt	Wed Feb 14 15:06:08 2007
@@ -31,6 +31,8 @@
 perform repeated string additions in a loop without using the
 ``"".join(list_of_strings)`` pattern.
 
+You can this feature enable with the :config:`objspace.std.withstrjoin` option.
+
 string-slice objects
 --------------------
 
@@ -46,6 +48,8 @@
 string.  There is also a minimum number of characters below which being lazy
 is not saving any time over making the copy).
 
+You can this feature enable with the :config:`objspace.std.withstrslice` option.
+
 Integer optimizations
 =====================
 
@@ -57,6 +61,7 @@
 time a new integer object is created it is checked whether the integer is small
 enough to be retrieved from the cache.
 
+You can enable this feature with the :config:`objspace.std.withsmallint` option.
 
 integers as tagged pointers
 ---------------------------
@@ -82,6 +87,8 @@
 the whole information in the string-keyed dictionary is copied over into another
 RPython-dictionary, where arbitrary Python objects can be used as keys.
 
+You can enable this feature with the :config:`objspace.std.withstrdict` option.
+
 multi-dicts
 -----------
 
@@ -98,6 +105,9 @@
 general representation that can store arbitrary keys). In addition there are
 more specialized dictionary implementations for various purposes (see below).
 
+You can enable this feature with the :config:`objspace.std.withmultidict`
+option.
+
 
 sharing dicts
 -------------
@@ -116,6 +126,9 @@
 dicts:
 the representation of the instance dict contains only a list of values.
 
+You can enable this feature with the :config:`objspace.std.withsharingdict`
+option.
+
 
 builtin-shadowing
 -----------------
@@ -140,6 +153,10 @@
 common case, the program didn't do any of these; the proper builtin can then
 be called without using any dictionary lookup at all.
 
+You can enable this feature with the
+:config:`objspace.opcodes.CALL_LIKELY_BUILTIN` option.
+
+
 List optimizations
 ==================
 
@@ -155,6 +172,8 @@
 created. This gives the memory and speed behaviour of ``xrange`` and the generality
 of use of ``range``, and makes ``xrange`` essentially useless.
 
+You can enable this feature with the :config:`objspace.std.withrangelist`
+option.
 
 multi-lists
 -----------
@@ -167,6 +186,9 @@
 implement the same optimization is that range lists came earlier and that
 multi-lists are not tested that much so far).
 
+You can enable this feature with the :config:`objspace.std.withmultilist`
+option.
+
 
 fast list slicing
 ------------------
@@ -178,6 +200,8 @@
 list slice is only created lazily, that is when either the original list or
 the sliced list is mutated.
 
+You can enable this feature with the :config:`objspace.std.withfastslice`
+option.
 
 .. _`Neal Norwitz on pypy-dev`: http://codespeak.net/pipermail/pypy-dev/2005q4/002538.html
 
@@ -199,6 +223,9 @@
 shadowing the class attribute. If we know that there is no shadowing (since
 instance dict tells us that) we can save this lookup on the instance dictionary.
 
+You can enable this feature with the :config:`objspace.std.withshadowtracking`
+option.
+
 
 Method caching
 --------------
@@ -212,3 +239,6 @@
 lookup happens (this version is incremented every time the type or one of its
 base classes is changed). On subsequent lookups the cached version can be used,
 as long as the instance did not shadow any of its classes attributes.
+
+You can enable this feature with the :config:`objspace.std.withmethodcache`
+option.