Merge pull request #952 from bhrutledge/copy-edit-pipx

Copy-edit pipx guide

Author: webknjaz

source/guides/installing-stand-alone-command-line-tools.rst

@@ -1,53 +1,55 @@
 Installing stand alone command line tools
 =========================================
 
-Many packages have command line entry points. Examples of this type of application are
+Many packages provide command line applications. Examples of such packages are
 `mypy <https://github.com/python/mypy>`_,
 `flake8 <https://github.com/PyCQA/flake8>`_,
-:ref:`pipenv`,and
-`black <https://github.com/ambv/black>`_.
+`black <https://github.com/psf/black>`_, and
+:ref:`pipenv`.
 
-Usually you want to be able to access these from anywhere,
-but installing packages and their dependencies to the same global environment
-can cause version conflicts and break dependencies the operating system has
-on Python packages.
+Usually you want to be able to access these applications from anywhere on your
+system, but installing packages and their dependencies to the same global
+environment can cause version conflicts and break dependencies the operating
+system has on Python packages.
 
-:ref:`pipx` solves this by creating a virtual
-environment for each package, while also ensuring that package's applications
-are accessible through a directory that is on your ``$PATH``. This allows each
-package to be upgraded or uninstalled without causing conflicts with other
-packages, and allows you to safely run the program from anywhere.
+:ref:`pipx` solves this by creating a virtual environment for each package,
+while also ensuring that its applications are accessible through a directory
+that is on your ``$PATH``. This allows each package to be upgraded or
+uninstalled without causing conflicts with other packages, and allows you to
+safely run the applications from anywhere.
 
 .. note:: pipx only works with Python 3.6+.
 
-``pipx`` is installed with ``pip``:
+pipx is installed with pip:
 
 .. tab:: Unix/macOS
 
   .. code-block:: bash
 
       python3 -m pip install --user pipx
-
-      python3 -m pipx ensurepath  # ensures the path of the CLI application directory is on your $PATH
+      python3 -m pipx ensurepath
 
 .. tab:: Windows
 
   .. code-block:: bat
 
       py -m pip install --user pipx
-      
       py -m pipx ensurepath
 
-.. Note:: You may need to restart your terminal for the path updates to take effect.
+.. note::
+
+   ``ensurepath`` ensures that the application directory is on your ``$PATH``.
+   You may need to restart your terminal for this update to take effect.
 
-Now you can install packages with ``pipx install`` and access the package's entry point(s) from anywhere.
+Now you can install packages with ``pipx install`` and run the package's
+applications(s) from anywhere.
 
 .. code-block:: console
 
   $ pipx install PACKAGE
-  $ ENTRYPOINT_OF_PACKAGE [ARGS]
+  $ PACKAGE_APPLICATION [ARGS]
 
-For example
+For example:
 
 .. code-block:: console
 
@@ -67,7 +69,8 @@ For example
              (__)\       )\/       ||----w |
                  ||     ||
 
-To see a list of packages installed with pipx and which CLI applications are available, use ``pipx list``.
+To see a list of packages installed with pipx and which applications are
+available, use ``pipx list``:
 
 .. code-block:: console
 
@@ -87,14 +90,14 @@ To see a list of packages installed with pipx and which CLI applications are ava
       - nox
       - tox-to-nox
 
-To upgrade or uninstall the package
+To upgrade or uninstall a package:
 
 .. code-block:: bash
 
   pipx upgrade PACKAGE
   pipx uninstall PACKAGE
 
-``pipx`` can be upgraded or uninstalled with pip
+pipx can be upgraded or uninstalled with pip:
 
 .. tab:: Unix/macOS
 
@@ -109,25 +112,18 @@ To upgrade or uninstall the package
 
       py -m pip install -U pipx
       py -m pip uninstall pipx
-      
-``pipx`` also allows you to install and run the latest version of a cli tool
-in a temporary, ephemeral environment.
-
-.. code-block:: bash
-
-  pipx run PACKAGE [ARGS]
 
-For example
+pipx also allows you to install and run the latest version of an application
+in a temporary, ephemeral environment. For example:
 
 .. code-block:: bash
 
   pipx run cowsay moooo
 
-To see the full list of commands ``pipx`` offers, run
+To see the full list of commands pipx offers, run:
 
 .. code-block:: bash
 
   pipx --help
 
-You can learn more about ``pipx`` at its homepage,
-https://github.com/pypa/pipx.
+You can learn more about pipx at https://pypa.github.io/pipx/.