While at it, kill the `workdir` field that is neither used nor exposed,
and wrongfully based on the misleading ${pwd}. The overall documentation
also got a refresh, not just the new macros.