summaryrefslogtreecommitdiff
path: root/MANUAL.txt
diff options
context:
space:
mode:
authorJohn MacFarlane <jgm@berkeley.edu>2017-08-16 09:45:12 -0700
committerJohn MacFarlane <jgm@berkeley.edu>2017-08-16 09:45:12 -0700
commit61cf3affa98f8331a2f2d55eedf56fc2a2a529e2 (patch)
tree40310ec042502fb98f14bfc2d79b3bf787be48a6 /MANUAL.txt
parent7a40f4865fb635ff4e126697895da956300e7e35 (diff)
Change behavior with binary format output to stdout.
Previously, for binary formats, output to stdout was disabled unless we could detect that the output was being piped (and not sent to the terminal). Unfortunately, such detection is not possible on Windows, leaving windows users no way to pipe binary output. So we have changed the behavior in the following way: * If the -o option is not used, binary output is never sent to stdout by default; instead, an error is raised. * IF '-o -' is used, binary output is sent to stdout, regardless of whether it is being piped. This works on Windows too.
Diffstat (limited to 'MANUAL.txt')
-rw-r--r--MANUAL.txt8
1 files changed, 4 insertions, 4 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index e2d68b86b..e106af052 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -110,8 +110,8 @@ If no *input-file* is specified, input is read from *stdin*.
Otherwise, the *input-files* are concatenated (with a blank
line between each) and used as input. Output goes to *stdout* by
default (though output to *stdout* is disabled for the `odt`, `docx`,
-`epub2`, and `epub3` output formats). For output to a file, use the
-`-o` option:
+`epub2`, and `epub3` output formats, unless it is forced using
+`-o -`). For output to a file, use the `-o` option:
pandoc -o output.html input.txt
@@ -328,8 +328,8 @@ General options
`-o` *FILE*, `--output=`*FILE*
: Write output to *FILE* instead of *stdout*. If *FILE* is
- `-`, output will go to *stdout*. (Exception: if the output
- format is `odt`, `docx`, `epub`, or `epub3`, output to stdout is disabled.)
+ `-`, output will go to *stdout*, even if a non-textual format
+ (`docx`, `odt`, `epub2`, `epub3`) is specified.
`--data-dir=`*DIRECTORY*