<< tbx_builder_gateway Sections builders tbx_builder_macros >>

Scilab Help >> Modules manager > Sections builders > tbx_builder_help

tbx_builder_help

Builds the multilingual help pages of a toolbox, with possible subsections

Syntax

tbx_builder_help(toolbox_path)
tbx_builder_help(toolbox_path, languages)

Arguments

toolbox_path
Root directory of toolbox sources ; builder_help.sce script will be searched in the help subdirectory of this directory.

languages
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" can be used. They are automatically expanded into "en_US", "fr_FR", "pt_BR", "ja_JP", "ru_RU".

Description

tbx_builder_help is used for generating the help of a toolbox.

This macro is usually called from builder.sce scripts when creating a toolbox.

It scans the toolbox_path directory for a help subdirectory. If ~/help is found, tbx_builder_help(…) looks for a script whose name starts by builder.

If the ~/help directory is missing, tbx_builder_help(…) exits silently.

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

Examples

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

See also

History

VersionDescription
6.0.0

No longer restricts the build scripts to builder_help.sce. Now any scripts called builder*.sce or builder*.sce is valid for help generation.

No longer requires a builder script, the default behaviour generates the help from all la_LA subdirectory inside the help directory.

6.1.2 languages input option added.

Report an issue
<< tbx_builder_gateway Sections builders tbx_builder_macros >>