From 42ca1f007ac18b2a1426093c02c6ff261b737eae Mon Sep 17 00:00:00 2001
From: Jay Berkenbilt <ejb@ql.org>
Date: Tue, 2 Nov 2021 18:06:09 -0400
Subject: Document that --check > /dev/null is safe (fixes #522)

---
 manual/qpdf-manual.xml | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

(limited to 'manual')

diff --git a/manual/qpdf-manual.xml b/manual/qpdf-manual.xml
index 411cfcfb..f5dd444e 100644
--- a/manual/qpdf-manual.xml
+++ b/manual/qpdf-manual.xml
@@ -2943,7 +2943,12 @@ outfile.pdf</option>
         recover, after which other options are effectively operating
         on the recovered file. Combining <option>--check</option> with
         other options in this way can be useful for manually
-        recovering severely damaged files.
+        recovering severely damaged files. Note that
+        <option>--check</option> produces no output to standard output
+        when everything is valid, so if you are using this to
+        programmatically validate files in bulk, it is safe to run
+        without output redirected to <filename>/dev/null</filename>
+        and just check for a 0 exit code.
        </para>
       </listitem>
      </varlistentry>
-- 
cgit v1.2.3-54-g00ecf