Add examples that work on Windows to distutils docs (#1626300)
This commit is contained in:
parent
ce5493f33d
commit
a65a880cd2
|
@ -79,11 +79,17 @@ Some observations:
|
||||||
for an example)
|
for an example)
|
||||||
|
|
||||||
To create a source distribution for this module, you would create a setup
|
To create a source distribution for this module, you would create a setup
|
||||||
script, :file:`setup.py`, containing the above code, and run::
|
script, :file:`setup.py`, containing the above code, and run this command from a
|
||||||
|
terminal::
|
||||||
|
|
||||||
python setup.py sdist
|
python setup.py sdist
|
||||||
|
|
||||||
which will create an archive file (e.g., tarball on Unix, ZIP file on Windows)
|
For Windows, open a command prompt windows ("DOS box") and change the command
|
||||||
|
to::
|
||||||
|
|
||||||
|
setup.py sdist
|
||||||
|
|
||||||
|
:command:`sdist` will create an archive file (e.g., tarball on Unix, ZIP file on Windows)
|
||||||
containing your setup script :file:`setup.py`, and your module :file:`foo.py`.
|
containing your setup script :file:`setup.py`, and your module :file:`foo.py`.
|
||||||
The archive file will be named :file:`foo-1.0.tar.gz` (or :file:`.zip`), and
|
The archive file will be named :file:`foo-1.0.tar.gz` (or :file:`.zip`), and
|
||||||
will unpack into a directory :file:`foo-1.0`.
|
will unpack into a directory :file:`foo-1.0`.
|
||||||
|
|
|
@ -96,10 +96,16 @@ in the name of the downloaded archive, e.g. :file:`foo-1.0.tar.gz` or
|
||||||
directory: :file:`foo-1.0` or :file:`widget-0.9.7`. Additionally, the
|
directory: :file:`foo-1.0` or :file:`widget-0.9.7`. Additionally, the
|
||||||
distribution will contain a setup script :file:`setup.py`, and a file named
|
distribution will contain a setup script :file:`setup.py`, and a file named
|
||||||
:file:`README.txt` or possibly just :file:`README`, which should explain that
|
:file:`README.txt` or possibly just :file:`README`, which should explain that
|
||||||
building and installing the module distribution is a simple matter of running ::
|
building and installing the module distribution is a simple matter of running
|
||||||
|
one command from a terminal::
|
||||||
|
|
||||||
python setup.py install
|
python setup.py install
|
||||||
|
|
||||||
|
For Windows, this command should be run from a command prompt windows ("DOS
|
||||||
|
box")::
|
||||||
|
|
||||||
|
setup.py install
|
||||||
|
|
||||||
If all these things are true, then you already know how to build and install the
|
If all these things are true, then you already know how to build and install the
|
||||||
modules you've just downloaded: Run the command above. Unless you need to
|
modules you've just downloaded: Run the command above. Unless you need to
|
||||||
install things in a non-standard way or customize the build process, you don't
|
install things in a non-standard way or customize the build process, you don't
|
||||||
|
@ -113,14 +119,11 @@ Standard Build and Install
|
||||||
==========================
|
==========================
|
||||||
|
|
||||||
As described in section :ref:`inst-new-standard`, building and installing a module
|
As described in section :ref:`inst-new-standard`, building and installing a module
|
||||||
distribution using the Distutils is usually one simple command::
|
distribution using the Distutils is usually one simple command to run from a
|
||||||
|
terminal::
|
||||||
|
|
||||||
python setup.py install
|
python setup.py install
|
||||||
|
|
||||||
On Unix, you'd run this command from a shell prompt; on Windows, you have to
|
|
||||||
open a command prompt window ("DOS box") and do it there; on Mac OS X, you open
|
|
||||||
a :command:`Terminal` window to get a shell prompt.
|
|
||||||
|
|
||||||
|
|
||||||
.. _inst-platform-variations:
|
.. _inst-platform-variations:
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue