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:
File with a
.rt
extensionFile with a
.py
extensionFile without an extension (deprecated)
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.