glfs/xincludes/pip3-cmd-explain.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE note PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" >

  <sect3 role="commands">
    <title>Command Explanations</title>

    <para>
      <option>-w dist</option>: builds the appropriate
      "wheel" for this module in the directory
      <filename class="directory">dist</filename>.
    </para>

    <para>
      <option>--no-build-isolation</option>: tells pip3 to run the 
      build in the system environment instead of creating a temporary 
      build environment.
    </para>

    <para>
      <option>--no-deps</option>: prevents pip3 from building wheels for 
      the project's dependencies.
    </para>

    <para>
      <option>--no-index</option>: ignores the package index 
      (only looking at --find-links URLs instead).
    </para>

    <para>
      <option>--find-links dest</option>: looks for links to archives
      such as wheel (.whl) files in the directory 
      <filename class="directory">dist</filename>.
    </para>

  </sect3>