From 1de34697321fc9db0c819cae686476ffd37e7268 Mon Sep 17 00:00:00 2001
From: Ned Batchelder <ned@nedbatchelder.com>
Date: Tue, 14 Mar 2023 06:12:57 -0400
Subject: docs: never run pip directly

---
 doc/contributing.rst | 2 +-
 doc/index.rst        | 2 +-
 doc/install.rst      | 6 +++---
 doc/plugins.rst      | 2 +-
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/doc/contributing.rst b/doc/contributing.rst
index af255fe1..165ae40b 100644
--- a/doc/contributing.rst
+++ b/doc/contributing.rst
@@ -48,7 +48,7 @@ these steps:
 
 #.  Install the requirements::
 
-    $ pip install -r requirements/dev.pip
+    $ python3 -m pip install -r requirements/dev.pip
 
 #.  Install a number of versions of Python.  Coverage.py supports a range
     of Python versions.  The more you can test with, the more easily your code
diff --git a/doc/index.rst b/doc/index.rst
index 2b2f45bd..e416bb65 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -56,7 +56,7 @@ Getting started is easy:
 
 #.  Install coverage.py::
 
-        $ pip install coverage
+        $ python3 -m pip install coverage
 
     For more details, see :ref:`install`.
 
diff --git a/doc/install.rst b/doc/install.rst
index f3e015e4..1b940b4b 100644
--- a/doc/install.rst
+++ b/doc/install.rst
@@ -15,19 +15,19 @@ Installation
 
 You can install coverage.py in the usual ways. The simplest way is with pip::
 
-    $ pip install coverage
+    $ python3 -m pip install coverage
 
 .. ifconfig:: prerelease
 
     To install a pre-release version, you will need to specify ``--pre``::
 
-        $ pip install --pre coverage
+        $ python3 -m pip install --pre coverage
 
     or the exact version you want to install:
 
     .. parsed-literal::
 
-        $ pip install |coverage-equals-release|
+        $ python3 -m pip install |coverage-equals-release|
 
 .. _install_extension:
 
diff --git a/doc/plugins.rst b/doc/plugins.rst
index c76e4f9b..a289ba7e 100644
--- a/doc/plugins.rst
+++ b/doc/plugins.rst
@@ -29,7 +29,7 @@ a coverage.py plug-in called ``something.plugin``.
 
    .. code-block:: sh
 
-    $ pip install something
+    $ python3 -m pip install something
 
 #. Configure coverage.py to use the plug-in.  You do this by editing (or
    creating) your .coveragerc file, as described in :ref:`config`.  The
-- 
cgit v1.2.1