From fbef04e893255932502d2bef048b3f6b042e978f Mon Sep 17 00:00:00 2001 From: John Kerl Date: Sun, 9 Dec 2018 10:05:57 -0500 Subject: [PATCH] mixed-format caveat --- doc/content-for-reference.html | 10 ++++++++++ doc/reference.html | 10 ++++++++++ 2 files changed, 20 insertions(+) diff --git a/doc/content-for-reference.html b/doc/content-for-reference.html index c24fbd223..6d0a29aaf 100644 --- a/doc/content-for-reference.html +++ b/doc/content-for-reference.html @@ -142,6 +142,16 @@ POKI_RUN_COMMAND{{mlr --opprint --right cat data/small}}HERE +Pro-tip: Please use either --format1, or --iformat1 +--oformat2. If you use --format1 --oformat2 then what happens is +that flags are set up for input and output for format1, some of which +are overwritten for output in format2. For technical reasons, having +--oformat2 clobber all the output-related effects of +--format1 also removes some flexibility from the command-line +interface. See also +https://github.com/johnkerl/miller/issues/180 and +https://github.com/johnkerl/miller/issues/199. +

In-place mode

diff --git a/doc/reference.html b/doc/reference.html index b5efbf98e..1be9853e7 100644 --- a/doc/reference.html +++ b/doc/reference.html @@ -387,6 +387,16 @@ wye pan 5 0.5732889198020006 0.8636244699032729 +Pro-tip: Please use either --format1, or --iformat1 +--oformat2. If you use --format1 --oformat2 then what happens is +that flags are set up for input and output for format1, some of which +are overwritten for output in format2. For technical reasons, having +--oformat2 clobber all the output-related effects of +--format1 also removes some flexibility from the command-line +interface. See also +https://github.com/johnkerl/miller/issues/180 and +https://github.com/johnkerl/miller/issues/199. +

In-place mode