etc/options
author wenzelm
Tue, 06 May 2014 16:05:14 +0200
changeset 56875 f6259d6fb565
parent 56734 6ca87a061740
child 57867 abae8aff6262
permissions -rw-r--r--
explicit option parallel_print to downgrade parallel scheduling, which might occasionally help for big and heavy "scripts";
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"
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)"
bece259ee055 clarified format of etc/options: only declarations, not re-definitions;
wenzelm
parents: 48661
diff changeset
    14
option document_graph : bool = false
48580
9df76dd45900 some description of main build options;
wenzelm
parents: 48527
diff changeset
    15
  -- "generate session graph image for document"
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"
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
9df76dd45900 some description of main build options;
wenzelm
parents: 48527
diff changeset
    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
9df76dd45900 some description of main build options;
wenzelm
parents: 48527
diff changeset
    26
  -- "print original source text rather than internal representation"
52042
aae07a3ff536 Thy_Output.modes as proper option;
wenzelm
parents: 51962
diff changeset
    27
option thy_output_modes : string = ""
aae07a3ff536 Thy_Output.modes as proper option;
wenzelm
parents: 51962
diff changeset
    28
  -- "additional print modes for document output (separated by commas)"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    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
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    59
option pretty_margin : int = 76
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    60
  -- "right margin / page width of pretty printer in Isabelle/ML"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    61
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    62
option print_mode : string = ""
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    63
  -- "additional print modes for prover output (separated by commas)"
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    64
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    65
56875
f6259d6fb565 explicit option parallel_print to downgrade parallel scheduling, which might occasionally help for big and heavy "scripts";
wenzelm
parents: 56734
diff changeset
    66
section "Parallel Processing"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    67
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
    68
public option threads : int = 0
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    69
  -- "maximum number of worker threads for prover process (0 = hardware max.)"
56734
6ca87a061740 suppress potential dangerous option (see 1baa5d19ac44);
wenzelm
parents: 56613
diff changeset
    70
option threads_trace : int = 0
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    71
  -- "level of tracing information for multithreading"
56875
f6259d6fb565 explicit option parallel_print to downgrade parallel scheduling, which might occasionally help for big and heavy "scripts";
wenzelm
parents: 56734
diff changeset
    72
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
    73
  -- "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
    74
public option parallel_proofs : int = 2
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    75
  -- "level of parallel proof checking: 0, 1, 2"
52714
a4e4802753b9 obscure options;
wenzelm
parents: 52710
diff changeset
    76
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
    77
  -- "lower bound of timing estimate for forked nested proofs (seconds)"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    78
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    79
52490
wenzelm
parents: 52488
diff changeset
    80
section "Detail of Proof Checking"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    81
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    82
option quick_and_dirty : bool = false
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    83
  -- "if true then some tools will OMIT some proofs"
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    84
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
    85
  -- "skip over proofs (implicit 'sorry')"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    86
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    87
49295
2750756db9c5 more precise sections;
wenzelm
parents: 49290
diff changeset
    88
section "Global Session Parameters"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    89
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    90
option condition : string = ""
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    91
  -- "required environment variables for subsequent theories (separated by commas)"
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    92
48795
bece259ee055 clarified format of etc/options: only declarations, not re-definitions;
wenzelm
parents: 48661
diff changeset
    93
option timing : bool = false
48580
9df76dd45900 some description of main build options;
wenzelm
parents: 48527
diff changeset
    94
  -- "global timing of toplevel command execution and theory processing"
48492
03530cf284ca more build options;
wenzelm
parents: 48486
diff changeset
    95
48795
bece259ee055 clarified format of etc/options: only declarations, not re-definitions;
wenzelm
parents: 48661
diff changeset
    96
option timeout : real = 0
48661
9149ebdd0241 timeout for session build job;
wenzelm
parents: 48634
diff changeset
    97
  -- "timeout for session build job (seconds > 0)"
9149ebdd0241 timeout for session build job;
wenzelm
parents: 48634
diff changeset
    98
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
    99
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
   100
  -- "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
   101
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
   102
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
   103
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
   104
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
   105
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
   106
  -- "ML exception trace for toplevel command execution"
56265
785569927666 discontinued Toplevel.debug in favour of system option "exception_trace";
wenzelm
parents: 55672
diff changeset
   107
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   108
49295
2750756db9c5 more precise sections;
wenzelm
parents: 49290
diff changeset
   109
section "Editor Reactivity"
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   110
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   111
public option editor_load_delay : real = 0.5
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   112
  -- "delay for file load operations (new buffers etc.)"
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   113
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   114
public option editor_input_delay : real = 0.3
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   115
  -- "delay for user input (text edits, cursor movement etc.)"
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   116
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   117
public option editor_output_delay : real = 0.1
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   118
  -- "delay for prover output (markup, common messages etc.)"
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   119
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   120
public option editor_update_delay : real = 0.5
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   121
  -- "delay for physical GUI updates"
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   122
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   123
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
   124
  -- "maximum amount of reparsed text outside perspective"
50119
5c370a036de7 more generous tracing_limit, with explicit system option;
wenzelm
parents: 49524
diff changeset
   125
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   126
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
   127
  -- "initial number of tracing messages for each command transaction"
50697
82e9178e6a98 improved Monitor_Dockable, based on ML_Statistics operations;
wenzelm
parents: 50505
diff changeset
   128
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   129
public option editor_chart_delay : real = 3.0
50697
82e9178e6a98 improved Monitor_Dockable, based on ML_Statistics operations;
wenzelm
parents: 50505
diff changeset
   130
  -- "delay for chart repainting"
52702
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   131
52807
b859a180936b simplified flag for continuous checking: avoid GUI complexity and slow checking of all theories (including prints);
wenzelm
parents: 52798
diff changeset
   132
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
   133
  -- "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
   134
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
   135
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
   136
  -- "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
   137
52702
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   138
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   139
section "Miscellaneous Tools"
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   140
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   141
public option find_theorems_limit : int = 40
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   142
  -- "limit of displayed results"
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   143
56613
3518ea9f5200 tuned option name;
wenzelm
parents: 56279
diff changeset
   144
public option find_theorems_tactic_limit : int = 5
52702
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   145
  -- "limit of tactic search for 'solves' criterion"
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   146
55672
5e25cc741ab9 support for completion within the formal context;
wenzelm
parents: 53189
diff changeset
   147
5e25cc741ab9 support for completion within the formal context;
wenzelm
parents: 53189
diff changeset
   148
section "Completion"
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
public option completion_limit : int = 40
5e25cc741ab9 support for completion within the formal context;
wenzelm
parents: 53189
diff changeset
   151
  -- "limit for completion within the formal context"
5e25cc741ab9 support for completion within the formal context;
wenzelm
parents: 53189
diff changeset
   152