Updated the building and caveats documentation

Author: bastienleonard

doc/sphinx/source/building.rst

@@ -154,16 +154,33 @@ module by typing this command::
     python setup.py build_ext
 
 
+.. _building_with_cython:
+
 Building with Cython installed
 ------------------------------
 
 .. warning::
 
-   Currently, modules built straight from the repo probably won't work
-   (this may depend on your Cython version). Consider using a source
-   release, or follow the indications from this forum post if you
-   still want to build from Git:
-   http://en.sfml-dev.org/forums/index.php?topic=5311.msg52943#msg52943
+   Currently, the binding doesn't work correctly when built straight
+   from the Git repo. I explained the problem here:
+   https://groups.google.com/forum/?fromgroups#!topic/cython-users/W8hMcjsFfDU
+   If you want to build from the source, you're encouraged to use the
+   latest source release. See :ref:`building_without_cython`.  If you
+   really want to build from Git, you need to modify the generated
+   sfml.cpp file.  You need all these declarations::
+
+    __PYX_EXTERN_C DL_EXPORT(PyObject) *wrap_time_instance(sf::Time *);
+    __PYX_EXTERN_C DL_EXPORT(PyObject) *wrap_render_target_instance(sf::RenderTarget *);
+    __PYX_EXTERN_C void set_error_message(char*);
+    __PYX_EXTERN_C DL_EXPORT(PyObject) *wrap_chunk_instance(sf::SoundStream::Chunk*, int);
+
+
+   I don't know if it's the same exact problem everywhere, but on my
+   system I get the first declaration and not the others. So you can
+   look for the ``wrap_time_instance()`` declaration, and copy-paste
+   the others after it.
+
+   This bug should be fixed in the next Cython release.
 
 .. warning::
 

doc/sphinx/source/caveats.rst

@@ -37,14 +37,13 @@ Caveats
 =======
 
 Currently, the binding doesn't work correctly when built straight from
-the Git repo, see this forum post:
-http://en.sfml-dev.org/forums/index.php?topic=5311.msg52943#msg52943
-If you want to build from the source, you're encouraged to use the
-latest source release. See :ref:`building_without_cython`.
-
-Windows programs crash just before exiting. My guess is that it's
-related to the destruction of static objects; I'll try to fix it for
-the next minor release.
+the Git repo. See :ref:`building_with_cython` for more information.
+
+Windows programs sometimes crash just before exiting. Starting from
+pySFML 0.2.1, the default font has been removed, which should solve a
+lot of deallocation problems. Christoph Gohlke's installers also seem
+to generally be more reliable, so as far as I know, newer installers
+shouldn't have this bug.
 
 A current limitation is that :class:`Texture` objects won't work as
 expected unless they are created after your :class:`RenderWindow`. It