document new shell substitution