etc/options
author wenzelm
Sun, 14 Jan 2024 20:55:58 +0100
changeset 79487 47272fac86d8
parent 79483 299568e54fac
child 79526 6e5397fcc41b
permissions -rw-r--r--
support Phabricator on Ubuntu 22.04 LTS with PHP 8.1, using community form we.phorge.it version "2023 week 49";
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
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
     5
option browser_info : bool = false for build
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
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
     8
option document : string = "" (standard "true") for build
73827
263dc905d795 updated descriptions;
wenzelm
parents: 73821
diff changeset
     9
  -- "build PDF document (enabled for \"pdf\" or \"true\", disabled for \"\" or \"false\")"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    10
option document_output : string = "" (standard "output") for build
72578
3e8395f9093a clarified build_doc, based on Present.build_documents;
wenzelm
parents: 72300
diff changeset
    11
  -- "document output directory"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    12
option document_echo : bool = false for build
74732
015282fb3e31 clarified messages, depending on option "document_echo";
wenzelm
parents: 74147
diff changeset
    13
  -- "inform about document file names during session presentation"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    14
option document_variants : string = "document" for build document
67137
wenzelm
parents: 66780
diff changeset
    15
  -- "alternative document variants (separated by colons)"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    16
option document_tags : string = "" for document
67138
82283d52b4d6 system option for default command tags;
wenzelm
parents: 67137
diff changeset
    17
  -- "default command tags (separated by commas)"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    18
option document_bibliography : bool = false for document
73743
813a08dff3fd explicit option document_bibliography;
wenzelm
parents: 73735
diff changeset
    19
  -- "explicitly enable use of bibtex (default: according to presence of root.bib)"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    20
option document_build : string = "lualatex" (standard "build") for document
74827
c1b5d6e6ff74 clarified system option standard values: avoid oddities like "isabelle build -o document_output" producing directories named "true";
wenzelm
parents: 74824
diff changeset
    21
  -- "document build engine (e.g. build, lualatex, pdflatex)"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    22
option document_logo : string = "" (standard "_") for document
73723
1bbbaae6b5e3 option document_logo;
wenzelm
parents: 73721
diff changeset
    23
  -- "generate named instance of Isabelle logo (underscore means unnamed variant)"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    24
option document_heading_prefix : string = "isamarkup" (standard) for document
74824
6424f74fd9d4 Latex.Output.latex_heading depends on option document_heading_prefix, e.g. relevant for Dagstuhl LIPIcs which prefers unaliased \section etc.;
wenzelm
parents: 74733
diff changeset
    25
  -- "prefix for LaTeX macros generated from 'chapter', 'section' etc."
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    26
option document_comment_latex : bool = false for document
74840
4faf0ec33cbf option document_comment_latex supports e.g. Dagstuhl LIPIcs;
wenzelm
parents: 74827
diff changeset
    27
  -- "use regular LaTeX version of comment.sty, instead of historic plain TeX version"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    28
option document_cite_commands : string = "cite,nocite,citet,citep" for document
76986
1e31ddcab458 clarified treatment of cite macro name;
wenzelm
parents: 76981
diff changeset
    29
  -- "antiquotation commands to determine the structure of bibliography"
48367
680d297ec71b some basic Isabelle options;
wenzelm
parents:
diff changeset
    30
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    31
option thy_output_display : bool = false for content
48580
9df76dd45900 some description of main build options;
wenzelm
parents: 48527
diff changeset
    32
  -- "indicate output as multi-line display-style material"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    33
option thy_output_break : bool = false for content
48580
9df76dd45900 some description of main build options;
wenzelm
parents: 48527
diff changeset
    34
  -- "control line breaks in non-display material"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    35
option thy_output_cartouche : bool = false for content
70121
61e26527480e added document antiquotation option "cartouche";
wenzelm
parents: 69968
diff changeset
    36
  -- "indicate if the output should be delimited as cartouche"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    37
option thy_output_quotes : bool = false for content
70121
61e26527480e added document antiquotation option "cartouche";
wenzelm
parents: 69968
diff changeset
    38
  -- "indicate if the output should be delimited via double quotes"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    39
option thy_output_margin : int = 76 for content
59175
bf465f335e85 system option "pretty_margin" is superseded by "thy_output_margin";
wenzelm
parents: 58849
diff changeset
    40
  -- "right margin / page width for printing of display material"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    41
option thy_output_indent : int = 0 for content
48580
9df76dd45900 some description of main build options;
wenzelm
parents: 48527
diff changeset
    42
  -- "indentation for pretty printing of display material"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    43
option thy_output_source : bool = false for content
48580
9df76dd45900 some description of main build options;
wenzelm
parents: 48527
diff changeset
    44
  -- "print original source text rather than internal representation"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    45
option thy_output_source_cartouche : bool = false for content
70122
a0b21b4b7a4a strip cartouches from arguments of "embedded" document antiquotations, corresponding to automated update via "isabelle update -u control_cartouches" -- e.g. relevant for documents with thy_output_source (e.g. doc "isar-ref", "jedit", "system");
wenzelm
parents: 70121
diff changeset
    46
  -- "print original source text rather than internal representation, preserve cartouches"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    47
option thy_output_modes : string = "" for content
52042
aae07a3ff536 Thy_Output.modes as proper option;
wenzelm
parents: 51962
diff changeset
    48
  -- "additional print modes for document output (separated by commas)"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    49
52043
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
section "Prover Output"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    52
77674
488a48453d74 clarified build options;
wenzelm
parents: 77606
diff changeset
    53
option pide_reports : bool = true for content
488a48453d74 clarified build options;
wenzelm
parents: 77606
diff changeset
    54
  -- "enable reports of PIDE markup"
488a48453d74 clarified build options;
wenzelm
parents: 77606
diff changeset
    55
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    56
option show_types : bool = false for content
52043
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    57
  -- "show type constraints when printing terms"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    58
option show_sorts : bool = false for content
52043
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    59
  -- "show sort constraints when printing types"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    60
option show_brackets : bool = false for content
52043
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    61
  -- "show extra brackets when printing terms/types"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    62
option show_question_marks : bool = true for content
52043
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    63
  -- "show leading question mark of schematic variables"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    64
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    65
option show_consts : bool = false for content
52043
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    66
  -- "show constants with types when printing proof state"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    67
option show_main_goal : bool = false for content
52043
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    68
  -- "show main goal when printing proof state"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    69
option goals_limit : int = 10 for content
52043
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    70
  -- "maximum number of subgoals to be printed"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    71
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    72
option show_states : bool = false for content
76073
951abf9db857 option "show_states" for more verbosity of batch-builds;
wenzelm
parents: 76068
diff changeset
    73
  -- "show toplevel states even if outside of interactive mode"
951abf9db857 option "show_states" for more verbosity of batch-builds;
wenzelm
parents: 76068
diff changeset
    74
951abf9db857 option "show_states" for more verbosity of batch-builds;
wenzelm
parents: 76068
diff changeset
    75
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    76
option names_long : bool = false for content
52043
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    77
  -- "show fully qualified names"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    78
option names_short : bool = false for content
52043
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    79
  -- "show base names only"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    80
option names_unique : bool = true for content
52043
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    81
  -- "show partially qualified names, as required for unique name resolution"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    82
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    83
option eta_contract : bool = true for content
52043
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    84
  -- "print terms in eta-contracted form"
286629271d65 more system options as context-sensitive config options;
wenzelm
parents: 52042
diff changeset
    85
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    86
option print_mode : string = "" for content
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    87
  -- "additional print modes for prover output (separated by commas)"
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    88
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    89
73387
3b5196dac4c8 clarified timeouts in Isabelle/ML;
wenzelm
parents: 73195
diff changeset
    90
section "Parallel Processing and Timing"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    91
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    92
public option threads : int = 0 for build
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    93
  -- "maximum number of worker threads for prover process (0 = hardware max.)"
56734
6ca87a061740 suppress potential dangerous option (see 1baa5d19ac44);
wenzelm
parents: 56613
diff changeset
    94
option threads_trace : int = 0
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
    95
  -- "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
    96
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
    97
  -- "maximum stack size for worker threads (in giga words, 0 = unlimited)"
62790
0c526d2fb609 tuned whitespace;
wenzelm
parents: 62711
diff changeset
    98
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
    99
public option parallel_limit : int = 0 for build
68130
6fb85346cb79 clarified future scheduling parameters, with support for parallel_limit;
wenzelm
parents: 67743
diff changeset
   100
  -- "approximative limit for parallel tasks (0 = unlimited)"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   101
public option parallel_print : bool = true for build
56875
f6259d6fb565 explicit option parallel_print to downgrade parallel scheduling, which might occasionally help for big and heavy "scripts";
wenzelm
parents: 56734
diff changeset
   102
  -- "parallel and asynchronous printing of results"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   103
public option parallel_proofs : int = 1 for build
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
   104
  -- "level of parallel proof checking: 0, 1, 2"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   105
option parallel_subproofs_threshold : real = 0.01 for build
51423
e5f9a6d9ca82 clarified parallel_subproofs_saturation (blind guess) vs. parallel_subproofs_threshold (precient timing estimate);
wenzelm
parents: 51230
diff changeset
   106
  -- "lower bound of timing estimate for forked nested proofs (seconds)"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
   107
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   108
option command_timing_threshold : real = 0.1 for build
62793
f235646b1b73 less bulky timing information, e.g. HOL 56913 ~> 672;
wenzelm
parents: 62790
diff changeset
   109
  -- "default threshold for persistent command timing (seconds)"
f235646b1b73 less bulky timing information, e.g. HOL 56913 ~> 672;
wenzelm
parents: 62790
diff changeset
   110
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   111
public option timeout_scale : real = 1.0 for build
73387
3b5196dac4c8 clarified timeouts in Isabelle/ML;
wenzelm
parents: 73195
diff changeset
   112
  -- "scale factor for timeout in Isabelle/ML and session build"
3b5196dac4c8 clarified timeouts in Isabelle/ML;
wenzelm
parents: 73195
diff changeset
   113
78018
dfa44d85d751 proper system options to control context tracing/timing;
wenzelm
parents: 77715
diff changeset
   114
option context_data_timing : bool = false for build
dfa44d85d751 proper system options to control context tracing/timing;
wenzelm
parents: 77715
diff changeset
   115
  -- "timing for context data operations"
dfa44d85d751 proper system options to control context tracing/timing;
wenzelm
parents: 77715
diff changeset
   116
dfa44d85d751 proper system options to control context tracing/timing;
wenzelm
parents: 77715
diff changeset
   117
option context_theory_tracing : bool = false for build
dfa44d85d751 proper system options to control context tracing/timing;
wenzelm
parents: 77715
diff changeset
   118
  -- "tracing of persistent theory values within ML heap"
dfa44d85d751 proper system options to control context tracing/timing;
wenzelm
parents: 77715
diff changeset
   119
dfa44d85d751 proper system options to control context tracing/timing;
wenzelm
parents: 77715
diff changeset
   120
option context_proof_tracing : bool = false for build
dfa44d85d751 proper system options to control context tracing/timing;
wenzelm
parents: 77715
diff changeset
   121
  -- "tracing of persistent Proof.context values within ML heap"
dfa44d85d751 proper system options to control context tracing/timing;
wenzelm
parents: 77715
diff changeset
   122
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
   123
52490
wenzelm
parents: 52488
diff changeset
   124
section "Detail of Proof Checking"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
   125
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   126
option record_proofs : int = -1 for content
65448
9bc3b57c1fa7 added system option record_proofs, which allows to build HOL-Proofs without special Proofs.thy;
wenzelm
parents: 65264
diff changeset
   127
  -- "set level of proofterm recording: 0, 1, 2, negative means unchanged"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   128
option quick_and_dirty : bool = false for content
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
   129
  -- "if true then some tools will OMIT some proofs"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   130
option skip_proofs : bool = false for content
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
   131
  -- "skip over proofs (implicit 'sorry')"
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   132
option strict_facts : bool = false for content
68661
5820f0f379ae added system option "strict_facts";
wenzelm
parents: 68491
diff changeset
   133
  -- "force lazy facts when defined in context"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
   134
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
   135
49295
2750756db9c5 more precise sections;
wenzelm
parents: 49290
diff changeset
   136
section "Global Session Parameters"
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
   137
78431
1ab113f4db74 clarified option (see also b66b6cc1eb8c);
wenzelm
parents: 78409
diff changeset
   138
option context : string = "" for content
1ab113f4db74 clarified option (see also b66b6cc1eb8c);
wenzelm
parents: 78409
diff changeset
   139
  -- "free-form information for session content (to be interpreted in Isabelle/ML)"
1ab113f4db74 clarified option (see also b66b6cc1eb8c);
wenzelm
parents: 78409
diff changeset
   140
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   141
option condition : string = "" for content
49270
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
   142
  -- "required environment variables for subsequent theories (separated by commas)"
e5d162d15867 some support to organize options in sections;
wenzelm
parents: 48805
diff changeset
   143
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   144
option timeout : real = 0 for build
48661
9149ebdd0241 timeout for session build job;
wenzelm
parents: 48634
diff changeset
   145
  -- "timeout for session build job (seconds > 0)"
9149ebdd0241 timeout for session build job;
wenzelm
parents: 48634
diff changeset
   146
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   147
option timeout_build : bool = true for build
73701
d83e7e444b43 ignore session build timeout, notably in AFP;
wenzelm
parents: 73691
diff changeset
   148
  -- "observe timeout for session build"
d83e7e444b43 ignore session build timeout, notably in AFP;
wenzelm
parents: 73691
diff changeset
   149
77483
291f5848bf55 clarified names;
wenzelm
parents: 77390
diff changeset
   150
option process_policy : string = ""
291f5848bf55 clarified names;
wenzelm
parents: 77390
diff changeset
   151
  -- "command prefix for underlying process, notably ML with NUMA policy"
291f5848bf55 clarified names;
wenzelm
parents: 77390
diff changeset
   152
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   153
option process_output_tail : int = 40 for build
62409
e391528eff3b proper option process_output_tail, more generous default;
wenzelm
parents: 62115
diff changeset
   154
  -- "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
   155
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   156
option profiling : string = "" (standard "time") for build
76041
4a1330addb4e proper description;
wenzelm
parents: 74840
diff changeset
   157
  -- "ML profiling (possible values: time, time_thread, allocations)"
64308
b00508facb4f added system option "profiling";
wenzelm
parents: 64130
diff changeset
   158
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   159
option system_log : string = "" (standard "-") for build
74827
c1b5d6e6ff74 clarified system option standard values: avoid oddities like "isabelle build -o document_output" producing directories named "true";
wenzelm
parents: 74824
diff changeset
   160
  -- "output for system messages (log file or \"-\" for console progress)"
73777
52e43a93d51f clarified system_log: make this work independently of the particular "isabelle build" command-line (e.g. "isabelle mirabelle");
wenzelm
parents: 73743
diff changeset
   161
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   162
option system_heaps : bool = false for build
69854
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 69755
diff changeset
   163
  -- "store session heaps in $ISABELLE_HEAPS_SYSTEM, not $ISABELLE_HEAPS"
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 69755
diff changeset
   164
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
   165
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
   166
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
   167
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   168
option ML_print_depth : int = 20 for content
62711
09df6a51ad3c avoid hardwired values;
wenzelm
parents: 62498
diff changeset
   169
  -- "ML print depth for toplevel pretty-printing"
09df6a51ad3c avoid hardwired values;
wenzelm
parents: 62498
diff changeset
   170
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
   171
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
   172
  -- "ML exception trace for toplevel command execution"
56265
785569927666 discontinued Toplevel.debug in favour of system option "exception_trace";
wenzelm
parents: 55672
diff changeset
   173
62498
5dfcc9697f29 support for ML_exception_debugger;
wenzelm
parents: 62409
diff changeset
   174
public option ML_exception_debugger : bool = false
5dfcc9697f29 support for ML_exception_debugger;
wenzelm
parents: 62409
diff changeset
   175
  -- "ML debugger exception trace for toplevel command execution"
5dfcc9697f29 support for ML_exception_debugger;
wenzelm
parents: 62409
diff changeset
   176
60730
02c2860fcf30 added option ML_debugger;
wenzelm
parents: 60074
diff changeset
   177
public option ML_debugger : bool = false
02c2860fcf30 added option ML_debugger;
wenzelm
parents: 60074
diff changeset
   178
  -- "ML debugger instrumentation for newly compiled code"
02c2860fcf30 added option ML_debugger;
wenzelm
parents: 60074
diff changeset
   179
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   180
public option ML_system_64 : bool = false for build
76276
13b733e78c26 tuned comment;
wenzelm
parents: 76275
diff changeset
   181
  -- "prefer native 64bit platform (change requires restart)"
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
   182
78309
fc6246225283 revert ineffective b04ac8a017b2: etc/settings of polyml components needs to be changed as well;
wenzelm
parents: 78306
diff changeset
   183
public option ML_system_apple : bool = true for build
76275
b446004b2464 support for system option ML_system_apple: emulated x86_64 Poly/ML is sometimes more stable than native ARM64;
wenzelm
parents: 76212
diff changeset
   184
  -- "prefer native Apple/ARM64 platform (change requires restart)"
b446004b2464 support for system option ML_system_apple: emulated x86_64 Poly/ML is sometimes more stable than native ARM64;
wenzelm
parents: 76212
diff changeset
   185
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   186
77330
47eb96592aa2 support alternative build engines, via system option "build_engine";
wenzelm
parents: 77149
diff changeset
   187
section "Build Process"
71675
55cb4271858b less redundant markup reports;
wenzelm
parents: 71651
diff changeset
   188
77675
9e5f8f6e58a0 more thorough treatment of build prefs, guarded by system option "build_through": avoid accidental rebuild of HOL etc.;
wenzelm
parents: 77674
diff changeset
   189
option build_thorough : bool = false
9e5f8f6e58a0 more thorough treatment of build prefs, guarded by system option "build_through": avoid accidental rebuild of HOL etc.;
wenzelm
parents: 77674
diff changeset
   190
  -- "observe dependencies on options with tag 'content' or 'document'"
9e5f8f6e58a0 more thorough treatment of build prefs, guarded by system option "build_through": avoid accidental rebuild of HOL etc.;
wenzelm
parents: 77674
diff changeset
   191
77384
ef6673859c38 option build_hostname allows to change hostname easily;
wenzelm
parents: 77372
diff changeset
   192
option build_hostname : string = ""
ef6673859c38 option build_hostname allows to change hostname easily;
wenzelm
parents: 77372
diff changeset
   193
  -- "alternative hostname for build process (default $ISABELLE_HOSTNAME)"
ef6673859c38 option build_hostname allows to change hostname easily;
wenzelm
parents: 77372
diff changeset
   194
77330
47eb96592aa2 support alternative build engines, via system option "build_engine";
wenzelm
parents: 77149
diff changeset
   195
option build_engine : string = ""
47eb96592aa2 support alternative build engines, via system option "build_engine";
wenzelm
parents: 77149
diff changeset
   196
  -- "alternative session build engine"
47eb96592aa2 support alternative build engines, via system option "build_engine";
wenzelm
parents: 77149
diff changeset
   197
78511
f5fb5bb2533f clarified option name (see also ff43a524aa5d);
wenzelm
parents: 78440
diff changeset
   198
option build_database : bool = false
77372
44fe9fe96130 support for build database: still inactive;
wenzelm
parents: 77363
diff changeset
   199
  -- "expose state of build process via central database"
44fe9fe96130 support for build database: still inactive;
wenzelm
parents: 77363
diff changeset
   200
78189
e9f96422f607 afford larger build_database_slice for better compression (HOL: 1 slice, HOL-Proofs: multiple slices for testing);
wenzelm
parents: 78188
diff changeset
   201
option build_database_slice : real = 300
78188
fd68b98de1f6 prefer system option;
wenzelm
parents: 78018
diff changeset
   202
  -- "slice size in MiB for ML heap stored within database"
fd68b98de1f6 prefer system option;
wenzelm
parents: 78018
diff changeset
   203
78406
2ece6509ad6f clarified options: accommodate potentially slow database connection;
wenzelm
parents: 78404
diff changeset
   204
option build_delay : real = 0.2
78409
f2d67c78b689 clarified options;
wenzelm
parents: 78406
diff changeset
   205
  -- "delay build process main loop (local)"
78364
e33cca11b474 clarified options;
wenzelm
parents: 78309
diff changeset
   206
78409
f2d67c78b689 clarified options;
wenzelm
parents: 78406
diff changeset
   207
option build_cluster_delay : real = 1.0
f2d67c78b689 clarified options;
wenzelm
parents: 78406
diff changeset
   208
  -- "delay build process main loop (cluster)"
78406
2ece6509ad6f clarified options: accommodate potentially slow database connection;
wenzelm
parents: 78404
diff changeset
   209
78440
126a12483c67 support for Build_Cluster.Session.init (rsync + Admin/init);
wenzelm
parents: 78431
diff changeset
   210
option build_cluster_root : string = "$USER_HOME/.isabelle/build_cluster"
126a12483c67 support for Build_Cluster.Session.init (rsync + Admin/init);
wenzelm
parents: 78431
diff changeset
   211
  -- "root directory for remote build cluster sessions"
126a12483c67 support for Build_Cluster.Session.init (rsync + Admin/init);
wenzelm
parents: 78431
diff changeset
   212
126a12483c67 support for Build_Cluster.Session.init (rsync + Admin/init);
wenzelm
parents: 78431
diff changeset
   213
option build_cluster_identifier : string = "build_cluster"
126a12483c67 support for Build_Cluster.Session.init (rsync + Admin/init);
wenzelm
parents: 78431
diff changeset
   214
  -- "ISABELLE_IDENTIFIER for remote build cluster sessions"
126a12483c67 support for Build_Cluster.Session.init (rsync + Admin/init);
wenzelm
parents: 78431
diff changeset
   215
79289
7c1faa16554b add delay and limit options for when schedule is considered outdated;
Fabian Huch <huch@in.tum.de>
parents: 79067
diff changeset
   216
option build_schedule_outdated_delay : real = 300.0
7c1faa16554b add delay and limit options for when schedule is considered outdated;
Fabian Huch <huch@in.tum.de>
parents: 79067
diff changeset
   217
  -- "delay schedule generation loop"
7c1faa16554b add delay and limit options for when schedule is considered outdated;
Fabian Huch <huch@in.tum.de>
parents: 79067
diff changeset
   218
7c1faa16554b add delay and limit options for when schedule is considered outdated;
Fabian Huch <huch@in.tum.de>
parents: 79067
diff changeset
   219
option build_schedule_outdated_limit : int = 20
7c1faa16554b add delay and limit options for when schedule is considered outdated;
Fabian Huch <huch@in.tum.de>
parents: 79067
diff changeset
   220
  -- "maximum number of sessions for which schedule stays valid"
7c1faa16554b add delay and limit options for when schedule is considered outdated;
Fabian Huch <huch@in.tum.de>
parents: 79067
diff changeset
   221
71675
55cb4271858b less redundant markup reports;
wenzelm
parents: 71651
diff changeset
   222
69520
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   223
section "Editor Session"
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   224
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   225
public option editor_load_delay : real = 0.5
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   226
  -- "delay for file load operations (new buffers etc.)"
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   227
72933
fbc1d5ff3683 afford more reactive input;
wenzelm
parents: 72892
diff changeset
   228
public option editor_input_delay : real = 0.2
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   229
  -- "delay for user input (text edits, cursor movement etc.)"
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   230
64524
e6a3c55b929b explicit option editor_generated_input_delay, which is more aggressive by default;
wenzelm
parents: 64325
diff changeset
   231
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
   232
  -- "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
   233
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   234
public option editor_output_delay : real = 0.1
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   235
  -- "delay for prover output (markup, common messages etc.)"
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   236
76474
287c3adcdcd6 afford more reactive consolidation;
wenzelm
parents: 76471
diff changeset
   237
public option editor_consolidate_delay : real = 1.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
   238
  -- "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
   239
62115
57895801cb57 prune old versions more often, to reduce overall heap requirements;
wenzelm
parents: 61873
diff changeset
   240
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
   241
  -- "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
   242
65264
7e6ecd04b5fe dynamic session_options for tuning parameters and initial prover options;
wenzelm
parents: 65141
diff changeset
   243
option editor_prune_size : int = 0
7e6ecd04b5fe dynamic session_options for tuning parameters and initial prover options;
wenzelm
parents: 65141
diff changeset
   244
  -- "retained size of pruned history (delete old versions)"
7e6ecd04b5fe dynamic session_options for tuning parameters and initial prover options;
wenzelm
parents: 65141
diff changeset
   245
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   246
public option editor_update_delay : real = 0.5
49288
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   247
  -- "delay for physical GUI updates"
2c9272cb4568 more options;
wenzelm
parents: 49270
diff changeset
   248
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   249
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
   250
  -- "maximum amount of reparsed text outside perspective"
50119
5c370a036de7 more generous tracing_limit, with explicit system option;
wenzelm
parents: 49524
diff changeset
   251
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   252
public option editor_tracing_messages : int = 1000
69103
814a1ab42d70 unbounded tracing for proper termination, e.g. relevant for theory Sequents.Hard_Quantifiers;
wenzelm
parents: 68661
diff changeset
   253
  -- "initial number of tracing messages for each command transaction (0: unbounded)"
50697
82e9178e6a98 improved Monitor_Dockable, based on ML_Statistics operations;
wenzelm
parents: 50505
diff changeset
   254
52065
78f2475aa126 explicit notion of public options, which are shown in the editor options dialog;
wenzelm
parents: 52043
diff changeset
   255
public option editor_chart_delay : real = 3.0
50697
82e9178e6a98 improved Monitor_Dockable, based on ML_Statistics operations;
wenzelm
parents: 50505
diff changeset
   256
  -- "delay for chart repainting"
52702
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   257
52807
b859a180936b simplified flag for continuous checking: avoid GUI complexity and slow checking of all theories (including prints);
wenzelm
parents: 52798
diff changeset
   258
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
   259
  -- "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
   260
61604
bb20f11dd842 prefer explicit State panel;
wenzelm
parents: 61602
diff changeset
   261
public option editor_output_state : bool = false
61213
0b1a092385c7 option editor_output_state;
wenzelm
parents: 61158
diff changeset
   262
  -- "implicit output of proof state"
0b1a092385c7 option editor_output_state;
wenzelm
parents: 61158
diff changeset
   263
76578
06b001094ddb more uniform session selectors, with persistent options;
wenzelm
parents: 76474
diff changeset
   264
public option editor_document_session : string = ""
06b001094ddb more uniform session selectors, with persistent options;
wenzelm
parents: 76474
diff changeset
   265
  -- "session for interactive document preparation"
06b001094ddb more uniform session selectors, with persistent options;
wenzelm
parents: 76474
diff changeset
   266
77149
3991a35cd740 automatically build document when selected theories are finished;
wenzelm
parents: 76986
diff changeset
   267
public option editor_document_auto : bool = false
3991a35cd740 automatically build document when selected theories are finished;
wenzelm
parents: 76986
diff changeset
   268
  -- "automatically build document when selected theories are finished"
3991a35cd740 automatically build document when selected theories are finished;
wenzelm
parents: 76986
diff changeset
   269
3991a35cd740 automatically build document when selected theories are finished;
wenzelm
parents: 76986
diff changeset
   270
public option editor_document_delay : real = 2.0
3991a35cd740 automatically build document when selected theories are finished;
wenzelm
parents: 76986
diff changeset
   271
  -- "delay for document auto build"
3991a35cd740 automatically build document when selected theories are finished;
wenzelm
parents: 76986
diff changeset
   272
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
   273
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
   274
  -- "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
   275
57974
ba0b6c2338f0 added option editor_syslog_limit;
wenzelm
parents: 57867
diff changeset
   276
option editor_syslog_limit : int = 100
ba0b6c2338f0 added option editor_syslog_limit;
wenzelm
parents: 57867
diff changeset
   277
  -- "maximum amount of buffered syslog messages"
ba0b6c2338f0 added option editor_syslog_limit;
wenzelm
parents: 57867
diff changeset
   278
52702
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   279
69520
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   280
section "Headless Session"
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   281
79067
212c94edae2b more reactive headless server, in contrast to 15656ad28691 (when "isabelle dump" was important to export AFP content);
wenzelm
parents: 78914
diff changeset
   282
option headless_consolidate_delay : real = 2.0
70787
15656ad28691 clarified options -- more scalable;
wenzelm
parents: 70778
diff changeset
   283
  -- "delay to consolidate status of command evaluation (execution forks)"
15656ad28691 clarified options -- more scalable;
wenzelm
parents: 70778
diff changeset
   284
79067
212c94edae2b more reactive headless server, in contrast to 15656ad28691 (when "isabelle dump" was important to export AFP content);
wenzelm
parents: 78914
diff changeset
   285
option headless_prune_delay : real = 30
70787
15656ad28691 clarified options -- more scalable;
wenzelm
parents: 70778
diff changeset
   286
  -- "delay to prune history (delete old versions)"
15656ad28691 clarified options -- more scalable;
wenzelm
parents: 70778
diff changeset
   287
69520
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   288
option headless_check_delay : real = 0.5
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   289
  -- "delay for theory status check during PIDE processing (seconds)"
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   290
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   291
option headless_check_limit : int = 0
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   292
  -- "maximum number of theory status checks (0 = unlimited)"
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   293
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   294
option headless_nodes_status_delay : real = -1
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   295
  -- "delay for overall nodes status check during PIDE processing (seconds, disabled for < 0)"
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   296
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   297
option headless_watchdog_timeout : real = 600
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   298
  -- "watchdog timeout for PIDE processing of broken theories (seconds, 0 = disabled)"
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   299
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   300
option headless_commit_cleanup_delay : real = 60
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   301
  -- "delay for cleanup of already imported theories (seconds, 0 = disabled)"
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   302
70801
5352449209b1 clarified option type;
wenzelm
parents: 70800
diff changeset
   303
option headless_load_limit : real = 5.0
77709
53dc388b98ec clarified signature: more explicit types;
wenzelm
parents: 77675
diff changeset
   304
  -- "limit in MiB for loaded theory files (0 = unlimited)"
70772
030a6baa5cb2 support headless_load_limit for more scalable load process;
wenzelm
parents: 70634
diff changeset
   305
69520
16779868de1f clarified defaults via system options;
wenzelm
parents: 69431
diff changeset
   306
52702
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   307
section "Miscellaneous Tools"
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   308
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   309
public option find_theorems_limit : int = 40
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   310
  -- "limit of displayed results"
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   311
56613
3518ea9f5200 tuned option name;
wenzelm
parents: 56279
diff changeset
   312
public option find_theorems_tactic_limit : int = 5
52702
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   313
  -- "limit of tactic search for 'solves' criterion"
c503730efae5 proper system options for 'find_theorems';
wenzelm
parents: 52490
diff changeset
   314
55672
5e25cc741ab9 support for completion within the formal context;
wenzelm
parents: 53189
diff changeset
   315
5e25cc741ab9 support for completion within the formal context;
wenzelm
parents: 53189
diff changeset
   316
section "Completion"
5e25cc741ab9 support for completion within the formal context;
wenzelm
parents: 53189
diff changeset
   317
5e25cc741ab9 support for completion within the formal context;
wenzelm
parents: 53189
diff changeset
   318
public option completion_limit : int = 40
5e25cc741ab9 support for completion within the formal context;
wenzelm
parents: 53189
diff changeset
   319
  -- "limit for completion within the formal context"
64130
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   320
66158
ad83d4971dfe clarified modules;
wenzelm
parents: 65782
diff changeset
   321
public option completion_path_ignore : string = "*~:*.marks:*.orig:*.rej:.DS_Store"
ad83d4971dfe clarified modules;
wenzelm
parents: 65782
diff changeset
   322
  -- "glob patterns to ignore in file-system path completion (separated by colons)"
ad83d4971dfe clarified modules;
wenzelm
parents: 65782
diff changeset
   323
64130
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   324
65141
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   325
section "Spell Checker"
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   326
77606
b0a4f8c29446 clarified exported options;
wenzelm
parents: 77603
diff changeset
   327
public option spell_checker : bool = true
65141
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   328
  -- "enable spell-checker for prose words within document text, comments etc."
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   329
77606
b0a4f8c29446 clarified exported options;
wenzelm
parents: 77603
diff changeset
   330
public option spell_checker_dictionary : string = "en"
65141
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   331
  -- "spell-checker dictionary name"
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   332
77606
b0a4f8c29446 clarified exported options;
wenzelm
parents: 77603
diff changeset
   333
public option spell_checker_include : string = "words,comment,comment1,comment2,comment3,ML_comment,SML_comment"
67395
b39d596b77ce more accurate spell-checking for nested quotations / antiquotations, notably in formal comments;
wenzelm
parents: 67273
diff changeset
   334
  -- "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
   335
77606
b0a4f8c29446 clarified exported options;
wenzelm
parents: 77603
diff changeset
   336
public option spell_checker_exclude : string = "document_marker,antiquoted,raw_text"
67395
b39d596b77ce more accurate spell-checking for nested quotations / antiquotations, notably in formal comments;
wenzelm
parents: 67273
diff changeset
   337
  -- "excluded markup elements for spell-checker (separated by commas)"
65141
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   338
c706b57b1694 clarified modules;
wenzelm
parents: 65056
diff changeset
   339
76190
c72c5407a86f show SSH options in PIDE GUI;
wenzelm
parents: 76168
diff changeset
   340
section "Secure Shell (OpenSSH)"
64130
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   341
76190
c72c5407a86f show SSH options in PIDE GUI;
wenzelm
parents: 76168
diff changeset
   342
public option ssh_batch_mode : bool = true
76168
aab9bb081f01 clarified options;
wenzelm
parents: 76167
diff changeset
   343
  -- "enable SSH batch mode (no user interaction)"
aab9bb081f01 clarified options;
wenzelm
parents: 76167
diff changeset
   344
76190
c72c5407a86f show SSH options in PIDE GUI;
wenzelm
parents: 76168
diff changeset
   345
public option ssh_multiplexing : bool = true
76148
769ebb139a32 support port forwarding without multiplexing (for the sake of Windows);
wenzelm
parents: 76126
diff changeset
   346
  -- "enable multiplexing of SSH sessions (ignored on Windows)"
769ebb139a32 support port forwarding without multiplexing (for the sake of Windows);
wenzelm
parents: 76126
diff changeset
   347
76190
c72c5407a86f show SSH options in PIDE GUI;
wenzelm
parents: 76168
diff changeset
   348
public option ssh_compression : bool = true
64130
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   349
  -- "enable SSH compression"
e17c211a0bb6 clarified treatment of options;
wenzelm
parents: 63986
diff changeset
   350
76190
c72c5407a86f show SSH options in PIDE GUI;
wenzelm
parents: 76168
diff changeset
   351
public option ssh_alive_interval : real = 30
76167
e517a38dc0e6 clarified options;
wenzelm
parents: 76166
diff changeset
   352
  -- "time interval to keep SSH server connection alive (seconds, ignore value < 0)"
65595
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   353
76190
c72c5407a86f show SSH options in PIDE GUI;
wenzelm
parents: 76168
diff changeset
   354
public option ssh_alive_count_max : int = 3
76167
e517a38dc0e6 clarified options;
wenzelm
parents: 76166
diff changeset
   355
  -- "maximum number of messages to keep SSH server connection alive (ignore value < 0)"
67273
c573cfb2c407 more robust connection: prefer ServerAliveCountMax=3 (ssh default) instead of 1 (jsch default);
wenzelm
parents: 67194
diff changeset
   356
65595
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   357
71422
5d5be87330b5 allow to override repository versions at runtime;
wenzelm
parents: 71068
diff changeset
   358
section "Phabricator"
5d5be87330b5 allow to override repository versions at runtime;
wenzelm
parents: 71068
diff changeset
   359
79487
47272fac86d8 support Phabricator on Ubuntu 22.04 LTS with PHP 8.1, using community form we.phorge.it version "2023 week 49";
wenzelm
parents: 79483
diff changeset
   360
option phabricator_version_arcanist : string = "e46025f7a9146f9918bab9d6fbdf6ed1816db5b5"
71422
5d5be87330b5 allow to override repository versions at runtime;
wenzelm
parents: 71068
diff changeset
   361
  -- "repository version for arcanist"
5d5be87330b5 allow to override repository versions at runtime;
wenzelm
parents: 71068
diff changeset
   362
79487
47272fac86d8 support Phabricator on Ubuntu 22.04 LTS with PHP 8.1, using community form we.phorge.it version "2023 week 49";
wenzelm
parents: 79483
diff changeset
   363
option phabricator_version_phabricator : string = "2ba2cbaf9bbf8f88e910d3da0a3cd643e4879e8a"
71422
5d5be87330b5 allow to override repository versions at runtime;
wenzelm
parents: 71068
diff changeset
   364
  -- "repository version for phabricator"
5d5be87330b5 allow to override repository versions at runtime;
wenzelm
parents: 71068
diff changeset
   365
5d5be87330b5 allow to override repository versions at runtime;
wenzelm
parents: 71068
diff changeset
   366
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   367
section "Theory Export"
68154
42d63ea39161 some export of foundational theory content;
wenzelm
parents: 68130
diff changeset
   368
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   369
option export_theory : bool = false for content
70396
425c5f9bc61a support export_proofs, prune_proofs;
wenzelm
parents: 70229
diff changeset
   370
  -- "export theory content to Isabelle/Scala"
425c5f9bc61a support export_proofs, prune_proofs;
wenzelm
parents: 70229
diff changeset
   371
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   372
option export_standard_proofs : bool = false for content
70914
05c4c6a99b3f option to export standardized proof terms (not scalable);
wenzelm
parents: 70801
diff changeset
   373
  -- "export standardized proof terms to Isabelle/Scala (not scalable)"
05c4c6a99b3f option to export standardized proof terms (not scalable);
wenzelm
parents: 70801
diff changeset
   374
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   375
option export_proofs : bool = false for content
70396
425c5f9bc61a support export_proofs, prune_proofs;
wenzelm
parents: 70229
diff changeset
   376
  -- "export proof terms to Isabelle/Scala"
425c5f9bc61a support export_proofs, prune_proofs;
wenzelm
parents: 70229
diff changeset
   377
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   378
option prune_proofs : bool = false for content
70396
425c5f9bc61a support export_proofs, prune_proofs;
wenzelm
parents: 70229
diff changeset
   379
  -- "prune proof terms after export (do not store in Isabelle/ML)"
68154
42d63ea39161 some export of foundational theory content;
wenzelm
parents: 68130
diff changeset
   380
42d63ea39161 some export of foundational theory content;
wenzelm
parents: 68130
diff changeset
   381
69586
9171d1ce5a35 support for "isabelle update -u mixfix_cartouches";
wenzelm
parents: 69572
diff changeset
   382
section "Theory update"
9171d1ce5a35 support for "isabelle update -u mixfix_cartouches";
wenzelm
parents: 69572
diff changeset
   383
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   384
option update_inner_syntax_cartouches : bool = false for content update
69589
e15f053a42d8 support for isabelle update -u inner_syntax_cartouches;
wenzelm
parents: 69586
diff changeset
   385
  -- "update inner syntax (types, terms, etc.) to use cartouches"
e15f053a42d8 support for isabelle update -u inner_syntax_cartouches;
wenzelm
parents: 69586
diff changeset
   386
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   387
option update_mixfix_cartouches : bool = false for content update
69586
9171d1ce5a35 support for "isabelle update -u mixfix_cartouches";
wenzelm
parents: 69572
diff changeset
   388
  -- "update mixfix templates to use cartouches instead of double quotes"
9171d1ce5a35 support for "isabelle update -u mixfix_cartouches";
wenzelm
parents: 69572
diff changeset
   389
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   390
option update_control_cartouches : bool = false for content update
69592
a80d8ec6c998 support for isabelle update -u control_cartouches;
wenzelm
parents: 69589
diff changeset
   391
  -- "update antiquotations to use control symbol with cartouche argument"
a80d8ec6c998 support for isabelle update -u control_cartouches;
wenzelm
parents: 69589
diff changeset
   392
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   393
option update_path_cartouches : bool = false for content update
69603
67ae2e164c0f support for isabelle update -u path_cartouches;
wenzelm
parents: 69592
diff changeset
   394
  -- "update file-system paths to use cartouches"
67ae2e164c0f support for isabelle update -u path_cartouches;
wenzelm
parents: 69592
diff changeset
   395
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   396
option update_cite : bool = false for content update
76972
6c542f2aab85 basic support for update_cite_commands;
wenzelm
parents: 76578
diff changeset
   397
  -- "update cite commands and antiquotations"
6c542f2aab85 basic support for update_cite_commands;
wenzelm
parents: 76578
diff changeset
   398
69586
9171d1ce5a35 support for "isabelle update -u mixfix_cartouches";
wenzelm
parents: 69572
diff changeset
   399
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   400
section "Build Database"
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   401
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   402
option build_database_server : bool = false for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   403
option build_database_user : string = "" for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   404
option build_database_password : string = "" for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   405
option build_database_name : string = "" for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   406
option build_database_host : string = "" for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   407
option build_database_port : int = 0 for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   408
option build_database_ssh_host : string = "" for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   409
option build_database_ssh_user : string = "" for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   410
option build_database_ssh_port : int = 0 for connection
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   411
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68197
diff changeset
   412
65595
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   413
section "Build Log Database"
ffd8283b7be0 support for database connection;
wenzelm
parents: 65456
diff changeset
   414
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   415
option build_log_database_user : string = "" for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   416
option build_log_database_password : string = "" for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   417
option build_log_database_name : string = "" for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   418
option build_log_database_host : string = "" for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   419
option build_log_database_port : int = 0 for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   420
option build_log_ssh_host : string = "" for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   421
option build_log_ssh_user : string = "" for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   422
option build_log_ssh_port : int = 0 for connection
65782
4935bac8a850 simplified default;
wenzelm
parents: 65595
diff changeset
   423
option build_log_history : int = 30  -- "length of relevant history (in days)"
69572
09a6a7c04b45 more robust system channel via options that are private to the user;
wenzelm
parents: 69520
diff changeset
   424
09a6a7c04b45 more robust system channel via options that are private to the user;
wenzelm
parents: 69520
diff changeset
   425
09a6a7c04b45 more robust system channel via options that are private to the user;
wenzelm
parents: 69520
diff changeset
   426
section "Isabelle/Scala/ML system channel"
09a6a7c04b45 more robust system channel via options that are private to the user;
wenzelm
parents: 69520
diff changeset
   427
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   428
option system_channel_address : string = "" for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   429
option system_channel_password : string = "" for connection
74147
d030b988d470 provide bash_process server for Isabelle/ML and other external programs;
wenzelm
parents: 74138
diff changeset
   430
d030b988d470 provide bash_process server for Isabelle/ML and other external programs;
wenzelm
parents: 74138
diff changeset
   431
d030b988d470 provide bash_process server for Isabelle/ML and other external programs;
wenzelm
parents: 74138
diff changeset
   432
section "Bash process execution server"
d030b988d470 provide bash_process server for Isabelle/ML and other external programs;
wenzelm
parents: 74138
diff changeset
   433
77603
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   434
option bash_process_debugging : bool = false for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   435
option bash_process_address : string = "" for connection
236e43c8bb5b support option tags;
wenzelm
parents: 77483
diff changeset
   436
option bash_process_password : string = "" for connection
78821
4c5aadf1cb48 prefer Isabelle options for CI mail settings over ci.properties;
Fabian Huch <huch@in.tum.de>
parents: 78511
diff changeset
   437
4c5aadf1cb48 prefer Isabelle options for CI mail settings over ci.properties;
Fabian Huch <huch@in.tum.de>
parents: 78511
diff changeset
   438
4c5aadf1cb48 prefer Isabelle options for CI mail settings over ci.properties;
Fabian Huch <huch@in.tum.de>
parents: 78511
diff changeset
   439
section "Continuous integration"
4c5aadf1cb48 prefer Isabelle options for CI mail settings over ci.properties;
Fabian Huch <huch@in.tum.de>
parents: 78511
diff changeset
   440
4c5aadf1cb48 prefer Isabelle options for CI mail settings over ci.properties;
Fabian Huch <huch@in.tum.de>
parents: 78511
diff changeset
   441
option ci_mail_user : string = "" for connection
4c5aadf1cb48 prefer Isabelle options for CI mail settings over ci.properties;
Fabian Huch <huch@in.tum.de>
parents: 78511
diff changeset
   442
option ci_mail_password : string = "" for connection
4c5aadf1cb48 prefer Isabelle options for CI mail settings over ci.properties;
Fabian Huch <huch@in.tum.de>
parents: 78511
diff changeset
   443
option ci_mail_sender : string = "" for connection
4c5aadf1cb48 prefer Isabelle options for CI mail settings over ci.properties;
Fabian Huch <huch@in.tum.de>
parents: 78511
diff changeset
   444
option ci_mail_smtp_host : string = "" for connection
4c5aadf1cb48 prefer Isabelle options for CI mail settings over ci.properties;
Fabian Huch <huch@in.tum.de>
parents: 78511
diff changeset
   445
option ci_mail_smtp_port : int = 587 for connection