reference/promise-types/files.markdown: explain %variable and $variable syntax

See https://github.com/cfengine/core/pull/2031 for details.