From 8e396f4be2932851ae5e3a794a6b7968bf1030a6 Mon Sep 17 00:00:00 2001
From: "James R. Barlow" <jim@purplerock.ca>
Date: Mon, 29 Oct 2018 02:03:58 -0700
Subject: [PATCH] Document --redo-ocr more accurately

---
 src/ocrmypdf/__main__.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/ocrmypdf/__main__.py b/src/ocrmypdf/__main__.py
index c21e2f06..bea152cf 100755
--- a/src/ocrmypdf/__main__.py
+++ b/src/ocrmypdf/__main__.py
@@ -264,8 +264,10 @@ ocrsettings.add_argument(
          "images, text pages, and/or previously OCRed pages")
 ocrsettings.add_argument(
     '--redo-ocr', action='store_true',
-    help="Remove any invisible text, and apply OCR")
-
+    help="Attempt to detect and remove the hidden OCR layer from files that "
+         "were previously OCRed with OCRmyPDF or another program. Apply OCR "
+         "to text found in raster images. Existing visible text objects will "
+         "not be changed. If there is no existing OCR, OCR will be added.")
 ocrsettings.add_argument(
     '--skip-big', type=numeric(float, 0, 5000), metavar='MPixels',
     help="Skip OCR on pages larger than the specified amount of megapixels, "