[pypy-svn] r38905 - pypy/dist/pypy/config
mwh at codespeak.net
mwh at codespeak.net
Thu Feb 15 16:19:04 CET 2007
Author: mwh
Date: Thu Feb 15 16:19:02 2007
New Revision: 38905
Modified:
pypy/dist/pypy/config/pypyoption.py
pypy/dist/pypy/config/translationoption.py
Log:
a bit of a review of the option descriptions.
Modified: pypy/dist/pypy/config/pypyoption.py
==============================================================================
--- pypy/dist/pypy/config/pypyoption.py (original)
+++ pypy/dist/pypy/config/pypyoption.py Thu Feb 15 16:19:02 2007
@@ -35,8 +35,8 @@
if os.name == "posix":
module_dependencies['rctime'] = [("objspace.usemodules.select", True),]
-
-pypy_optiondescription = OptionDescription("objspace", "Object Space Option", [
+
+pypy_optiondescription = OptionDescription("objspace", "Object Space Options", [
ChoiceOption("name", "Object Space name",
["std", "flow", "logic", "thunk", "cpy", "dump", "taint"],
"std",
@@ -49,11 +49,11 @@
},
cmdline='--objspace -o'),
- ChoiceOption("parser", "parser",
+ ChoiceOption("parser", "which parser to use for app-level code",
["pypy", "cpython"], "pypy",
cmdline='--parser'),
- ChoiceOption("compiler", "compiler",
+ ChoiceOption("compiler", "which compiler to use for app-level code",
["cpython", "ast"], "ast",
cmdline='--compiler'),
@@ -106,7 +106,7 @@
default=False,
requires=[("translation.gc", "boehm")]),
- BoolOption("withprebuiltint", "prebuilt commonly used int objects",
+ BoolOption("withprebuiltint", "prebuild commonly used int objects",
default=False,
requires=[("objspace.std.withsmallint", False)]),
@@ -215,7 +215,7 @@
("translation.backend", "llvm")],
cmdline="--llvm-faassen", negation=False),
]),
- BoolOption("lowmem", "Try to use little memory during translation",
+ BoolOption("lowmem", "Try to use less memory during translation",
default=False, cmdline="--lowmem",
requires=[("objspace.geninterp", False)]),
Modified: pypy/dist/pypy/config/translationoption.py
==============================================================================
--- pypy/dist/pypy/config/translationoption.py (original)
+++ pypy/dist/pypy/config/translationoption.py Thu Feb 15 16:19:02 2007
@@ -11,7 +11,7 @@
translation_optiondescription = OptionDescription(
"translation", "Translation Options", [
- BoolOption("stackless", "compile stackless features in",
+ BoolOption("stackless", "enable stackless features during compilation",
default=False, cmdline="--stackless",
requires=[("translation.type_system", "lltype")]),
ChoiceOption("type_system", "Type system to use when RTyping",
@@ -30,7 +30,7 @@
"cl": [("translation.type_system", "ootype")],
},
cmdline="-b --backend"),
- BoolOption("llvm_via_c", "compile llvm bytecode via C",
+ BoolOption("llvm_via_c", "compile llvm via C",
default=False, cmdline="--llvm-via-c",
requires=[("translation.backend", "llvm")]),
ChoiceOption("gc", "Garbage Collection Strategy",
@@ -53,7 +53,7 @@
cmdline=None),
# misc
- StrOption("cc", "Specify compiler", cmdline="--cc"),
+ StrOption("cc", "Specify compiler to use for compiling generated C", cmdline="--cc"),
StrOption("profopt", "Specify profile based optimization script",
cmdline="--profopt"),
BoolOption("debug_transform", "Perform the debug transformation",
@@ -63,9 +63,9 @@
default=False, cmdline=None),
ArbitraryOption("instrumentctl", "internal",
- default=None),
+ default=None),
StrOption("output", "Output file name", cmdline="--output"),
-
+
# portability options
BoolOption("vanilla",
"Try to be as portable as possible, which is not much",
@@ -75,16 +75,23 @@
BoolOption("no__thread",
"don't use __thread for implementing TLS",
default=False, cmdline="--no__thread", negation=False),
- StrOption("compilerflags", "Specify flags for the compiler",
+ StrOption("compilerflags", "Specify flags for the C compiler",
cmdline="--cflags"),
- StrOption("linkerflags", "Specify flags for the linker",
+ StrOption("linkerflags", "Specify flags for the linker (C backend only)",
cmdline="--ldflags"),
# Flags of the TranslationContext:
BoolOption("simplifying", "Simplify flow graphs", default=True),
- BoolOption("builtins_can_raise_exceptions", "XXX", default=False,
+ BoolOption("builtins_can_raise_exceptions",
+ "When true, assume any call to a 'simple' builtin such as "
+ "'hex' can raise an arbitrary exception",
+ default=False,
cmdline=None),
- BoolOption("list_comprehension_operations", "XXX", default=False,
+ BoolOption("list_comprehension_operations",
+ "When true, look for and special-case the sequence of "
+ "operations that results from a list comprehension and "
+ "attempt to pre-allocate the list",
+ default=False,
cmdline=None),
ChoiceOption("fork_before",
"(UNIX) Create restartable checkpoint before step",
@@ -102,13 +109,15 @@
"for inlining",
default="pypy.translator.backendopt.inline.inlining_heuristic",
cmdline="--inline-heuristic"),
-
+
BoolOption("print_statistics", "Print statistics while optimizing",
default=False),
BoolOption("merge_if_blocks", "Merge if ... elif chains",
cmdline="--if-block-merge", default=True),
BoolOption("raisingop2direct_call",
- "Transform exception raising operations",
+ "Transform operations that can implicitly raise an "
+ "exception into calls to functions that explicitly "
+ "raise exceptions",
default=False, cmdline="--raisingop2direct_call"),
BoolOption("mallocs", "Remove mallocs", default=True),
BoolOption("constfold", "Constant propagation",
@@ -133,7 +142,7 @@
cmdline="--prof-based-inline-heuristic"),
# control clever malloc removal
BoolOption("clever_malloc_removal",
- "Drives inlining to remove mallocs in a clever way",
+ "Drives inlining to remove mallocs in a clever way",
default=False,
cmdline="--clever-malloc-removal"),
FloatOption("clever_malloc_removal_threshold",
@@ -148,8 +157,9 @@
cmdline="--clever-malloc-removal-heuristic"),
BoolOption("remove_asserts",
- "Kill 'raise AssertionError', which lets the C "
- "optimizer remove the asserts", default=False),
+ "Remove operations that look like 'raise AssertionError', "
+ "which lets the C optimizer remove the asserts",
+ default=False),
]),
OptionDescription("cli", "GenCLI options", [
More information about the Pypy-commit
mailing list