Add warning and description for P4A in a venv...

FeralBytes · FeralBytes · commit 48eb50853cc9 · 2015-03-07T17:02:52.000-05:00
Adds a full description of the error caused by using P4A from within a
virtual enviroment to the FAQ. Also adds a Warning in usuage that links
to the FAQ in reference to the command that could result in the error.
diff --git a/docs/source/faq.rst b/docs/source/faq.rst
@@ -29,3 +29,13 @@ must:
     lib-dynload/_sqlite3.so
 
 Then sqlite3 will be compiled and included in your APK.
+
+Too many levels of symbolic links
+-----------------------------------------------------
+
+Python for Android does not work within a virtual enviroment. The Python for 
+Android directory must be outside of the virtual enviroment prior to running
+
+    ./distribute.sh -m "kivy"
+
+or else you may encounter OSError: [Errno 40] Too many levels of symbolic links.
diff --git a/docs/source/usage.rst b/docs/source/usage.rst
@@ -8,6 +8,9 @@ If you want to compile the toolchain with only the kivy module::
 
     ./distribute.sh -m "kivy"
 
+.. warning::
+    Do not run the above command from `within a virtual enviroment <../faq/#too-many-levels-of-symbolic-links>`_.
+
 After a long time, you'll get a "dist/default" directory containing
 all the compiled libraries and a build.py script to package your
 application using thoses libraries.
