summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorChris Pryer <cnpryer@gmail.com>2023-01-18 20:49:40 -0500
committerChris Pryer <cnpryer@gmail.com>2023-01-19 21:45:29 -0500
commit950522e456714f5ba8bddae695041afecabff558 (patch)
tree1b10d04b22ac3b043a88bf54b93da5e286943da8 /docs
parent95a58e7ba58e769af882502f7436559f61ecca8a (diff)
downloadpip-950522e456714f5ba8bddae695041afecabff558.tar.gz
Fix docs
Diffstat (limited to 'docs')
-rw-r--r--docs/html/development/architecture/overview.rst16
-rw-r--r--docs/html/user_guide.rst2
2 files changed, 9 insertions, 9 deletions
diff --git a/docs/html/development/architecture/overview.rst b/docs/html/development/architecture/overview.rst
index f9bcfb873..63445754a 100644
--- a/docs/html/development/architecture/overview.rst
+++ b/docs/html/development/architecture/overview.rst
@@ -24,9 +24,9 @@ Things pip does:
backwards compatibility reasons. But thing with setuptools:
has a ``setup.py`` file that it invokes to …… get info?
-2. Decides where to install stuff. Once the package is built, resulting
- artifact is then installed into system in appropriate place. :pep:`517`
- defines interface between build backend & installer.
+2. Decides where to install stuff. Once the package is built, the resulting
+ artifact is then installed to the system in its appropriate place. :pep:`517`
+ defines the interface between the build backend & installer.
Broad overview of flow
======================
@@ -111,24 +111,24 @@ The package index gives pip a list of files for that package (via the existing P
pip chooses from the list a single file to download.
-It may go back and choose another file to download
+It may go back and choose another file to download.
When pip looks at the package index, the place where it looks has
-basically a link. The link’s text is the name of the file
+basically a link. The link’s text is the name of the file.
This is the `PyPI Simple API`_ (PyPI has several APIs, some are being
deprecated). pip looks at Simple API, documented initially at :pep:`503` --
packaging.python.org has PyPA specifications with more details for
-Simple Repository API
+Simple Repository API.
-For this package name -- this is the list of files available
+For this package name -- this is the list of files available.
Looks there for:
* The list of filenames
* Other info
-Once it has those, selects one file, downloads it
+Once it has those, it selects one file and downloads it.
(Question: If I want to ``pip install flask``, I think the whole list of filenames
cannot….should not be …. ? I want only the Flask …. Why am I getting the
diff --git a/docs/html/user_guide.rst b/docs/html/user_guide.rst
index b90b778b8..966b200f4 100644
--- a/docs/html/user_guide.rst
+++ b/docs/html/user_guide.rst
@@ -800,7 +800,7 @@ As noted previously, pip is a command line program. While it is implemented in
Python, and so is available from your Python code via ``import pip``, you must
not use pip's internal APIs in this way. There are a number of reasons for this:
-#. The pip code assumes that is in sole control of the global state of the
+#. The pip code assumes that it is in sole control of the global state of the
program.
pip manages things like the logging system configuration, or the values of
the standard IO streams, without considering the possibility that user code