python: add a <important> for pip3 usage

This commit is contained in:
Xi Ruoyao 2022-04-21 14:23:07 +08:00
parent e286d8db14
commit 720c0bd9fb
No known key found for this signature in database
GPG Key ID: D95E4716CCBB34DC

View File

@ -109,6 +109,27 @@
-i /usr/lib/python3.10/site-packages/pip/_internal/cli/req_command.py
</userinput></screen>
<important>
<para>
In LFS and BLFS, we normally build and install Python modules with
<command>pip3</command>. Please take care that the
<command>pip3 install</command> commands in both the books should be
run as &root; unless it's for a Python virtual environment. Running
a <command>pip3 install</command> as a non-&root; user may seems to
work fine, but it will cause the installed module unaccessible by
other users.
</para>
<para>
<command>pip3 install</command> will not reinstall an already
installed module by default. For using the
<command>pip3 install</command> command to upgrade a module (for
example, from meson-0.61.3 to meson-0.62.0), append
<parameter>-U</parameter> to the command line. If it's really
necessary to downgrade a module or reinstall the same version for
some reason, append <parameter>--force-reinstall</parameter> to
the command line.
</para>
</important>
<para>If desired, install the preformatted documentation:</para>