Artifact b80bd061aa20bdfd1dfb67b0576f7386cb11aa2b:

• File doc/parts/build-dev.inc — part of check-in [172951e9a3] at 2013-11-26 00:32:32 on branch trunk — Continued documentation work, first fillings for the dev-guide, more figures. (user: andreask size: 1204)

Our build-system is based on [syscmd kettle], as already explained in
the [term [vset TITLE_INSTALL]]. Beyond the targets useful for
installation it also provides targets aiding developers and
maintainers. These are:

[list_begin definitions]

[def {Validation of the documentation}]

[example_begin]
% /path/to/[vset PROJECT]/build.tcl validate-doc
[example_end]


[def {Regeneration of the embedded documentation}]

[example_begin]
% /path/to/[vset PROJECT]/build.tcl doc
[example_end]

[def {Regeneration of the figures for the documentation}]

[example_begin]
% /path/to/[vset PROJECT]/build.tcl figures
[example_end]


[def {Execution of the test-suite}]

The most basic execution of the test-suite is done with

[example_begin]
% /path/to/[vset PROJECT]/build.tcl test
[example_end]

[para] When the test-suite reports issues with the framework use of
the more extended form below is indicated, with a [const <stem>] of
your choice. This will generate a number of files whose name starts
with the prefix [file <stem>.]. These will contain extended test logs,
details about errors and failures, etc.

[example_begin]
% /path/to/[vset PROJECT]/build.tcl test --log <stem>
[example_end]


[list_end]