Ubuntu Manpage: theme-d-link - the Theme-D linker

Provided by: theme-d-translator_4.2.0-1_amd64

NAME

       theme-d-link - the Theme-D linker

SYNOPSIS

       theme-d-link [ OPTION ] ...  FILE

DESCRIPTION

       Link  the  Theme-D  pseudocode  file  FILE and Theme-D libraries it uses into Guile bytecode. The default
       bytecode filename is obtained by appending .go to the basename of FILE.  Command theme-d-link creates  an
       intermediate  file  either  in  Guile  Tree-IL  or Scheme and uses Guile to compile it into bytecode. The
       default suffix of the intermediate file is either .tree-il or .scm.

       By default, the output file and the intermediate file are placed into the  directory  where  the  command
       theme-d-link is invoked.

OPTIONS

-o, --output=OUTPUTFILE
Specify the compilation output file.

-m, --module-path=PATH
Specify the search path for Theme-D modules. The path should be a list of directories separated
with :'s. You can prefix the list with a colon in order to include the default Theme-D library
path in the search path.

-l, --message-level=LEVEL
Specify the message level of the compiler. The level has to be an integer number from 0 to 3.
Value 0 means no output and value 3 the most verbose output.

-n, --intermediate-file=INTFILE
Specify the intermediate filename.

-i, --intermediate-language=LANGUAGE
Specify the intermediate language. Value LANGUAGE has to be either tree-il, tree-il-3.0, tree-
il-2.2, tree-il-2.0, scheme, scheme-no-opt, or racket. When value tree-il is used the Tree-IL
version for which Theme-D has been configured is used. Choosing intermediate language racket
implies options --keep-intermediate and --no-final-compilation.

-x MODULE
Link (load) module MODULE into the target program. The syntax of MODULE depends on the
intermediate language. The syntax is sym1/.../symn for Racket and (sym1...symn) in double quotes
for other intermediate languages (Guile).

-y MODULE
Link (load) module MODULE into the target program. A relative path is used for the module. See
Racket documentation. This option is available only for intermediate language racket.

--no-final-compilation
Do not compile the intermediate file with guild compile.

--no-strip
Do not strip away unused code.

--no-factorization
Do not factorize the type expressions out of procedure implementations.

--no-weak-assertions
Do not check ordinary assertions. Strong assertions are always checked.

--backtrace
Print backtrace on compilation error.

--pretty-print
Pretty print the pseudocode output.

--no-verbose-errors
Less information in the error messages.

--keep-intermediate
Keep the intermediate Tree-IL or Scheme file. By default the intermediate file is deleted.

--link-to-cache
Link the target bytecode file into the guile cache.

--runtime-pretty-backtrace
Generate code to support runtime pretty printed backtraces.

--no-unlinked-procedure-names
Do not generate code for reporting unlinked procedure names.

TARGET PLATFORMS

       Theme-D programs can be built for Guile or Racket. The following intermediate languages are available:

       tree-il
              Guile Tree-IL. Use the Guile version from Theme-D configuration.

       tree-il-3.0
              Guile 3.0 Tree-IL. This is currently identical to Guile 2.2 Tree-IL.

       tree-il-2.2
              Guile 2.2 Tree-IL.

       tree-il-2.0
              Guile 2.0 Tree-IL.

       scheme Guile Scheme.

       scheme-no-opt
              Guile Scheme without optimizations.

       racket Racket Scheme.

ENVIRONMENT

       THEME_D_CONFIG_FILE
              If this variable is defined its value is used as the Theme-D configuration  file  instead  of  the
              default configuration file.

FILES

       /etc/theme-d-config
              The Theme-D configuration file.

       ~/.theme-d-config
              The  Theme-D  configuration  file. This file should be normally present only if you use Theme-D in
              local mode.