This expands the previous langkit.envs module docstring, which was ultra-minimal. Yet this new doc is still not exhaustive: there are corner cases to document and more extensive examples to clarify things. TN: T918-007