diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/narr/install.rst | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/docs/narr/install.rst b/docs/narr/install.rst index 7a970d437..480597e75 100644 --- a/docs/narr/install.rst +++ b/docs/narr/install.rst @@ -21,6 +21,18 @@ primarily under Python 2.4, so that version is recommended. :term:`setuptools` installed on within your Python system in order to run the ``easy_install`` command. +At the time of this writing, ``repoze.bfg`` will not install on +Windows systems unless you have development tools (e.g. *Visual C++*) +installed. + +.. note:: If you'd like to help produce and maintain a version of + :mod:`repoze.bfg` that works on Windows, we'd love to hear from + you. There's nothing intrinsic about :mod:`repoze.bfg` that would + prevent it from running on Windows, but none of the current + developers use the platform. Please contact us via the `repoze.dev + maillist <http://lists.repoze.org/listinfo/repoze-dev>`_ if you'd + like to try to tackle the job of compilation and maintenance. + It is advisable to install :mod:`repoze.bfg` into a :term:`virtualenv` in order to obtain isolation from any "system" packages you've got installed in your Python version (and likewise, to prevent @@ -33,6 +45,14 @@ command:: $ easy_install -i http://dist.repoze.org/lemonade/dev/simple repoze.bfg +.. note:: If you can't get :mod:`repoze.bfg` installed using + ``easy_install`` because ``lxml`` fails to compile on your system, + you can try the `repoze.bfg buildout at + <http://svn.repoze.org/buildouts/repoze.bfg/trunk/README.txt>`_. + This buildout builds known-compatible ``libxml2`` and ``libxslt`` + from source and causes ``lxml`` to link against these instead of + your system packages. + What Gets Installed ------------------- |