tbx_builder_macros

Arguments

toolbox_path

Root directory of the toolbox. build script will be searched in the toolbox_path/macros subdirectory.

Description

This function is usually called by tbx_make(..) or called from builder.sce scripts, when creating or updating a toolbox.

The short name (id) tbx_name of the toolbox is retrieved as the basename of the file toolbox_path/etc/*.start. This file must exists, even if it is empty.

tbx_builder_macros scans the toolbox_path directory for a macros subdirectory.

• If macros is found, tbx_builder_macros looks for a script *.sce whose name starts with build:
  • If a toolbox/macros/build*.sce file is found, tbx_builder_macros executes it, and that's it.
  • Otherwise, tbx_builder_macros compiles each thisfile.sci file found in the toolbox_path/macros/ subdirectory, and yields every related thisfile.bin binary files. All these *.bin are then bundled into a library of macros recorded in the file toolbox_path/macros/lib.
• Otherwise, tbx_builder_macros exits silently.

When a library is actually built, its default name is set to tbx_namelib, in the toolbox_path/macros/lib file.

Examples

// Recommended usage, from a builder.sce script
tbx_builder_macros(get_absolute_file_path('builder.sce'))

See Also

• genlib — builds a library from a set of *.sci files defining functions in a given directory
• tbx_make — Builds fully or some given sections of a toolbox having a standard structure

History