From 123c0c766f9ac9b46c824391a383cefc137acbce Mon Sep 17 00:00:00 2001
From: "James R. Barlow" <james@purplerock.ca>
Date: Thu, 8 Feb 2024 09:42:00 -0800
Subject: [PATCH] Mention pipx, install --user --upgrade

Closes #1249
---
 docs/installation.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/installation.rst b/docs/installation.rst
index 615843b55..b1daa7604 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -542,9 +542,25 @@ try:
 
     pip install --user ocrmypdf
 
+(If the message appears ``Requirement already satisfied: ocrmypdf in...``,
+you will need to use ``pip install --user --upgrade ocrmypdf``.)
+
 You should then be able to run ``ocrmypdf --version`` and see that the
 latest version was located.
 
+Installing with pipx
+====================
+
+Some users may prefer pipx. As with the method above, you will need to
+satisfy all non-Python dependencies. Then if pipx is installed, you
+can use
+
+.. code-block:: bash
+
+    pipx run ocrmypdf
+
+(If not installed, pipx will install first.)
+
 Requirements for pip and HEAD install
 -------------------------------------