tbx_make

Arguments

tbx_path

a single string: absolute or relative path to the toolbox root directory.

Default path is the current working directory.

sections

vector of strings: Names of the toolbox sections to build, among ["macros", "help", "src", "sci_gateway", "localization"]. "*" can be used to force building all available sections, without running the builder script when it exists (see the description section).

languages

Obsolete: will be removed in Scilab 2027.1.0. The images of the help pages are generated for all languages at once at build time, or on the fly when missing. During the development of the toolbox, rebuilding the help is not needed to check a modified page: the help browser renders it again, and its images with it, as soon as it is reloaded, by clicking on its entry in the table of contents.

Vector of strings like "en_US", specifying the subset of the languages for which help pages must be built. The shortcuts "en", "fr", "pt", "ja", "ru" are automatically expanded respectively into "en_US", "fr_FR", "pt_BR", "ja_JP", "ru_RU". If there is no help section or if its build is not requested, this option is ignored.

Description

tbx_make(…) allows to build partly or completely an external toolbox. Partial builds are very useful during the module's development. This allows focusing on each toolbox section, to tune and work out about each of them, without each time recompiling the whole toolbox.

The technical name (id) tbx_name of the toolbox is the basename of the ~/etc/*.start file, where ~ is the toolbox root. This file is mandatory in the toolbox, even if it is empty.

tbx_make() is equivalent to tbx_make(".") ou tbx_make ..

tbx_make(tbx_path) builds the toolbox whose root's directory is tbx_path. tbx_path is scanned for a script named like build*.sce:

• If such a file is found, tbx_make(…) executes it, and then returns. An example of such a builder.sce script is provided in the template module available in SCI/contrib/toolbox_skeleton.

• Otherwise, the sections parameter is set by default to all existing toolbox sections. These ones are then built one by one, as described below.

tbx_make(tbx_path, sections) builds one by one all given sections of the toolbox, provided that they exist. The sections are processed according to the following conventions:

1. macros :

   • If there is a custom macros builder script ~/macros/*.sce, it is executed, and then returns to tbx_make(…) to go on building the remaining sections. Writing and using such a builder script is mandatory if macros are sorted in ~/macros/* subdirectories corresponding to some toolbox sublibraries.

   • Otherwise: All macros files ~/macros/*.sci are compiled and gathered into a library named tbx_namelib and recorded in the file ~/macros/lib. Please see tbx_builder_macros.

     No automatical recursive processing aiming to build sublibraries in subdirectories is performed.

2. help : Help pages are generated from XML source files stored in ~/help/* available languages subdirectories (en_US, fr_FR, etc).

   • If ~/help/builder.sce* is found and the languages option is not used, the builder is executed, and then returns to tbx_make(…).

   • Otherwise: the images of the help pages are generated with the default builder into ~/help/images, for all languages at once.

   Help pages may contain Scilab code samples using functions defined in the toolbox, and executed when building pages (<scilab:image> tags, Xcos diagrams). When it is the case, the related functions must have been compiled before building the help pages.

3. localization : Localization files are built and/or postprocessed. Please see tbx_build_localization.

4. src : Functional external code in src is compiled. Please see tbx_builder_src.

5. sci_gateway : gateway functions in sci_gateway are compiled. Please see tbx_builder_gateway.

Finally, tbx_make(…) always creates the script files loader.sce, unloader.sce and cleaner.sce at the toolbox's root.

Examples

// The working directory is set at the toolbox root:
tbx_make()          // builds the toolbox with the toolbox builder (if any),
                    //  or for all sections with default builders otherwise.
tbx_make .  macros  // builds only its macros section from files in ./macros/
tbx_make .  *       // builds all available sections, without using the toolbox builder

// 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"])

See Also

• man — on line help XML file description format
• tbx_build_help — Pre-generates the images of the help pages of a toolbox (toolbox compilation process)
• tbx_builder_help — Builds the multilingual help of a toolbox: pre-generates the images of its pages
• genlib — builds a library from a set of *.sci files defining functions in a given directory
• tbx_builder_macros — Creates the library(es) of a toolbox for its functions in Scilab language
• tbx_build_localization — Builds or updates localization .po and .mo files of a toolbox
• tbx_builder_src — Builds the user source code (non-gateway) in src/ subdirectory.
• tbx_builder_gateway — Builds the user gateway code in sci_gateway/ subdirectory.
• tbx_build_blocks — Compile Xcos blocks (toolbox compilation process)

History