diff options
| author | Klaus Aehlig <klaus.aehlig@huawei.com> | 2024-08-01 17:40:40 +0200 |
|---|---|---|
| committer | Klaus Aehlig <klaus.aehlig@huawei.com> | 2024-08-02 10:48:03 +0200 |
| commit | cc3d0aa8227acace9a89ae4c5dfa3148c0227655 (patch) | |
| tree | ef555d043bd859c11382554e465ce66c319c7ca4 /doc/concepts | |
| parent | 03f948f4b10e916052a2234448b6658b80ee9143 (diff) | |
| download | justbuild-cc3d0aa8227acace9a89ae4c5dfa3148c0227655.tar.gz | |
rules: make ACTION expression support "cwd"
Diffstat (limited to 'doc/concepts')
| -rw-r--r-- | doc/concepts/rules.md | 9 |
1 files changed, 8 insertions, 1 deletions
diff --git a/doc/concepts/rules.md b/doc/concepts/rules.md index ba901dca..a9db5705 100644 --- a/doc/concepts/rules.md +++ b/doc/concepts/rules.md @@ -178,12 +178,19 @@ following arguments. non-empty list of strings. The 0'th element of that list will also be the program to be executed. + - `"cwd"` The directory inside the action root to change to before + executing the command. The directory has to be given as a string + decribing a non-upwards relative path. This field is optional + and defaults to `""`. + - `"env"` The environment in which the command should be executed, given as a map of strings to strings. - `"outs"` and `"out_dirs"` Two list of strings naming the files and directories, respectively, the command is expected to - create. It is an error if the command fails to create the + create. Those paths are interpreted relative to the action root + (not relative to `"cwd"`). + It is an error if the command fails to create the promised output files. These two lists have to be disjoint, but an entry of `"outs"` may well name a location inside one of the `"out_dirs"`. |