mirror of
https://git.linuxfromscratch.org/lfs.git
synced 2025-01-18 21:17:38 +00:00
a3ebe8aa2b
because some references appear to refer to the program itself, and not to the package. Corrected English idiom here and there.
144 lines
4.3 KiB
XML
144 lines
4.3 KiB
XML
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % general-entities SYSTEM "../general.ent">
|
|
%general-entities;
|
|
]>
|
|
|
|
<sect1 id="ch-system-wheel" role="wrap">
|
|
<?dbhtml filename="wheel.html"?>
|
|
|
|
<sect1info condition="script">
|
|
<productname>wheel</productname>
|
|
<productnumber>&wheel-version;</productnumber>
|
|
<address>&wheel-url;</address>
|
|
</sect1info>
|
|
|
|
<title>Wheel-&wheel-version;</title>
|
|
|
|
<indexterm zone="ch-system-wheel">
|
|
<primary sortas="a-wheel">wheel</primary>
|
|
</indexterm>
|
|
|
|
<sect2 role="package">
|
|
<title/>
|
|
|
|
<para>Wheel is a Python library that is the reference
|
|
implementation of the Python wheel packaging standard.</para>
|
|
|
|
<segmentedlist>
|
|
<segtitle>&buildtime;</segtitle>
|
|
<segtitle>&diskspace;</segtitle>
|
|
<seglistitem>
|
|
<seg>&wheel-fin-sbu;</seg>
|
|
<seg>&wheel-fin-du;</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of Wheel</title>
|
|
|
|
<para>Compile Wheel with the following command:</para>
|
|
|
|
<screen><userinput remap="make">PYTHONPATH=src pip3 wheel -w dist --no-build-isolation --no-deps $PWD</userinput></screen>
|
|
|
|
<para>Install Wheel with the following command:</para>
|
|
|
|
<screen><userinput remap="install">pip3 install --no-index --find-links=dist wheel</userinput></screen>
|
|
|
|
<variablelist>
|
|
<title>The meaning of the pip3 configuration options and commands:</title>
|
|
|
|
<varlistentry>
|
|
<term><envar>PYTHONPATH=src</envar></term>
|
|
<listitem>
|
|
<para>Allows this package (not installed yet) to build a
|
|
wheel archive for itself, to avoid a chicken-or-egg problem.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><command>wheel</command></term>
|
|
<listitem>
|
|
<para>This command builds the wheel archive for this package.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><parameter>-w dist</parameter></term>
|
|
<listitem>
|
|
<para>Instructs pip to put the created wheel into the
|
|
<filename class='directory'>dist</filename> directory.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><command>install</command></term>
|
|
<listitem>
|
|
<para>This command installs the package.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><parameter>--no-build-isolation</parameter>,
|
|
<parameter>--no-deps</parameter>, and
|
|
<parameter>--no-index</parameter></term>
|
|
<listitem>
|
|
<para>These options prevent fetching files from the online package
|
|
repository (PyPI). If packages are installed in the correct order,
|
|
pip won't need to fetch any files in the first place; these
|
|
options add some safety in case of user error.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><parameter>--find-links dist</parameter></term>
|
|
<listitem>
|
|
<para>Instructs pip to search for wheel archives in the
|
|
<filename class='directory'>dist</filename> directory.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</sect2>
|
|
|
|
<sect2 id="contents-wheel" role="content">
|
|
<title>Contents of Wheel</title>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed program</segtitle>
|
|
<segtitle>Installed directories</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>wheel</seg>
|
|
<seg>
|
|
/usr/lib/python&python-minor;/site-packages/wheel and
|
|
/usr/lib/python&python-minor;/site-packages/wheel-&wheel-version;.dist-info
|
|
</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<varlistentry id="wheel-wheel">
|
|
<term><command>wheel</command></term>
|
|
<listitem>
|
|
<para>
|
|
is a utility to unpack, pack, or convert wheel archives
|
|
</para>
|
|
<indexterm zone="ch-system-wheel">
|
|
<primary sortas="b-wheel">wheel</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|
|
|