[pypy-svn] r37217 - pypy/dist/pypy/doc/config

[cfbolz at codespeak.net]

Author: cfbolz
Date: Tue Jan 23 17:56:47 2007
New Revision: 37217

Added:
   pypy/dist/pypy/doc/config/   (props changed)
   pypy/dist/pypy/doc/config/__init__.py
   pypy/dist/pypy/doc/config/autopath.py
      - copied unchanged from r37200, pypy/dist/pypy/bin/autopath.py
   pypy/dist/pypy/doc/config/confrest.py
   pypy/dist/pypy/doc/config/generate.py
   pypy/dist/pypy/doc/config/objspace.allworkingmodules.txt
   pypy/dist/pypy/doc/config/objspace.compiler.txt
   pypy/dist/pypy/doc/config/objspace.geninterp.txt
   pypy/dist/pypy/doc/config/objspace.logbytecodes.txt
   pypy/dist/pypy/doc/config/objspace.lowmem.txt
   pypy/dist/pypy/doc/config/objspace.name.txt
   pypy/dist/pypy/doc/config/objspace.nofaking.txt
   pypy/dist/pypy/doc/config/objspace.opcodes.CALL_LIKELY_BUILTIN.txt
   pypy/dist/pypy/doc/config/objspace.opcodes.txt
   pypy/dist/pypy/doc/config/objspace.parser.txt
   pypy/dist/pypy/doc/config/objspace.std.allopts.txt
   pypy/dist/pypy/doc/config/objspace.std.llvmallopts.txt
   pypy/dist/pypy/doc/config/objspace.std.methodcachesize.txt
   pypy/dist/pypy/doc/config/objspace.std.oldstyle.txt
   pypy/dist/pypy/doc/config/objspace.std.optimized_int_add.txt
   pypy/dist/pypy/doc/config/objspace.std.prebuiltintfrom.txt
   pypy/dist/pypy/doc/config/objspace.std.prebuiltintto.txt
   pypy/dist/pypy/doc/config/objspace.std.txt
   pypy/dist/pypy/doc/config/objspace.std.withdictmeasurement.txt
   pypy/dist/pypy/doc/config/objspace.std.withmethodcache.txt
   pypy/dist/pypy/doc/config/objspace.std.withmethodcachecounter.txt
   pypy/dist/pypy/doc/config/objspace.std.withmultidict.txt
   pypy/dist/pypy/doc/config/objspace.std.withprebuiltint.txt
   pypy/dist/pypy/doc/config/objspace.std.withrangelist.txt
   pypy/dist/pypy/doc/config/objspace.std.withshadowtracking.txt
   pypy/dist/pypy/doc/config/objspace.std.withsharingdict.txt
   pypy/dist/pypy/doc/config/objspace.std.withsmallint.txt
   pypy/dist/pypy/doc/config/objspace.std.withstrdict.txt
   pypy/dist/pypy/doc/config/objspace.std.withstrjoin.txt
   pypy/dist/pypy/doc/config/objspace.std.withstrslice.txt
   pypy/dist/pypy/doc/config/objspace.std.withtproxy.txt
   pypy/dist/pypy/doc/config/objspace.std.withtypeversion.txt
   pypy/dist/pypy/doc/config/objspace.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.Numeric.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.__builtin__.txt
   pypy/dist/pypy/doc/config/objspace.usemodules._codecs.txt
   pypy/dist/pypy/doc/config/objspace.usemodules._demo.txt
   pypy/dist/pypy/doc/config/objspace.usemodules._dotnet.txt
   pypy/dist/pypy/doc/config/objspace.usemodules._file.txt
   pypy/dist/pypy/doc/config/objspace.usemodules._pickle_support.txt
   pypy/dist/pypy/doc/config/objspace.usemodules._random.txt
   pypy/dist/pypy/doc/config/objspace.usemodules._sre.txt
   pypy/dist/pypy/doc/config/objspace.usemodules._ssl.txt
   pypy/dist/pypy/doc/config/objspace.usemodules._stackless.txt
   pypy/dist/pypy/doc/config/objspace.usemodules._weakref.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.array.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.bz2.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.crypt.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.errno.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.fcntl.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.gc.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.marshal.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.math.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.mmap.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.posix.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.pypyjit.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.pypymagic.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.rctime.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.readline.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.recparser.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.rsocket.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.select.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.signal.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.symbol.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.sys.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.thread.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.time.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.txt
   pypy/dist/pypy/doc/config/objspace.usemodules.unicodedata.txt
   pypy/dist/pypy/doc/config/objspace.usepycfiles.txt
   pypy/dist/pypy/doc/config/translation.backend.txt
   pypy/dist/pypy/doc/config/translation.backendopt.clever_malloc_removal.txt
   pypy/dist/pypy/doc/config/translation.backendopt.constfold.txt
   pypy/dist/pypy/doc/config/translation.backendopt.heap2stack.txt
   pypy/dist/pypy/doc/config/translation.backendopt.inline_threshold.txt
   pypy/dist/pypy/doc/config/translation.backendopt.mallocs.txt
   pypy/dist/pypy/doc/config/translation.backendopt.merge_if_blocks.txt
   pypy/dist/pypy/doc/config/translation.backendopt.print_statistics.txt
   pypy/dist/pypy/doc/config/translation.backendopt.profile_based_inline.txt
   pypy/dist/pypy/doc/config/translation.backendopt.raisingop2direct_call.txt
   pypy/dist/pypy/doc/config/translation.backendopt.remove_asserts.txt
   pypy/dist/pypy/doc/config/translation.backendopt.txt
   pypy/dist/pypy/doc/config/translation.builtins_can_raise_exceptions.txt
   pypy/dist/pypy/doc/config/translation.cc.txt
   pypy/dist/pypy/doc/config/translation.cli.trace_calls.txt
   pypy/dist/pypy/doc/config/translation.cli.txt
   pypy/dist/pypy/doc/config/translation.compilerflags.txt
   pypy/dist/pypy/doc/config/translation.countmallocs.txt
   pypy/dist/pypy/doc/config/translation.debug.txt
   pypy/dist/pypy/doc/config/translation.debug_transform.txt
   pypy/dist/pypy/doc/config/translation.fork_before.txt
   pypy/dist/pypy/doc/config/translation.gc.txt
   pypy/dist/pypy/doc/config/translation.insist.txt
   pypy/dist/pypy/doc/config/translation.instrument.txt
   pypy/dist/pypy/doc/config/translation.instrumentctl.txt
   pypy/dist/pypy/doc/config/translation.linkerflags.txt
   pypy/dist/pypy/doc/config/translation.list_comprehension_operations.txt
   pypy/dist/pypy/doc/config/translation.llvm_via_c.txt
   pypy/dist/pypy/doc/config/translation.no__thread.txt
   pypy/dist/pypy/doc/config/translation.output.txt
   pypy/dist/pypy/doc/config/translation.profopt.txt
   pypy/dist/pypy/doc/config/translation.simplifying.txt
   pypy/dist/pypy/doc/config/translation.stackless.txt
   pypy/dist/pypy/doc/config/translation.thread.txt
   pypy/dist/pypy/doc/config/translation.txt
   pypy/dist/pypy/doc/config/translation.type_system.txt
   pypy/dist/pypy/doc/config/translation.vanilla.txt
   pypy/dist/pypy/doc/config/translation.verbose.txt
   pypy/dist/pypy/doc/config/translation.withsmallfuncsets.txt
Log:
a huge checkin of mostly empty files, one for every option. the plan is to
document what each option does in all these files. The confrest file in here is
special and adds nice headers that produce headers for all these files,
containing extra info about the option (what depends on what, navigation
between the options, option types, cmdline args...).


Added: pypy/dist/pypy/doc/config/__init__.py
==============================================================================

Added: pypy/dist/pypy/doc/config/confrest.py
==============================================================================
--- (empty file)
+++ pypy/dist/pypy/doc/config/confrest.py	Tue Jan 23 17:56:47 2007
@@ -0,0 +1,48 @@
+from pypy.doc.confrest import *
+import pypy.config.makerestdoc
+from pypy.config.config import Config
+from pypy.config import pypyoption, translationoption
+
+
+all_optiondescrs = [pypyoption.pypy_optiondescription,
+                    translationoption.translation_optiondescription,
+                   ]
+
+start_to_descr = dict([(descr._name, descr) for descr in all_optiondescrs])
+
+class PyPyPage(PyPyPage): 
+    def fill(self):
+        super(PyPyPage, self).fill()
+        self.menubar[:] = html.div(
+            html.a("general documentation", href="../index.html",
+                   class_="menu"), " ",
+            html.a("translation options", href="translation.txt", 
+                   class_="menu"), 
+            html.a("standard interpreter options", href="objspace.txt", 
+                   class_="menu"), 
+            " ", id="menubar")
+
+class Project(Project): 
+    stylesheet = "../style.css"
+    title = "PyPy Configuration"
+    prefix_title = "PyPy Configuration"
+    Page = PyPyPage 
+
+    def get_content(self, txtpath, encoding):
+        fullpath = txtpath.purebasename
+        start = fullpath.split(".")[0]
+        path = fullpath.rsplit(".", 1)[0]
+        basedescr = start_to_descr[start]
+        if fullpath.count(".") == 0:
+            descr = basedescr
+            path = ""
+        else:
+            conf = Config(basedescr)
+            subconf, step = conf._cfgimpl_get_home_by_path(
+                    fullpath.split(".", 1)[1])
+            descr = getattr(subconf._cfgimpl_descr, step)
+        text = unicode(descr.make_rest_doc(path).text())
+        if txtpath.check(file=True):
+            return u"%s\n\n%s" % (text, unicode(txtpath.read(), encoding))
+        return text
+

Added: pypy/dist/pypy/doc/config/generate.py
==============================================================================
--- (empty file)
+++ pypy/dist/pypy/doc/config/generate.py	Tue Jan 23 17:56:47 2007
@@ -0,0 +1,15 @@
+import autopath
+import py
+from pypy.config import pypyoption, translationoption, config
+from pypy.doc.config.confrest import all_optiondescrs
+
+thisdir = py.magic.autopath().dirpath()
+
+for descr in all_optiondescrs:
+    prefix = descr._name
+    c = config.Config(descr)
+    thisdir.join(prefix + ".txt").ensure()
+    for p in c.getpaths(include_groups=True):
+        basename = prefix + "." + p + ".txt"
+        f = thisdir.join(basename)
+        f.ensure()

Added: pypy/dist/pypy/doc/config/objspace.allworkingmodules.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.compiler.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.geninterp.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.logbytecodes.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.lowmem.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.name.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.nofaking.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.opcodes.CALL_LIKELY_BUILTIN.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.opcodes.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.parser.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.allopts.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.llvmallopts.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.methodcachesize.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.oldstyle.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.optimized_int_add.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.prebuiltintfrom.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.prebuiltintto.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.withdictmeasurement.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.withmethodcache.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.withmethodcachecounter.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.withmultidict.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.withprebuiltint.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.withrangelist.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.withshadowtracking.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.withsharingdict.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.withsmallint.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.withstrdict.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.withstrjoin.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.withstrslice.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.withtproxy.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.std.withtypeversion.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.Numeric.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.__builtin__.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules._codecs.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules._demo.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules._dotnet.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules._file.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules._pickle_support.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules._random.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules._sre.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules._ssl.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules._stackless.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules._weakref.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.array.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.bz2.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.crypt.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.errno.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.fcntl.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.gc.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.marshal.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.math.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.mmap.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.posix.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.pypyjit.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.pypymagic.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.rctime.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.readline.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.recparser.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.rsocket.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.select.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.signal.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.symbol.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.sys.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.thread.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.time.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usemodules.unicodedata.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/objspace.usepycfiles.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.backend.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.backendopt.clever_malloc_removal.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.backendopt.constfold.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.backendopt.heap2stack.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.backendopt.inline_threshold.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.backendopt.mallocs.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.backendopt.merge_if_blocks.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.backendopt.print_statistics.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.backendopt.profile_based_inline.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.backendopt.raisingop2direct_call.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.backendopt.remove_asserts.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.backendopt.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.builtins_can_raise_exceptions.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.cc.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.cli.trace_calls.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.cli.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.compilerflags.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.countmallocs.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.debug.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.debug_transform.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.fork_before.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.gc.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.insist.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.instrument.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.instrumentctl.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.linkerflags.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.list_comprehension_operations.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.llvm_via_c.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.no__thread.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.output.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.profopt.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.simplifying.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.stackless.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.thread.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.type_system.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.vanilla.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.verbose.txt
==============================================================================

Added: pypy/dist/pypy/doc/config/translation.withsmallfuncsets.txt
==============================================================================