etc/options
author wenzelm
Fri, 29 Jun 2018 20:32:24 +0200
changeset 68546 34d732a83767
parent 68491 f0f83ce0badd
child 68661 5820f0f379ae
permissions -rw-r--r--
VSCode extension for official Isabelle release;
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
48367
680d297ec71b some basic Isabelle options;
wenzelm
parents:
diff changeset
     1
(* :mode=isabelle-options: *)
680d297ec71b some basic Isabelle options;
wenzelm
parents:
diff changeset
     2
49295
2750756db9c5 more precise sections;
wenzelm
parents: 49290
diff changeset
     3
section "Document Preparation"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
     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
9df76dd45900 some description of main build options;
wenzelm
parents: 48527
diff changeset
     6
  -- "generate theory browser information"
48367
680d297ec71b some basic Isabelle options;
wenzelm
parents:
diff changeset
     7
48795
bece259ee055 clarified format of etc/options: only declarations, not re-definitions;
wenzelm
parents: 48661
diff changeset
     8
option document : string = ""
52746
eec610972763 discontinued historic document formats;
wenzelm
parents: 52715
diff changeset
     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"
67137
wenzelm
parents: 66780
diff changeset
    13
  -- "alternative document variants (separated by colons)"
67138
82283d52b4d6 system option for default command tags;
wenzelm
parents: 67137
diff changeset
    14
option document_tags : string = ""
82283d52b4d6 system option for default command tags;
wenzelm
parents: 67137
diff changeset
    15
  -- "default command tags (separated by commas)"
48367
680d297ec71b some basic Isabelle options;
wenzelm
parents:
diff changeset
    16
48795
bece259ee055 clarified format of etc/options: only declarations, not re-definitions;
wenzelm
parents: 48661
diff changeset
    17
option thy_output_display : bool = false
48580
9df76dd45900 some description of main build options;
wenzelm
parents: 48527
diff changeset
    18
  -- "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
    19
option thy_output_break : bool = false
48580
9df76dd45900 some description of main build options;
wenzelm
parents: 48527
diff changeset
    20
  -- "control line breaks in non-display material"
48795
bece259ee055 clarified format of etc/options: only declarations, not re-definitions;
wenzelm
parents: 48661
diff changeset
    21
option thy_output_quotes : bool = false
48580
9df76dd45900 some description of main build options;
wenzelm
parents: 48527
diff changeset
    22
  -- "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
    23
option thy_output_margin : int = 76
bf465f335e85 system option "pretty_margin" is superseded by "thy_output_margin";
wenzelm
parents: 58849
diff changeset
    24
  -- "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
    25
option thy_output_indent : int = 0
48580
9df76dd45900 some description of main build options;
wenzelm
parents: 48527
diff changeset
    26
  -- "indentation for pretty printing of display material"
48795
bece259ee055 clarified format of etc/options: only declarations, not re-definitions;
wenzelm
parents: 48661
diff changeset
    27
option thy_output_source : bool = false
48580
9df76dd45900 some description of main build options;
wenzelm
parents: 48527
diff changeset
    28
  -- "print original source text rather than internal representation"
52042
aae07a3ff536 Thy_Output.modes as proper option;
wenzelm
parents: 51962
diff changeset
    29
option thy_output_modes : string = ""
aae07a3ff536 Thy_Output.modes as proper option;
wenzelm
parents: 51962
diff changeset
    30
  -- "additional print modes for document output (separated by commas)"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    31
52043
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
section "Prover Output"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    34
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    35
option show_types : bool = false
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    36
  -- "show type constraints when printing terms"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    37
option show_sorts : bool = false
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    38
  -- "show sort constraints when printing types"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    39
option show_brackets : bool = false
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    40
  -- "show extra brackets when printing terms/types"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    41
option show_question_marks : bool = true
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    42
  -- "show leading question mark of schematic variables"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    43
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    44
option show_consts : bool = false
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    45
  -- "show constants with types when printing proof state"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    46
option show_main_goal : bool = false
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    47
  -- "show main goal when printing proof state"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    48
option goals_limit : int = 10
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    49
  -- "maximum number of subgoals to be printed"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    50
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    51
option names_long : bool = false
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    52
  -- "show fully qualified names"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    53
option names_short : bool = false
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    54
  -- "show base names only"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    55
option names_unique : bool = true
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    56
  -- "show partially qualified names, as required for unique name resolution"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    57
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    58
option eta_contract : bool = true
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    59
  -- "print terms in eta-contracted form"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    60
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    61
option print_mode : string = ""
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    62
  -- "additional print modes for prover output (separated by commas)"
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    63
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    64
56875
f6259d6fb565 explicit option parallel_print to downgrade parallel scheduling, which might occasionally help for big and heavy "scripts";
wenzelm
parents: 56734
diff changeset
    65
section "Parallel Processing"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    66
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
    67
public option threads : int = 0
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    68
  -- "maximum number of worker threads for prover process (0 = hardware max.)"
56734
6ca87a061740 suppress potential dangerous option (see 1baa5d19ac44);
wenzelm
parents: 56613
diff changeset
    69
option threads_trace : int = 0
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    70
  -- "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
    71
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
    72
  -- "maximum stack size for worker threads (in giga words, 0 = unlimited)"
62790
0c526d2fb609 tuned whitespace;
wenzelm
parents: 62711
diff changeset
    73
68130
6fb85346cb79 clarified future scheduling parameters, with support for parallel_limit;
wenzelm
parents: 67743
diff changeset
    74
public option parallel_limit : int = 0
6fb85346cb79 clarified future scheduling parameters, with support for parallel_limit;
wenzelm
parents: 67743
diff changeset
    75
  -- "approximative limit for parallel tasks (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
    76
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
    77
  -- "parallel and asynchronous printing of results"
65056
002b4c8c366e clarified defaults;
wenzelm
parents: 64524
diff changeset
    78
public option parallel_proofs : int = 1
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    79
  -- "level of parallel proof checking: 0, 1, 2"
52714
a4e4802753b9 obscure options;
wenzelm
parents: 52710
diff changeset
    80
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
    81
  -- "lower bound of timing estimate for forked nested proofs (seconds)"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    82
66160
33f759742887 tuned granularity of parallel tasks;
wenzelm
parents: 66158
diff changeset
    83
option command_timing_threshold : real = 0.1
62793
f235646b1b73 less bulky timing information, e.g. HOL 56913 ~> 672;
wenzelm
parents: 62790
diff changeset
    84
  -- "default threshold for persistent command timing (seconds)"
f235646b1b73 less bulky timing information, e.g. HOL 56913 ~> 672;
wenzelm
parents: 62790
diff changeset
    85
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    86
52490
wenzelm
parents: 52488
diff changeset
    87
section "Detail of Proof Checking"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    88
65448
9bc3b57c1fa7 added system option record_proofs, which allows to build HOL-Proofs without special Proofs.thy;
wenzelm
parents: 65264
diff changeset
    89
option record_proofs : int = -1
9bc3b57c1fa7 added system option record_proofs, which allows to build HOL-Proofs without special Proofs.thy;
wenzelm
parents: 65264
diff changeset
    90
  -- "set level of proofterm recording: 0, 1, 2, negative means unchanged"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    91
option quick_and_dirty : bool = false
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    92
  -- "if true then some tools will OMIT some proofs"
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    93
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
    94
  -- "skip over proofs (implicit 'sorry')"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    95
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    96
49295
2750756db9c5 more precise sections;
wenzelm
parents: 49290
diff changeset
    97
section "Global Session Parameters"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    98
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    99
option condition : string = ""
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
   100
  -- "required environment variables for subsequent theories (separated by commas)"
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
   101
48795
bece259ee055 clarified format of etc/options: only declarations, not re-definitions;
wenzelm
parents: 48661
diff changeset
   102
option timeout : real = 0
48661
9149ebdd0241 timeout for session build job;
wenzelm
parents: 48634
diff changeset
   103
  -- "timeout for session build job (seconds > 0)"
9149ebdd0241 timeout for session build job;
wenzelm
parents: 48634
diff changeset
   104
61602
a2f0f659a3c2 added option timeout_scale;
wenzelm
parents: 61600
diff changeset
   105
option timeout_scale : real = 1.0
a2f0f659a3c2 added option timeout_scale;
wenzelm
parents: 61600
diff changeset
   106
  -- "scale factor for session timeout"
a2f0f659a3c2 added option timeout_scale;
wenzelm
parents: 61600
diff changeset
   107
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
   108
option process_output_limit : int = 100
62409
e391528eff3b proper option process_output_tail, more generous default;
wenzelm
parents: 62115
diff changeset
   109
  -- "build process output limit (in million characters, 0 = unlimited)"
e391528eff3b proper option process_output_tail, more generous default;
wenzelm
parents: 62115
diff changeset
   110
e391528eff3b proper option process_output_tail, more generous default;
wenzelm
parents: 62115
diff changeset
   111
option process_output_tail : int = 40
e391528eff3b proper option process_output_tail, more generous default;
wenzelm
parents: 62115
diff changeset
   112
  -- "build process output tail shown to user (in lines, 0 = unlimited)"
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
   113
63827
b24d0e53dd03 option "checkpoint" helps to fine-tune global heap space management;
wenzelm
parents: 62886
diff changeset
   114
option checkpoint : bool = false
b24d0e53dd03 option "checkpoint" helps to fine-tune global heap space management;
wenzelm
parents: 62886
diff changeset
   115
  -- "checkpoint for theories during build process (heap compression)"
b24d0e53dd03 option "checkpoint" helps to fine-tune global heap space management;
wenzelm
parents: 62886
diff changeset
   116
64308
b00508facb4f added system option "profiling";
wenzelm
parents: 64130
diff changeset
   117
option profiling : string = ""
b00508facb4f added system option "profiling";
wenzelm
parents: 64130
diff changeset
   118
  -- "ML profiling (possible values: time, allocations)"
b00508facb4f added system option "profiling";
wenzelm
parents: 64130
diff changeset
   119
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
   120
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
   121
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
   122
62711
09df6a51ad3c avoid hardwired values;
wenzelm
parents: 62498
diff changeset
   123
option ML_print_depth : int = 20
09df6a51ad3c avoid hardwired values;
wenzelm
parents: 62498
diff changeset
   124
  -- "ML print depth for toplevel pretty-printing"
09df6a51ad3c avoid hardwired values;
wenzelm
parents: 62498
diff changeset
   125
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
   126
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
   127
  -- "ML exception trace for toplevel command execution"
56265
785569927666 discontinued Toplevel.debug in favour of system option "exception_trace";
wenzelm
parents: 55672
diff changeset
   128
62498
5dfcc9697f29 support for ML_exception_debugger;
wenzelm
parents: 62409
diff changeset
   129
public option ML_exception_debugger : bool = false
5dfcc9697f29 support for ML_exception_debugger;
wenzelm
parents: 62409
diff changeset
   130
  -- "ML debugger exception trace for toplevel command execution"
5dfcc9697f29 support for ML_exception_debugger;
wenzelm
parents: 62409
diff changeset
   131
60730
02c2860fcf30 added option ML_debugger;
wenzelm
parents: 60074
diff changeset
   132
public option ML_debugger : bool = false
02c2860fcf30 added option ML_debugger;
wenzelm
parents: 60074
diff changeset
   133
  -- "ML debugger instrumentation for newly compiled code"
02c2860fcf30 added option ML_debugger;
wenzelm
parents: 60074
diff changeset
   134
60074
38a64cc17403 GUI controls for ML_statistics, for more digestible protocol dump;
wenzelm
parents: 59468
diff changeset
   135
public option ML_statistics : bool = true
60843
9980f3bcdea2 tuned signature;
wenzelm
parents: 60765
diff changeset
   136
  -- "ML run-time system statistics"
60074
38a64cc17403 GUI controls for ML_statistics, for more digestible protocol dump;
wenzelm
parents: 59468
diff changeset
   137
61158
ea6a4c8bc722 convenient change of ML system architecture via system option ML_preference_64, which is grepped off-line from stored preferences during bootstrap;
wenzelm
parents: 60889
diff changeset
   138
public option ML_system_64 : bool = false
ea6a4c8bc722 convenient change of ML system architecture via system option ML_preference_64, which is grepped off-line from stored preferences during bootstrap;
wenzelm
parents: 60889
diff changeset
   139
  -- "ML system for 64bit platform is used if possible (change requires restart)"
ea6a4c8bc722 convenient change of ML system architecture via system option ML_preference_64, which is grepped off-line from stored preferences during bootstrap;
wenzelm
parents: 60889
diff changeset
   140
63986
c7a4b03727ae options for process policy, notably for multiprocessor machines;
wenzelm
parents: 63827
diff changeset
   141
public option ML_process_policy : string = ""
c7a4b03727ae options for process policy, notably for multiprocessor machines;
wenzelm
parents: 63827
diff changeset
   142
  -- "ML process command prefix (process policy)"
c7a4b03727ae options for process policy, notably for multiprocessor machines;
wenzelm
parents: 63827
diff changeset
   143
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   144
49295
2750756db9c5 more precise sections;
wenzelm
parents: 49290
diff changeset
   145
section "Editor Reactivity"
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   146
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   147
public option editor_load_delay : real = 0.5
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   148
  -- "delay for file load operations (new buffers etc.)"
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   149
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   150
public option editor_input_delay : real = 0.3
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   151
  -- "delay for user input (text edits, cursor movement etc.)"
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   152
64524
e6a3c55b929b explicit option editor_generated_input_delay, which is more aggressive by default;
wenzelm
parents: 64325
diff changeset
   153
public option editor_generated_input_delay : real = 1.0
e6a3c55b929b explicit option editor_generated_input_delay, which is more aggressive by default;
wenzelm
parents: 64325
diff changeset
   154
  -- "delay for machine-generated input that may outperform user edits"
e6a3c55b929b explicit option editor_generated_input_delay, which is more aggressive by default;
wenzelm
parents: 64325
diff changeset
   155
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   156
public option editor_output_delay : real = 0.1
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   157
  -- "delay for prover output (markup, common messages etc.)"
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   158
68381
2fd3a6d6ba2e less wasteful consolidation, based on PIDE front-end state and recent changes;
wenzelm
parents: 68352
diff changeset
   159
public option editor_consolidate_delay : real = 2.0
66379
6392766f3c25 maintain "consolidated" status of theory nodes, which means all evals are finished (but not necessarily prints nor imports);
wenzelm
parents: 66160
diff changeset
   160
  -- "delay to consolidate status of command evaluation (execution forks)"
6392766f3c25 maintain "consolidated" status of theory nodes, which means all evals are finished (but not necessarily prints nor imports);
wenzelm
parents: 66160
diff changeset
   161
62115
57895801cb57 prune old versions more often, to reduce overall heap requirements;
wenzelm
parents: 61873
diff changeset
   162
public option editor_prune_delay : real = 15
57867
abae8aff6262 added system option editor_output_delay: lower value might help big sessions under low-memory situations;
wenzelm
parents: 56875
diff changeset
   163
  -- "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
   164
65264
7e6ecd04b5fe dynamic session_options for tuning parameters and initial prover options;
wenzelm
parents: 65141
diff changeset
   165
option editor_prune_size : int = 0
7e6ecd04b5fe dynamic session_options for tuning parameters and initial prover options;
wenzelm
parents: 65141
diff changeset
   166
  -- "retained size of pruned history (delete old versions)"
7e6ecd04b5fe dynamic session_options for tuning parameters and initial prover options;
wenzelm
parents: 65141
diff changeset
   167
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   168
public option editor_update_delay : real = 0.5
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   169
  -- "delay for physical GUI updates"
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   170
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   171
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
   172
  -- "maximum amount of reparsed text outside perspective"
50119
5c370a036de7 more generous tracing_limit, with explicit system option;
wenzelm
parents: 49524
diff changeset
   173
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   174
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
   175
  -- "initial number of tracing messages for each command transaction"
50697
82e9178e6a98 improved Monitor_Dockable, based on ML_Statistics operations;
wenzelm
parents: 50505
diff changeset
   176
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   177
public option editor_chart_delay : real = 3.0
50697
82e9178e6a98 improved Monitor_Dockable, based on ML_Statistics operations;
wenzelm
parents: 50505
diff changeset
   178
  -- "delay for chart repainting"
52702
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   179
52807
b859a180936b simplified flag for continuous checking: avoid GUI complexity and slow checking of all theories (including prints);
wenzelm
parents: 52798
diff changeset
   180
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
   181
  -- "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
   182
61604
bb20f11dd842 prefer explicit State panel;
wenzelm
parents: 61602
diff changeset
   183
public option editor_output_state : bool = false
61213
0b1a092385c7 option editor_output_state;
wenzelm
parents: 61158
diff changeset
   184
  -- "implicit output of proof state"
0b1a092385c7 option editor_output_state;
wenzelm
parents: 61158
diff changeset
   185
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
   186
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
   187
  -- "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
   188
57974
ba0b6c2338f0 added option editor_syslog_limit;
wenzelm
parents: 57867
diff changeset
   189
option editor_syslog_limit : int = 100
ba0b6c2338f0 added option editor_syslog_limit;
wenzelm
parents: 57867
diff changeset
   190
  -- "maximum amount of buffered syslog messages"
ba0b6c2338f0 added option editor_syslog_limit;
wenzelm
parents: 57867
diff changeset
   191
68197
7857817403e4 clarified "consolidation" vs. "presentation";
wenzelm
parents: 68184
diff changeset
   192
public option editor_presentation : bool = false
7857817403e4 clarified "consolidation" vs. "presentation";
wenzelm
parents: 68184
diff changeset
   193
  -- "dynamic presentation while editing"
68184
6c693b2700b3 support for dynamic document output while editing;
wenzelm
parents: 68154
diff changeset
   194
52702
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   195
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   196
section "Miscellaneous Tools"
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   197
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   198
public option find_theorems_limit : int = 40
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   199
  -- "limit of displayed results"
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   200
56613
3518ea9f5200 tuned option name;
wenzelm
parents: 56279
diff changeset
   201
public option find_theorems_tactic_limit : int = 5
52702
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   202
  -- "limit of tactic search for 'solves' criterion"
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   203
55672
5e25cc741ab9 support for completion within the formal context;
wenzelm
parents: 53189
diff changeset
   204
5e25cc741ab9 support for completion within the formal context;
wenzelm
parents: 53189
diff changeset
   205
section "Completion"
5e25cc741ab9 support for completion within the formal context;
wenzelm
parents: 53189
diff changeset
   206
5e25cc741ab9 support for completion within the formal context;
wenzelm
parents: 53189
diff changeset
   207
public option completion_limit : int = 40
5e25cc741ab9 support for completion within the formal context;
wenzelm
parents: 53189
diff changeset
   208
  -- "limit for completion within the formal context"
64130
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   209
66158
ad83d4971dfe clarified modules;
wenzelm
parents: 65782
diff changeset
   210
public option completion_path_ignore : string = "*~:*.marks:*.orig:*.rej:.DS_Store"
ad83d4971dfe clarified modules;
wenzelm
parents: 65782
diff changeset
   211
  -- "glob patterns to ignore in file-system path completion (separated by colons)"
ad83d4971dfe clarified modules;
wenzelm
parents: 65782
diff changeset
   212
64130
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   213
65141
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   214
section "Spell Checker"
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   215
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   216
public option spell_checker : bool = true
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   217
  -- "enable spell-checker for prose words within document text, comments etc."
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   218
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   219
public option spell_checker_dictionary : string = "en"
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   220
  -- "spell-checker dictionary name"
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   221
67395
b39d596b77ce more accurate spell-checking for nested quotations / antiquotations, notably in formal comments;
wenzelm
parents: 67273
diff changeset
   222
public option spell_checker_include : string = "words,comment,inner_comment,ML_comment,SML_comment"
b39d596b77ce more accurate spell-checking for nested quotations / antiquotations, notably in formal comments;
wenzelm
parents: 67273
diff changeset
   223
  -- "included markup elements for spell-checker (separated by commas)"
b39d596b77ce more accurate spell-checking for nested quotations / antiquotations, notably in formal comments;
wenzelm
parents: 67273
diff changeset
   224
67506
30233285270a more markup: disable spell-checker for raw latex;
wenzelm
parents: 67395
diff changeset
   225
public option spell_checker_exclude : string = "no_words,antiquoted"
67395
b39d596b77ce more accurate spell-checking for nested quotations / antiquotations, notably in formal comments;
wenzelm
parents: 67273
diff changeset
   226
  -- "excluded markup elements for spell-checker (separated by commas)"
65141
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   227
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   228
64130
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   229
section "Secure Shell"
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   230
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   231
option ssh_config_dir : string = "~/.ssh"
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   232
  -- "SSH configuration directory"
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   233
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   234
option ssh_config_file : string = "~/.ssh/config"
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   235
  -- "main SSH configuration file"
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   236
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   237
option ssh_identity_files : string = "~/.ssh/id_dsa:~/.ssh/id_ecdsa:~/.ssh/id_rsa"
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   238
  -- "possible SSH identity files (separated by colons)"
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   239
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   240
option ssh_compression : bool = true
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   241
  -- "enable SSH compression"
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   242
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   243
option ssh_connect_timeout : real = 60
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   244
  -- "SSH connection timeout (seconds)"
64325
47e03cb99274 prevent sporadic disconnection;
wenzelm
parents: 64308
diff changeset
   245
47e03cb99274 prevent sporadic disconnection;
wenzelm
parents: 64308
diff changeset
   246
option ssh_alive_interval : real = 30
47e03cb99274 prevent sporadic disconnection;
wenzelm
parents: 64308
diff changeset
   247
  -- "time interval to keep SSH server connection alive (seconds)"
65595
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   248
67273
c573cfb2c407 more robust connection: prefer ServerAliveCountMax=3 (ssh default) instead of 1 (jsch default);
wenzelm
parents: 67194
diff changeset
   249
option ssh_alive_count_max : int = 3
c573cfb2c407 more robust connection: prefer ServerAliveCountMax=3 (ssh default) instead of 1 (jsch default);
wenzelm
parents: 67194
diff changeset
   250
  -- "maximum number of messages to keep SSH server connection alive"
c573cfb2c407 more robust connection: prefer ServerAliveCountMax=3 (ssh default) instead of 1 (jsch default);
wenzelm
parents: 67194
diff changeset
   251
65595
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   252
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   253
section "Theory Export"
68154
42d63ea39161 some export of foundational theory content;
wenzelm
parents: 68130
diff changeset
   254
68491
f0f83ce0badd disable export_document by default (presently unused and for demo/testing purposes): avoid spurious IO exception in highly parallel environment;
wenzelm
parents: 68381
diff changeset
   255
option export_document : bool = false
f0f83ce0badd disable export_document by default (presently unused and for demo/testing purposes): avoid spurious IO exception in highly parallel environment;
wenzelm
parents: 68381
diff changeset
   256
68154
42d63ea39161 some export of foundational theory content;
wenzelm
parents: 68130
diff changeset
   257
option export_theory : bool = false
42d63ea39161 some export of foundational theory content;
wenzelm
parents: 68130
diff changeset
   258
42d63ea39161 some export of foundational theory content;
wenzelm
parents: 68130
diff changeset
   259
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   260
section "Build Database"
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   261
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   262
option build_database_server : bool = false
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   263
option build_database_user : string = ""
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   264
option build_database_password : string = ""
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   265
option build_database_name : string = ""
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   266
option build_database_host : string = ""
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   267
option build_database_port : int = 0
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   268
option build_database_ssh_host : string = ""
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   269
option build_database_ssh_user : string = ""
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   270
option build_database_ssh_port : int = 0
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   271
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   272
65595
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   273
section "Build Log Database"
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   274
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   275
option build_log_database_user : string = ""
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   276
option build_log_database_password : string = ""
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   277
option build_log_database_name : string = ""
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   278
option build_log_database_host : string = ""
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   279
option build_log_database_port : int = 0
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   280
option build_log_ssh_host : string = ""
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   281
option build_log_ssh_user : string = ""
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   282
option build_log_ssh_port : int = 0
65782
4935bac8a850 simplified default;
wenzelm
parents: 65595
diff changeset
   283
option build_log_history : int = 30  -- "length of relevant history (in days)"
67743
7bd0a250183b avoid hardwired parameters;
wenzelm
parents: 67506
diff changeset
   284
option build_log_transaction_size : int = 1  -- "number of log files for each db update"