summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStefan Behnel <stefan_ml@behnel.de>2013-04-12 07:13:11 +0200
committerStefan Behnel <stefan_ml@behnel.de>2013-04-12 07:13:11 +0200
commit87eb6381edbf15305b5f068dd34a1f17d96faefa (patch)
treee864ce85fe7d74a51bd28b1dd95442d449959e42
parent3ada91ef74d2d5db8749cd20744d7e702fda691e (diff)
downloadpython-lxml-87eb6381edbf15305b5f068dd34a1f17d96faefa.tar.gz
faq updates
-rw-r--r--doc/FAQ.txt25
1 files changed, 12 insertions, 13 deletions
diff --git a/doc/FAQ.txt b/doc/FAQ.txt
index f37211d1..76079bff 100644
--- a/doc/FAQ.txt
+++ b/doc/FAQ.txt
@@ -418,23 +418,22 @@ Two of the major design issues of this operating system make it
non-trivial for its users to build lxml: the lack of a pre-installed
standard compiler and the missing package management.
-We previously provided Windows binaries through PyPI, but no
-longer do so due to the high maintenance overhead they introduce and
-the difficulty in supporting different system configurations.
-Christoph Gohlke generously provides `unofficial lxml binary builds
-for Windows <http://www.lfd.uci.edu/~gohlke/pythonlibs/#lxml>`_ that
-are usually very up to date. Consider using them if you prefer a
+For recent lxml releases, PyPI provides community donated Windows binaries.
+Besides that, Christoph Gohlke generously provides `unofficial lxml binary
+builds for Windows <http://www.lfd.uci.edu/~gohlke/pythonlibs/#lxml>`_
+that are usually very up to date. Consider using them if you prefer a
binary build over a signed official source release.
Why do I get errors about missing UCS4 symbols when installing lxml?
--------------------------------------------------------------------
-Most likely, you use a Python installation that was configured for internal
-use of UCS2 unicode, meaning 16-bit unicode. The lxml egg distributions are
-generally compiled on platforms that use UCS4, a 32-bit unicode encoding, as
-this is used on the majority of platforms. Sadly, both are not compatible, so
-the eggs can only support the one they were compiled with.
+You are using a Python installation that was configured for a different
+internal Unicode representation than the lxml package you are trying to
+install. CPython versions before 3.3 allowed to switch between two types
+at build time: the 32 bit encoding UCS4 and the 16 bit encoding UCS2.
+Sadly, both are not compatible, so eggs and other binary distributions
+can only support the one they were compiled with.
This means that you have to compile lxml from sources for your system. Note
that you do not need Cython for this, the lxml source distribution is directly
@@ -456,7 +455,7 @@ required for performance reasons.
However, to avoid writing plain C-code and caring too much about the
details of built-in types and reference counting, lxml is written in
-Cython_, a Python-like language that is translated into C-code.
+Cython_, a superset of the Python language that translates to C-code.
Chances are that if you know Python, you can write `code that Cython
accepts`_. Again, the C-ish style used in the lxml code is just for
performance optimisations. If you want to contribute, don't bother
@@ -464,7 +463,7 @@ with the details, a Python implementation of your contribution is
better than none. And keep in mind that lxml's flexible API often
favours an implementation of features in pure Python, without
bothering with C-code at all. For example, the ``lxml.html`` package
-is entirely written in Python.
+is written entirely in Python.
Please contact the `mailing list`_ if you need any help.