1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79
|
The following command manages global settings, i.e. configuration options which
are independent of any [vset critcl_script].
[para] This command should not be needed to write a [vset critcl_script]. It is
a management command which is only useful to the [manpage {CriTcl Application}]
or similar tools.
[list_begin definitions]
[call [cmd ::critcl::config] [arg option] [opt [arg val]]]
Sets and returns the following global configuration options:
[list_begin options]
[opt_def force bool]
When [const false] (the default), the C files are not built if there is a
cached shared library.
[opt_def lines bool]
When [const true] (the default), #line directives are embedded into the
generated C code.
[include rq_cline.inc]
[para] Developers of higher-level packages generating their own C
code, either directly or indirectly through critcl, should
also read section [sectref {Advanced: Location management}] to see how
critcl helps them in generating their directives.
Examples of such packages come with critcl itself. See
[package critcl::iassoc] and [package critcl::class].
[opt_def trace bool]
When [const false] (the default), no code tracing the entry and exit of
CriTcl-backed commands in the [vset critcl_script] is inserted. Insertion of
such code implicitly activates the tracing facility in general. See
[package critcl::cutil].
[opt_def I path]
A single global include path to use for all files. Not set by default.
[opt_def combine enum]
[list_begin definitions]
[def "[const dynamic] (the default)"]
Object files have the suffix [const _pic].
[def [const static]]
Object files have the suffix [const _stub].
[def [const standalone]]
Object files have no suffix, and the generated C files are compiled
without using Tcl/Tk stubs. The result are object files usable for
static linking into a [term {big shell}].
[list_end]
[opt_def language string]
[opt_def keepsrc bool]
When [const false] (the default), the generated [file .c]
files are deleted after the [file .o] files have been built.
[opt_def outdir directory]
The directory where to place a generated shared library. By default, it is
placed into the [sectref {Result Cache}].
[list_end]
[list_end]
|