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