diff --git a/docs/cookbook.md b/docs/cookbook.md index 4fc8a514..96e3988c 100644 --- a/docs/cookbook.md +++ b/docs/cookbook.md @@ -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