Update cookbook: Replace --tesseract-timeout 0 with --ocr-engine none

Update documentation examples to use the new --ocr-engine none option
instead of the deprecated --tesseract-timeout 0 idiom for disabling OCR.
This commit is contained in:
James R. Barlow
2026-01-12 23:28:14 -08:00
parent c69f293322
commit 36dea181e6
+13 -6
View File
@@ -215,15 +215,22 @@ ocrmypdf --deskew --clean --rotate-pages input.pdf output.pdf
Don\'t actually OCR my PDF
--------------------------
If you set `--tesseract-timeout 0` OCRmyPDF will apply its image
processing without performing OCR (by causing OCR to time out). This
works if all you want to is to apply image processing or PDF/A
If you set `--ocr-engine none` OCRmyPDF will apply its image processing without
performing OCR. This works if all you want to is to apply image processing or PDF/A
conversion.
```bash
ocrmypdf --tesseract-timeout 0 --remove-background input.pdf output.pdf
ocrmypdf --ocr-engine none --deskew --output-type pdfa input.pdf output.pdf
```
:::{versionchanged} v17.0.0
Prior to this version, `--tesseract-timeout 0` was recommended as an idiom
to turn off OCR. This is not longer recommended, as we move away from
Tesseract OCR as the primary OCR engine.
:::
:::{versionchanged} v14.1.0
Prior to this version, `--tesseract-timeout 0` would prevent other uses
@@ -238,7 +245,7 @@ This is getting ridiculous, but OCRmyPDF can complete strip all textual
information from a PDF and reconstruct it as a \"bag of images\" PDF.
```bash
ocrmypdf --tesseract-timeout 0 --force-ocr input.pdf output.pdf
ocrmypdf --ocr-engine none --force-ocr input.pdf output.pdf
```
Why would you want to do this? Perhaps you have a PDF where OCR fails to
@@ -250,7 +257,7 @@ This command also removes OCR generated by third party tools.
You can also optimize all images without performing any OCR:
```bash
ocrmypdf --tesseract-timeout 0 --optimize 3 --skip-text input.pdf output.pdf
ocrmypdf --ocr-engine none --optimize 3 --skip-text input.pdf output.pdf
```
### Process only certain pages