Alternative extensionsยถ

Deprecated since version 2.0: The .releng extension is no longer recommended and will be removed in a future release.

Deprecated since version 2.2: Extensionless configurations/scripts are no longer recommended and may be removed in a future release.

Changed in version 2.2: Extension priority orders have changed (<2.2: (none), .rt, .releng, .py; >=2.2: .rt, .py, (none), .releng).

A default configuration file is typically a file named releng-tool.rt at the root of a project. Consider the following example of a project with a libfoo package with various stage scripts:

โ””โ”€โ”€ my-project/
    โ”œโ”€โ”€ package/
    โ”‚   โ””โ”€โ”€ libfoo/
    โ”‚       โ”œโ”€โ”€ libfoo.rt
    โ”‚       โ”œโ”€โ”€ libfoo-build.rt
    โ”‚       โ””โ”€โ”€ libfoo-install.rt
    โ””โ”€โ”€ releng-tool.rt

Developers who do not prefer the .rt extension may use the .py extension. For example, the above example is equivalent to the structure:

โ””โ”€โ”€ my-project/
    โ”œโ”€โ”€ package/
    โ”‚   โ””โ”€โ”€ libfoo/
    โ”‚       โ”œโ”€โ”€ libfoo.py
    โ”‚       โ”œโ”€โ”€ libfoo-build.py
    โ”‚       โ””โ”€โ”€ libfoo-install.py
    โ””โ”€โ”€ releng-tool.py

For a specific file to be loaded, releng-tool uses the following priority:

  1. File with a .rt extension

  2. File with a .py extension

  3. File without an extension (deprecated)

  4. File with a .releng extension (deprecated)

Only the first detected file will be loaded. For example, if a project has multiple releng-tool configuration files with different extensions:

โ””โ”€โ”€ my-project/
    โ”œโ”€โ”€ package/
    โ”‚   โ””โ”€โ”€ libfoo/
    โ”‚       โ””โ”€โ”€ ...
    โ”œโ”€โ”€ releng-tool.rt
    โ””โ”€โ”€ releng-tool.py

Only the releng-tool.rt configuration script will be used.