expand_subst needs to be documented

In particular, it would have been nice to know that it likes to delete unused substitution rules, without regard for context.