System Install
--------------

To install a system-wide version of xml2rfc, simply run::

   $ python setup.py install

User Install
------------

If you want to perform a local installation for a specific user, you have a
couple of options. You may use python's default location of user site-packages
by specifying the flag --user. These locations are::

   UNIX: $HOME/.local/lib/python<ver>/site-packages
   OSX: $HOME/Library/Python/<ver>/lib/python/site-packages
   Windows: %APPDATA%/Python/Python<ver>/site-packages

You can additionally combine the flag --install-scripts with --user to specify
a directory on your PATH to install the xml2rfc executable to. For example,
the following command::

   $ python setup.py install --user --install-scripts=$HOME/bin

will install the xml2rfc library and data to your local site-packages
directory, and an executable python script xml2rfc to $HOME/bin.

Note that if you do not specify --install-scripts, and the default location
(/usr/local/bin) has unsuitable privileges, the script will be placed in another
location chosen by the installation script.

Custom Install
--------------

The option --prefix allows you to specify the base path for all installation
files. The setup.py script will exit with an error if your PYTHONPATH is not
correctly configured to contain the library path the script tries to install
to.

The command is used as follows::

   $ python setup.py install --prefix=<path>

For further fine-tuning of the installation behavior, you can get a list of
all available options by running::

   $ python setup.py install --help

