Builds a toolbox having a standard structure (EXPERIMENTAL)
tbx_make() tbx_make(tbx_path) tbx_make(tbx_path, sections)
a single string; path to the toolbox root directory.
Default path is the current working directory.
a matrix of string; list of the toolbox sections to be buit, amongst
["macros", "help", "src", "sci_gateway", "localization"].
Default or [] will select all possible sections.
The short name (id) tbx_name of the toolbox is retrieved as the basename of the
etc/*.start file. This file is mandatory, even if it is empty.
tbx_make builds the toolbox pointed to by its root directory
tbx_path, by executing an explicit or default builder script.
tbx_path is scanned for a script named like build*.sce.
If such a file is found and no specific sections are requested to
build, tbx_make executes the available builder script, and that's it.
Otherwise, tbx_make builds the toolbox using directory naming
conventions. The sections of the toolbox are processed according to the following conventions:
macros/ |
All macros files *.sci available in the ~/macros/*
directory are compiled and gathered into a library named tbx_namelib
(see tbx_builder_macros) |
|---|---|
src/ |
Functional external code in src is compiled. (see tbx_builder_src) |
sci_gateway/ |
gateway functions in sci_gateway are compiled. (see tbx_builder_gateway) |
help/ |
help is generated (see tbx_builder_help) |
localization |
Localization files are processed (see tbx_build_localization) |
This default behaviour mimics the builder.sce script from the toolbox_skeleton
provided with Scilab.
Only the selected sections are built.
loader.sce, unloader.sce and cleaner.sce
scripts are always created at the toolbox's root.
// Builds the toolbox mytoolbox at current location tbx_make() // build the toolbox in the current working directory tbx_make(".", "macros") build the macros in "./macros/" from the current directory. // Builds the toolbox located in path/to/mytoolbox directory tbx_make("path/to/mytoolbox") // Compiles macros help and src for the toolbox located in path/to/mytoolbox tbx_make("path/to/mytoolbox", ["macros", "help", "src"])
| Versão | Descrição |
| 6.0.0 | tbx_make() introduced. |
| 6.0.1 | The existing builder is run only if no specific sections are requested. |