@@ -1,23 +1,17 @@
11pandoc (1.17)
22
33 * Added `--file-scope` option (Jesse Rosenthal).
4− Traditionally pandoc operates on multiple files by first concatenating
4+ By default pandoc operates on multiple files by first concatenating
55 them (around extra line breaks) and then processing the joined file. So
66 it only parses a multi-file document at the document scope. This has the
7− benefit that footnotes and links can be in different files, but it also
8− introduces some difficulties: (a) it is difficult to join files with
9− footnotes without some sort of preprocessing, which makes it difficult
10− to write academic documents in small pieces; (b) it makes it impossible
11− to process multiple binary input files, which can't be catted; (c) it
12− makes it impossible to process files from different input formats.
13− The `--file-scope` option causes pandoc to parse the files first,
14− and then combine the parsed output, instead of combining before
15− parsing. This makes it impossible to have links across multiple files,
16− and auto-identified headers won't work correctly if headers in multiple
17− files have the same name. On the other hand, footnotes across multiple
18− files will work correctly and will allow more freedom for input formats.
19− `--file-scope` is selected automatically for binary input files (which
20− cannot be concatenated anyway) and for pandoc json.
7+ benefit that footnotes and links can be in different files, but for
8+ some purposes it is useful to parse the individual files first
9+ and then combine their outputs (e.g. when the files use footnotes
10+ or links with the same labels). The `--file-scope` option causes
11+ pandoc to parse the files first, and then combine the parsed output,
12+ instead of combining before parsing. `--file-scope` is selected
13+ automatically for binary input files (which cannot be concatenated)
14+ and for pandoc json.
2115
2216 * Add TEI Writer (Chris Forster) and `tei` output format.
2317