[added to documentation sydow@chalmers.se**20080411151818] { hunk ./summary/menu.html 3 - + hunk ./summary/menu.html 21 +
+This page describes briefly the command line options to timberc, the Timber compiler. +Installation is not described. +
+timberc expects a number of options and a number of files to compile. The most +common uses are the following: +
The given files are compiled (first to C by the timber + compiler, then to object files by the C compiler). No linking takes place. This usage requires that all + files on which the given modules depend have already been compiled. This is the typical way to compile + new modules during the development of a Timber system. Can be modified to option -C to avoid + C compilation. +
The compiler expects Mod.t to be the root module of a system for the default environment (i.e. POSIX). + All modules in the programs are compiled by timberc and gcc as needed and in dependency + order, followed by linking. The executable is called Mod. This option obviates the need of a makefile + to rebuild the system after changes in any modules. Can be combined with --root=name when the name of + the root definition is name (rather than the default root). +
Displays the API of module Mod, i.e. all exported kinds, types, defaults and top-level values with their types, + typically in a browser window (installation-dependent). +
+ }