source: xincludes/pip3-cmd-explain.xml@ fa411f6e

11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/soup3 xry111/xf86-video-removal
Last change on this file since fa411f6e was fa411f6e, checked in by Bruce Dubbs <bdubbs@…>, 22 months ago

larify pip3 install options.

In some cases --upgrade or --force-reinstall is needed when installing
a python module. Add some notes describing these options.

If one of the above options is used, --no-deps may be needed to avoid
reinstalling package dependencies. Note this option also.

  • Property mode set to 100644
File size: 1.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE note PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../general.ent">
5 %general-entities;
6 ]>
7
8 <sect3 role="commands">
9 <title>Command Explanations</title>
10
11 <para>
12 <parameter>-w dist</parameter>: builds the appropriate
13 "wheel" for this module in the directory
14 <filename class="directory">dist</filename>.
15 </para>
16
17 <para>
18 <parameter>--no-build-isolation</parameter>: tells pip3 to run the
19 build in the system environment instead of creating a temporary
20 build environment.
21 </para>
22
23 <para>
24 <parameter>--no-deps</parameter>: prevents pip3 from building wheels for
25 the project's dependencies.
26 </para>
27
28 <para>
29 <parameter>--no-index</parameter>: ignores the package index
30 (only looking at --find-links URLs instead).
31 </para>
32
33 <para>
34 <parameter>--find-links dist</parameter>: looks for links to archives
35 such as wheel (.whl) files in the directory
36 <filename class="directory">dist</filename>.
37 </para>
38
39 <para>
40 <parameter>--no-cache-dir</parameter>: diables the cache to prevent
41 a warning when installing as the &root; user.
42 </para>
43
44 <para>
45 <option>--upgrade</option>: Upgrade the package to the newest
46 available version. This option is used with the install command
47 if a version of the package is already installed.
48 </para>
49
50 <para>
51 <option>--force-reinstall</option>: Reinstall the package even if
52 it is up-to-date. This option is used with the install command
53 if reinstalling the package or reverting to an earlier version
54 of the package.
55 </para>
56
57 <para>
58 <option>--no-deps</option>: Do not install package dependencies.
59 This option may be needed with the --upgrade or --force-reinstall
60 options.
61 </para>
62
63 </sect3>
64
Note: See TracBrowser for help on using the repository browser.