Document using -S to split arguments to /usr/bin/env

[jceb]

just 1.25.2

I noticed that just doesn't split arguments properly in tasks with a shebang. Given the following Justfile:

run:
    #!/usr/bin/env bash -x
    ls -l
    echo "hello"

I'd expect that just run will print and execute the commands.

However, what I get is the following error:

↳ just run
/usr/bin/env: ‘bash -x’: No such file or directory
/usr/bin/env: use -[v]S to pass options in shebang lines
error: Recipe `run` failed with exit code 127

Apparently, only the first space is used to split the command from its arguments. Additional spaces aren't recognized.

[casey]

Which OS are you using? Shebang argument splitting on unix is handled by the OS, so the specific behavior is OS-specific. You might need to add the -S flag, like so:

run:
    #!/usr/bin/env -S bash -x
    ls -l
    echo "hello"

This should probably be documented in the readme.

[jceb]

Ah, thank you! That's a valuable hint!