| author | paulson <lp15@cam.ac.uk> | 
| Tue, 10 Feb 2015 17:37:06 +0000 | |
| changeset 59506 | 4af607652318 | 
| parent 59468 | fe6651760643 | 
| child 60074 | 38a64cc17403 | 
| permissions | -rw-r--r-- | 
| 48367 | 1  | 
(* :mode=isabelle-options: *)  | 
2  | 
||
| 49295 | 3  | 
section "Document Preparation"  | 
| 49270 | 4  | 
|
| 
48795
 
bece259ee055
clarified format of etc/options: only declarations, not re-definitions;
 
wenzelm 
parents: 
48661 
diff
changeset
 | 
5  | 
option browser_info : bool = false  | 
| 48580 | 6  | 
-- "generate theory browser information"  | 
| 48367 | 7  | 
|
| 
48795
 
bece259ee055
clarified format of etc/options: only declarations, not re-definitions;
 
wenzelm 
parents: 
48661 
diff
changeset
 | 
8  | 
option document : string = ""  | 
| 52746 | 9  | 
-- "build document in given format: pdf, dvi, false"  | 
| 
48805
 
c3ea910b3581
explicit document_output directory, without implicit purge of default in ISABELLE_BROWSER_INFO;
 
wenzelm 
parents: 
48795 
diff
changeset
 | 
10  | 
option document_output : string = ""  | 
| 
 
c3ea910b3581
explicit document_output directory, without implicit purge of default in ISABELLE_BROWSER_INFO;
 
wenzelm 
parents: 
48795 
diff
changeset
 | 
11  | 
-- "document output directory (default within $ISABELLE_BROWSER_INFO tree)"  | 
| 
 
c3ea910b3581
explicit document_output directory, without implicit purge of default in ISABELLE_BROWSER_INFO;
 
wenzelm 
parents: 
48795 
diff
changeset
 | 
12  | 
option document_variants : string = "document"  | 
| 
48795
 
bece259ee055
clarified format of etc/options: only declarations, not re-definitions;
 
wenzelm 
parents: 
48661 
diff
changeset
 | 
13  | 
-- "option alternative document variants (separated by colons)"  | 
| 48367 | 14  | 
|
| 
48795
 
bece259ee055
clarified format of etc/options: only declarations, not re-definitions;
 
wenzelm 
parents: 
48661 
diff
changeset
 | 
15  | 
option thy_output_display : bool = false  | 
| 48580 | 16  | 
-- "indicate output as multi-line display-style material"  | 
| 
48795
 
bece259ee055
clarified format of etc/options: only declarations, not re-definitions;
 
wenzelm 
parents: 
48661 
diff
changeset
 | 
17  | 
option thy_output_break : bool = false  | 
| 48580 | 18  | 
-- "control line breaks in non-display material"  | 
| 
48795
 
bece259ee055
clarified format of etc/options: only declarations, not re-definitions;
 
wenzelm 
parents: 
48661 
diff
changeset
 | 
19  | 
option thy_output_quotes : bool = false  | 
| 48580 | 20  | 
-- "indicate if the output should be enclosed in double quotes"  | 
| 
59175
 
bf465f335e85
system option "pretty_margin" is superseded by "thy_output_margin";
 
wenzelm 
parents: 
58849 
diff
changeset
 | 
21  | 
option thy_output_margin : int = 76  | 
| 
 
bf465f335e85
system option "pretty_margin" is superseded by "thy_output_margin";
 
wenzelm 
parents: 
58849 
diff
changeset
 | 
22  | 
-- "right margin / page width for printing of display material"  | 
| 
48795
 
bece259ee055
clarified format of etc/options: only declarations, not re-definitions;
 
wenzelm 
parents: 
48661 
diff
changeset
 | 
23  | 
option thy_output_indent : int = 0  | 
| 48580 | 24  | 
-- "indentation for pretty printing of display material"  | 
| 
48795
 
bece259ee055
clarified format of etc/options: only declarations, not re-definitions;
 
wenzelm 
parents: 
48661 
diff
changeset
 | 
25  | 
option thy_output_source : bool = false  | 
| 48580 | 26  | 
-- "print original source text rather than internal representation"  | 
| 52042 | 27  | 
option thy_output_modes : string = ""  | 
28  | 
-- "additional print modes for document output (separated by commas)"  | 
|
| 49270 | 29  | 
|
| 
52043
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
30  | 
|
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
31  | 
section "Prover Output"  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
32  | 
|
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
33  | 
option show_types : bool = false  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
34  | 
-- "show type constraints when printing terms"  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
35  | 
option show_sorts : bool = false  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
36  | 
-- "show sort constraints when printing types"  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
37  | 
option show_brackets : bool = false  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
38  | 
-- "show extra brackets when printing terms/types"  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
39  | 
option show_question_marks : bool = true  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
40  | 
-- "show leading question mark of schematic variables"  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
41  | 
|
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
42  | 
option show_consts : bool = false  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
43  | 
-- "show constants with types when printing proof state"  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
44  | 
option show_main_goal : bool = false  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
45  | 
-- "show main goal when printing proof state"  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
46  | 
option goals_limit : int = 10  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
47  | 
-- "maximum number of subgoals to be printed"  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
48  | 
|
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
49  | 
option names_long : bool = false  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
50  | 
-- "show fully qualified names"  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
51  | 
option names_short : bool = false  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
52  | 
-- "show base names only"  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
53  | 
option names_unique : bool = true  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
54  | 
-- "show partially qualified names, as required for unique name resolution"  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
55  | 
|
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
56  | 
option eta_contract : bool = true  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
57  | 
-- "print terms in eta-contracted form"  | 
| 
 
286629271d65
more system options as context-sensitive config options;
 
wenzelm 
parents: 
52042 
diff
changeset
 | 
58  | 
|
| 49270 | 59  | 
option print_mode : string = ""  | 
60  | 
-- "additional print modes for prover output (separated by commas)"  | 
|
61  | 
||
62  | 
||
| 
56875
 
f6259d6fb565
explicit option parallel_print to downgrade parallel scheduling, which might occasionally help for big and heavy "scripts";
 
wenzelm 
parents: 
56734 
diff
changeset
 | 
63  | 
section "Parallel Processing"  | 
| 49270 | 64  | 
|
| 
52065
 
78f2475aa126
explicit notion of public options, which are shown in the editor options dialog;
 
wenzelm 
parents: 
52043 
diff
changeset
 | 
65  | 
public option threads : int = 0  | 
| 49270 | 66  | 
-- "maximum number of worker threads for prover process (0 = hardware max.)"  | 
| 
56734
 
6ca87a061740
suppress potential dangerous option (see 1baa5d19ac44);
 
wenzelm 
parents: 
56613 
diff
changeset
 | 
67  | 
option threads_trace : int = 0  | 
| 49270 | 68  | 
-- "level of tracing information for multithreading"  | 
| 
59468
 
fe6651760643
explicit threads_stack_limit (for recent Poly/ML SVN versions), which leads to soft interrupt instead of exhaustion of virtual memory, which is particularly relevant for the bigger address space of x86_64;
 
wenzelm 
parents: 
59446 
diff
changeset
 | 
69  | 
option threads_stack_limit : real = 0.25  | 
| 
 
fe6651760643
explicit threads_stack_limit (for recent Poly/ML SVN versions), which leads to soft interrupt instead of exhaustion of virtual memory, which is particularly relevant for the bigger address space of x86_64;
 
wenzelm 
parents: 
59446 
diff
changeset
 | 
70  | 
-- "maximum stack size for worker threads (in giga words, 0 = unlimited)"  | 
| 
56875
 
f6259d6fb565
explicit option parallel_print to downgrade parallel scheduling, which might occasionally help for big and heavy "scripts";
 
wenzelm 
parents: 
56734 
diff
changeset
 | 
71  | 
public option parallel_print : bool = true  | 
| 
 
f6259d6fb565
explicit option parallel_print to downgrade parallel scheduling, which might occasionally help for big and heavy "scripts";
 
wenzelm 
parents: 
56734 
diff
changeset
 | 
72  | 
-- "parallel and asynchronous printing of results"  | 
| 
52065
 
78f2475aa126
explicit notion of public options, which are shown in the editor options dialog;
 
wenzelm 
parents: 
52043 
diff
changeset
 | 
73  | 
public option parallel_proofs : int = 2  | 
| 49270 | 74  | 
-- "level of parallel proof checking: 0, 1, 2"  | 
| 52714 | 75  | 
option parallel_subproofs_threshold : real = 0.01  | 
| 
51423
 
e5f9a6d9ca82
clarified parallel_subproofs_saturation (blind guess) vs. parallel_subproofs_threshold (precient timing estimate);
 
wenzelm 
parents: 
51230 
diff
changeset
 | 
76  | 
-- "lower bound of timing estimate for forked nested proofs (seconds)"  | 
| 49270 | 77  | 
|
78  | 
||
| 52490 | 79  | 
section "Detail of Proof Checking"  | 
| 49270 | 80  | 
|
81  | 
option quick_and_dirty : bool = false  | 
|
82  | 
-- "if true then some tools will OMIT some proofs"  | 
|
83  | 
option skip_proofs : bool = false  | 
|
| 
51553
 
63327f679cff
more ambitious Goal.skip_proofs: covers Goal.prove forms as well, and do not insist in quick_and_dirty (for the sake of Isabelle/jEdit);
 
wenzelm 
parents: 
51423 
diff
changeset
 | 
84  | 
-- "skip over proofs (implicit 'sorry')"  | 
| 49270 | 85  | 
|
86  | 
||
| 49295 | 87  | 
section "Global Session Parameters"  | 
| 49270 | 88  | 
|
89  | 
option condition : string = ""  | 
|
90  | 
-- "required environment variables for subsequent theories (separated by commas)"  | 
|
91  | 
||
| 
48795
 
bece259ee055
clarified format of etc/options: only declarations, not re-definitions;
 
wenzelm 
parents: 
48661 
diff
changeset
 | 
92  | 
option timeout : real = 0  | 
| 48661 | 93  | 
-- "timeout for session build job (seconds > 0)"  | 
94  | 
||
| 
51962
 
016cb7d8f297
limit build process output, to avoid bombing Isabelle/Scala process by ill-behaved jobs (e.g. Containers in AFP/9025435b29cf);
 
wenzelm 
parents: 
51960 
diff
changeset
 | 
95  | 
option process_output_limit : int = 100  | 
| 
 
016cb7d8f297
limit build process output, to avoid bombing Isabelle/Scala process by ill-behaved jobs (e.g. Containers in AFP/9025435b29cf);
 
wenzelm 
parents: 
51960 
diff
changeset
 | 
96  | 
-- "build process output limit in million characters (0 = unlimited)"  | 
| 
 
016cb7d8f297
limit build process output, to avoid bombing Isabelle/Scala process by ill-behaved jobs (e.g. Containers in AFP/9025435b29cf);
 
wenzelm 
parents: 
51960 
diff
changeset
 | 
97  | 
|
| 
56279
 
b4d874f6c6be
clarified options ML_source_trace and ML_exception_trace (NB: the latter needs to be a system option, since the context is sometimes not available, e.g. for 'theory' command);
 
wenzelm 
parents: 
56265 
diff
changeset
 | 
98  | 
|
| 
 
b4d874f6c6be
clarified options ML_source_trace and ML_exception_trace (NB: the latter needs to be a system option, since the context is sometimes not available, e.g. for 'theory' command);
 
wenzelm 
parents: 
56265 
diff
changeset
 | 
99  | 
section "ML System"  | 
| 
 
b4d874f6c6be
clarified options ML_source_trace and ML_exception_trace (NB: the latter needs to be a system option, since the context is sometimes not available, e.g. for 'theory' command);
 
wenzelm 
parents: 
56265 
diff
changeset
 | 
100  | 
|
| 
 
b4d874f6c6be
clarified options ML_source_trace and ML_exception_trace (NB: the latter needs to be a system option, since the context is sometimes not available, e.g. for 'theory' command);
 
wenzelm 
parents: 
56265 
diff
changeset
 | 
101  | 
public option ML_exception_trace : bool = false  | 
| 
 
b4d874f6c6be
clarified options ML_source_trace and ML_exception_trace (NB: the latter needs to be a system option, since the context is sometimes not available, e.g. for 'theory' command);
 
wenzelm 
parents: 
56265 
diff
changeset
 | 
102  | 
-- "ML exception trace for toplevel command execution"  | 
| 
56265
 
785569927666
discontinued Toplevel.debug in favour of system option "exception_trace";
 
wenzelm 
parents: 
55672 
diff
changeset
 | 
103  | 
|
| 49288 | 104  | 
|
| 49295 | 105  | 
section "Editor Reactivity"  | 
| 49288 | 106  | 
|
| 
52065
 
78f2475aa126
explicit notion of public options, which are shown in the editor options dialog;
 
wenzelm 
parents: 
52043 
diff
changeset
 | 
107  | 
public option editor_load_delay : real = 0.5  | 
| 49288 | 108  | 
-- "delay for file load operations (new buffers etc.)"  | 
109  | 
||
| 
52065
 
78f2475aa126
explicit notion of public options, which are shown in the editor options dialog;
 
wenzelm 
parents: 
52043 
diff
changeset
 | 
110  | 
public option editor_input_delay : real = 0.3  | 
| 49288 | 111  | 
-- "delay for user input (text edits, cursor movement etc.)"  | 
112  | 
||
| 
52065
 
78f2475aa126
explicit notion of public options, which are shown in the editor options dialog;
 
wenzelm 
parents: 
52043 
diff
changeset
 | 
113  | 
public option editor_output_delay : real = 0.1  | 
| 49288 | 114  | 
-- "delay for prover output (markup, common messages etc.)"  | 
115  | 
||
| 
57867
 
abae8aff6262
added system option editor_output_delay: lower value might help big sessions under low-memory situations;
 
wenzelm 
parents: 
56875 
diff
changeset
 | 
116  | 
public option editor_prune_delay : real = 60.0  | 
| 
 
abae8aff6262
added system option editor_output_delay: lower value might help big sessions under low-memory situations;
 
wenzelm 
parents: 
56875 
diff
changeset
 | 
117  | 
-- "delay to prune history (delete old versions)"  | 
| 
 
abae8aff6262
added system option editor_output_delay: lower value might help big sessions under low-memory situations;
 
wenzelm 
parents: 
56875 
diff
changeset
 | 
118  | 
|
| 
52065
 
78f2475aa126
explicit notion of public options, which are shown in the editor options dialog;
 
wenzelm 
parents: 
52043 
diff
changeset
 | 
119  | 
public option editor_update_delay : real = 0.5  | 
| 49288 | 120  | 
-- "delay for physical GUI updates"  | 
121  | 
||
| 
52065
 
78f2475aa126
explicit notion of public options, which are shown in the editor options dialog;
 
wenzelm 
parents: 
52043 
diff
changeset
 | 
122  | 
public option editor_reparse_limit : int = 10000  | 
| 
49524
 
68796a77c42b
Thy_Syntax.consolidate_spans is subject to editor_reparse_limit, for improved experience of unbalanced comments etc.;
 
wenzelm 
parents: 
49295 
diff
changeset
 | 
123  | 
-- "maximum amount of reparsed text outside perspective"  | 
| 
50119
 
5c370a036de7
more generous tracing_limit, with explicit system option;
 
wenzelm 
parents: 
49524 
diff
changeset
 | 
124  | 
|
| 
52065
 
78f2475aa126
explicit notion of public options, which are shown in the editor options dialog;
 
wenzelm 
parents: 
52043 
diff
changeset
 | 
125  | 
public option editor_tracing_messages : int = 1000  | 
| 
50505
 
33c92722cc3d
smarter handling of tracing messages: prover process pauses and enters user dialog;
 
wenzelm 
parents: 
50455 
diff
changeset
 | 
126  | 
-- "initial number of tracing messages for each command transaction"  | 
| 
50697
 
82e9178e6a98
improved Monitor_Dockable, based on ML_Statistics operations;
 
wenzelm 
parents: 
50505 
diff
changeset
 | 
127  | 
|
| 
52065
 
78f2475aa126
explicit notion of public options, which are shown in the editor options dialog;
 
wenzelm 
parents: 
52043 
diff
changeset
 | 
128  | 
public option editor_chart_delay : real = 3.0  | 
| 
50697
 
82e9178e6a98
improved Monitor_Dockable, based on ML_Statistics operations;
 
wenzelm 
parents: 
50505 
diff
changeset
 | 
129  | 
-- "delay for chart repainting"  | 
| 52702 | 130  | 
|
| 
52807
 
b859a180936b
simplified flag for continuous checking: avoid GUI complexity and slow checking of all theories (including prints);
 
wenzelm 
parents: 
52798 
diff
changeset
 | 
131  | 
public option editor_continuous_checking : bool = true  | 
| 
 
b859a180936b
simplified flag for continuous checking: avoid GUI complexity and slow checking of all theories (including prints);
 
wenzelm 
parents: 
52798 
diff
changeset
 | 
132  | 
-- "continuous checking of proof document (visible and required parts)"  | 
| 
 
b859a180936b
simplified flag for continuous checking: avoid GUI complexity and slow checking of all theories (including prints);
 
wenzelm 
parents: 
52798 
diff
changeset
 | 
133  | 
|
| 
52798
 
9d3c9862d1dd
recovered delay for Document.start_execution (see also 627fb639a2d9), which potentially improves throughput when many consecutive edits arrive;
 
wenzelm 
parents: 
52779 
diff
changeset
 | 
134  | 
option editor_execution_delay : real = 0.02  | 
| 
 
9d3c9862d1dd
recovered delay for Document.start_execution (see also 627fb639a2d9), which potentially improves throughput when many consecutive edits arrive;
 
wenzelm 
parents: 
52779 
diff
changeset
 | 
135  | 
-- "delay for start of execution process after document update (seconds)"  | 
| 
 
9d3c9862d1dd
recovered delay for Document.start_execution (see also 627fb639a2d9), which potentially improves throughput when many consecutive edits arrive;
 
wenzelm 
parents: 
52779 
diff
changeset
 | 
136  | 
|
| 57974 | 137  | 
option editor_syslog_limit : int = 100  | 
138  | 
-- "maximum amount of buffered syslog messages"  | 
|
139  | 
||
| 52702 | 140  | 
|
141  | 
section "Miscellaneous Tools"  | 
|
142  | 
||
143  | 
public option find_theorems_limit : int = 40  | 
|
144  | 
-- "limit of displayed results"  | 
|
145  | 
||
| 56613 | 146  | 
public option find_theorems_tactic_limit : int = 5  | 
| 52702 | 147  | 
-- "limit of tactic search for 'solves' criterion"  | 
148  | 
||
| 
55672
 
5e25cc741ab9
support for completion within the formal context;
 
wenzelm 
parents: 
53189 
diff
changeset
 | 
149  | 
|
| 
 
5e25cc741ab9
support for completion within the formal context;
 
wenzelm 
parents: 
53189 
diff
changeset
 | 
150  | 
section "Completion"  | 
| 
 
5e25cc741ab9
support for completion within the formal context;
 
wenzelm 
parents: 
53189 
diff
changeset
 | 
151  | 
|
| 
 
5e25cc741ab9
support for completion within the formal context;
 
wenzelm 
parents: 
53189 
diff
changeset
 | 
152  | 
public option completion_limit : int = 40  | 
| 
 
5e25cc741ab9
support for completion within the formal context;
 
wenzelm 
parents: 
53189 
diff
changeset
 | 
153  | 
-- "limit for completion within the formal context"  | 
| 
 
5e25cc741ab9
support for completion within the formal context;
 
wenzelm 
parents: 
53189 
diff
changeset
 | 
154  |