From a71a5455f604a5e8023d088cda78fc4f3a963c3d Mon Sep 17 00:00:00 2001
From: Mathieu Virbel <mat@pymt.eu>
Date: Thu, 3 Feb 2011 16:02:23 +0100
Subject: [PATCH] fixes quickstart documentation to head over installation/how
 to run app for each platform

---
 doc/sources/guide/installation-macosx.rst |  2 ++
 doc/sources/guide/installation-ubuntu.rst |  6 ++++++
 doc/sources/guide/installation-window.rst |  2 ++
 doc/sources/guide/quickstart.rst          | 25 +++++++++++++++++++++--
 4 files changed, 33 insertions(+), 2 deletions(-)

diff --git a/doc/sources/guide/installation-macosx.rst b/doc/sources/guide/installation-macosx.rst
index b93ab63d2..7c8adca64 100644
--- a/doc/sources/guide/installation-macosx.rst
+++ b/doc/sources/guide/installation-macosx.rst
@@ -30,6 +30,8 @@ Start any Kivy Application
 You can run any Kivy application by simply dragging the application's main file
 onto the Kivy.app icon. Just try with any python file in the examples folder.
 
+.. _macosx-run-app:
+
 Start from Command Line
 -----------------------
 
diff --git a/doc/sources/guide/installation-ubuntu.rst b/doc/sources/guide/installation-ubuntu.rst
index 634f5e779..23b40c584 100644
--- a/doc/sources/guide/installation-ubuntu.rst
+++ b/doc/sources/guide/installation-ubuntu.rst
@@ -15,6 +15,12 @@ If you already installed kivy before, you can upgrade it with::
 
     $ easy_install -U kivy
 
+
+.. _linux-run-app:
+
+Start from Command Line
+-----------------------
+
 You can know run any example from the examples directory of kivy::
 
     $ cd <path to kivy directory>/examples/demo
diff --git a/doc/sources/guide/installation-window.rst b/doc/sources/guide/installation-window.rst
index 36654626e..78beae94f 100644
--- a/doc/sources/guide/installation-window.rst
+++ b/doc/sources/guide/installation-window.rst
@@ -10,6 +10,8 @@ to install anything in "system" wide. Just unzip & run:
        use it for launching any kivy application
 
 
+.. _windows-run-app:
+
 Start any Kivy's application
 ----------------------------
 
diff --git a/doc/sources/guide/quickstart.rst b/doc/sources/guide/quickstart.rst
index 5cf37eebe..062b03bea 100644
--- a/doc/sources/guide/quickstart.rst
+++ b/doc/sources/guide/quickstart.rst
@@ -25,9 +25,30 @@ The base code for creating an application looks like this:
 
     MyApp().run()
 
-Save it as `myapp.py` and run it with your Python interpreter ::
+Save it as `myapp.py`.
 
-    $ python myapp.py
+Now, to run your application, depending of your platform, you can :
+
+    Linux
+        Follow the instructions for :ref:`running Kivy application on Linux <linux-run-app>`::
+
+            $ python myapp.py
+
+    Windows
+        Follow the instructions for :ref:`running Kivy application on Windows <windows-run-app>`::
+            
+            $ python myapp.py
+            # or
+            C:\appdir>kivy.bat myapp.py
+
+    MacOSX
+        Follow the instructions for :ref:`running Kivy application on MacOSX <macosx-run-app>`::
+
+            $ kivy myapp.py
+
+    Android
+        You application need some complementary files to be able to run on Android.
+        See :doc:`android` for more informations.
 
 A window should open, showing a sole button (with the label 'Hello World') that
 covers the entire window's area. That's all there is to it.