From 89ce3fbf62503d7907f2a949a6e42ac06e1d341a Mon Sep 17 00:00:00 2001
From: Ryan Pessa <ryan@essential-elements.net>
Date: Fri, 15 Aug 2014 17:06:21 -0500
Subject: [PATCH] add notes on packaging re py2/py3

---
 doc/sources/guide/packaging-android.rst   | 5 +++++
 doc/sources/guide/packaging-ios.rst       | 4 ++++
 doc/sources/guide/packaging-macosx.rst    | 4 ++++
 doc/sources/guide/packaging-windows.rst   | 4 ++++
 doc/sources/installation/installation.rst | 5 +++++
 5 files changed, 22 insertions(+)

diff --git a/doc/sources/guide/packaging-android.rst b/doc/sources/guide/packaging-android.rst
index f9a885947..63f26836e 100644
--- a/doc/sources/guide/packaging-android.rst
+++ b/doc/sources/guide/packaging-android.rst
@@ -27,6 +27,11 @@ accomplish vibration, sensor access, texting etc. These, along with
 information on debugging on the device, are documented at the
 :doc:`main Android page </guide/android>`.
 
++-------------------------------------------------------------------------------------------------------------------+
+| NOTE: Currently, packages for Android can only be generated with Python 2.7. Python 3.3+ support is on the way... |
++-------------------------------------------------------------------------------------------------------------------+
+
+
 .. _Buildozer:
 
 Buildozer
diff --git a/doc/sources/guide/packaging-ios.rst b/doc/sources/guide/packaging-ios.rst
index eef7aa3ae..3717686e9 100644
--- a/doc/sources/guide/packaging-ios.rst
+++ b/doc/sources/guide/packaging-ios.rst
@@ -18,6 +18,10 @@ The overall process for creating a package for IOS can be explained in 4 steps:
 
 This process has been tested with Xcode 4.2.
 
++---------------------------------------------------------------------------------------------------------------+
+| NOTE: Currently, packages for iOS can only be generated with Python 2.7. Python 3.3+ support is on the way... |
++---------------------------------------------------------------------------------------------------------------+
+
 Prerequisites
 -------------
 
diff --git a/doc/sources/guide/packaging-macosx.rst b/doc/sources/guide/packaging-macosx.rst
index 6d2d82ce7..9fa150ccb 100644
--- a/doc/sources/guide/packaging-macosx.rst
+++ b/doc/sources/guide/packaging-macosx.rst
@@ -8,6 +8,10 @@ MacOSX 10.6, using the portable package of Kivy.
 The package will only work for the 64 bit MacOSX. We no longer support 32 bit
 MacOSX platforms.
 
++---------------------------------------------------------------------------------------------------------------+
+| NOTE: Currently, packages for OSX can only be generated with Python 2.7. Python 3.3+ support is on the way... |
++---------------------------------------------------------------------------------------------------------------+
+
 .. _mac_osx_requirements:
 
 Requirements
diff --git a/doc/sources/guide/packaging-windows.rst b/doc/sources/guide/packaging-windows.rst
index 1ae660ebb..c2ad8ae3b 100644
--- a/doc/sources/guide/packaging-windows.rst
+++ b/doc/sources/guide/packaging-windows.rst
@@ -8,6 +8,10 @@ package of Kivy.
 The package will be either 32 or 64 bits depending on which version of Python
 you ran it with.
 
++-------------------------------------------------------------------------------------------------------------------+
+| NOTE: Currently, packages for Windows can only be generated with Python 2.7. Python 3.3+ support is on the way... |
++-------------------------------------------------------------------------------------------------------------------+
+
 .. _packaging-windows-requirements:
 
 Requirements
diff --git a/doc/sources/installation/installation.rst b/doc/sources/installation/installation.rst
index 04555c08e..e7a874ba6 100755
--- a/doc/sources/installation/installation.rst
+++ b/doc/sources/installation/installation.rst
@@ -20,6 +20,11 @@ be available. For these, we recommend `Pygame <http://pygame.org>`_, `Gst-Python
 <http://www.gstreamer.net/modules/gst-python.html>`_ and `Enchant
 <http://www.rfk.id.au/software/pyenchant/>`_, respectively.
 
++--------------------------------------------------------------------------------------------------------------------------+
+| NOTE: Currently, packaging only works with Python 2.7. We are working on Python 3.3+ support, but for now if you plan to |
+| distribute your package on any platform you should use Python 2.7.                                                       |
++--------------------------------------------------------------------------------------------------------------------------+
+
 Other optional libraries (mutually independent) are:
 
     * `OpenCV 2.0 <http://sourceforge.net/projects/opencvlibrary/>`_ -- Camera input.