diff options
| author | John MacFarlane <jgm@berkeley.edu> | 2019-11-13 16:51:02 -0800 |
|---|---|---|
| committer | John MacFarlane <jgm@berkeley.edu> | 2019-11-13 16:51:02 -0800 |
| commit | ec043e0d97fdc864044f7c9e7efaa1b4c733bafb (patch) | |
| tree | 5a6b576328bbd27c0d8bd1fa3b65f1b51eaf134e /MANUAL.txt | |
| parent | 28a1f50111fdb5871fe3267982e4ea79a24bbe5f (diff) | |
| download | pandoc-ec043e0d97fdc864044f7c9e7efaa1b4c733bafb.tar.gz | |
Default files: combine with prior values when appropriate.
Certain command-line arguments can be repeated:
`--metadata-file`, `--css`, `--include-in-header`,
`--include-before-body`, `--include-after-body`, `--variable`,
`--metadata`, `--syntax-definition`. In these cases, values
specified in default files should be added to the list rather
than replacing values specified earlier on the command line
(perhaps in other default files).
So, for example, if one does
pandoc --variable foo=3 --defaults d1 --defaults d2
and `d1` sets the variable `bar` and `d2` sets `baz`,
all three variables will be set.
Closes #5894.
Diffstat (limited to 'MANUAL.txt')
| -rw-r--r-- | MANUAL.txt | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/MANUAL.txt b/MANUAL.txt index b20344ab0..ef737c452 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -1591,6 +1591,15 @@ of the user data directory, and then invoke these defaults from any directory using `pandoc --defaults letter` or `pandoc -dletter`. +When multiple defaults are used, their contents will be combined. + +Note that, where command-line arguments may be repeated +(`--metadata-file`, `--css`, `--include-in-header`, +`--include-before-body`, `--include-after-body`, `--variable`, +`--metadata`, `--syntax-definition`), the values specified on +the command line will combine with values specified in the +defaults file, rather than replacing them. + # Templates When the `-s/--standalone` option is used, pandoc uses a template to |