* https://github.com/saltstack-formulas/nginx-formula/pull/247#issuecomment-514262549
- The main issue is that the `nginx-formula` has dynamic values being
used as the default `source_files` -- there is no way to provide
this from the pillar/config in a sensible fashion
- Prepending to this default (rather than overriding it) resolves this
problem entirely, without adding excessive entries to the `source`
* Closes#151
BREAKING CHANGE: every formula writer will need to change the import
to use this new version.
* template/libtofs.jinja: provides the “files_switch” macro.
* docs/TOFS_pattern.rst: update documentation to use the new path.
* template/config/clean.sls: change import from “macros.jinja” to “libtofs.jinja”.
* template/config/file.sls: ditoo.
We can hide the call to “salt['config.get']” in the macro by only
asking for a “lookup key” where to lookup the list of “source_files”.
* docs/TOFS_pattern.rst (Example): document the use of the new
optional “lookup” parameter.
* template/macros.jinja: add a new optional “lookup” parameter.
Lookup “files override” under the
“<tplroot>:tofs:sources_files:<lookup key>” and fallback to
“source_files” parameter.
* template/config/file.sls (template-config-file-file-managed): use
the new “lookup” parameter.
* Include:
- Fix link texts
- Apply text formatting
- Split some of the long lines (improved diffs)
- Remove extra `\ ` appearing after conversion from Markdown
- Improve ordered (numbered) nested lists
- Use 3-character indents under RST directives
- Use Jinja commenting in Jinja examples (not just `#`)
