From 5f91f06fd9d3d236e689bbd745c6d2ffa26e8ca6 Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Sun, 20 Mar 2016 13:03:57 -0700 Subject: Clarify and shorten description of file-scope in changelog. --- changelog | 24 +++++++++--------------- 1 file changed, 9 insertions(+), 15 deletions(-) (limited to 'changelog') diff --git a/changelog b/changelog index 667bf5144..1776125b4 100644 --- a/changelog +++ b/changelog @@ -1,23 +1,17 @@ pandoc (1.17) * Added `--file-scope` option (Jesse Rosenthal). - Traditionally pandoc operates on multiple files by first concatenating + By default pandoc operates on multiple files by first concatenating them (around extra line breaks) and then processing the joined file. So it only parses a multi-file document at the document scope. This has the - benefit that footnotes and links can be in different files, but it also - introduces some difficulties: (a) it is difficult to join files with - footnotes without some sort of preprocessing, which makes it difficult - to write academic documents in small pieces; (b) it makes it impossible - to process multiple binary input files, which can't be catted; (c) it - makes it impossible to process files from different input formats. - The `--file-scope` option causes pandoc to parse the files first, - and then combine the parsed output, instead of combining before - parsing. This makes it impossible to have links across multiple files, - and auto-identified headers won't work correctly if headers in multiple - files have the same name. On the other hand, footnotes across multiple - files will work correctly and will allow more freedom for input formats. - `--file-scope` is selected automatically for binary input files (which - cannot be concatenated anyway) and for pandoc json. + benefit that footnotes and links can be in different files, but for + some purposes it is useful to parse the individual files first + and then combine their outputs (e.g. when the files use footnotes + or links with the same labels). The `--file-scope` option causes + pandoc to parse the files first, and then combine the parsed output, + instead of combining before parsing. `--file-scope` is selected + automatically for binary input files (which cannot be concatenated) + and for pandoc json. * Add TEI Writer (Chris Forster) and `tei` output format. -- cgit v1.2.3