Filling in more documentation omissions

inclement · inclement · commit 568160fb58d3 · 2015-10-03T17:50:06.000+01:00
diff --git a/doc/source/index.rst b/doc/source/index.rst
@@ -7,24 +7,21 @@ installed, or uploaded to marketplaces such as the Play Store
 just like any other Androip app. This tool was originally developed
 for the Kivy cross-platform graphical framework, but now supports
 multiple bootstraps and can be easily extended to package other types
-of Python app.
+of Python app for Android.
 
 python-for-android supports two major operations; first, it can
 compile the Python interpreter, its dependencies, backend libraries
 and python code for Android devices. This stage is fully customisable,
-you can install as many or few components as you like. Only the
-compilation step is carried out, so the result is a standalone Android
-project which can be used to generate any number of different APKs,
-even with different names, icons, Python code etc.
-
+you can install as many or few components as you like.  The result is
+a standalone Android project which can be used to generate any number
+of different APKs, even with different names, icons, Python code etc.
 The second function of python-for-android is to provide a simple
-interface to these distributions. You don't have to compile your own,
-but can download precompiled versions to package your Python code on
-almost any platform including Windows, Linux, and OS X.
+interface to these distributions, to generate from such a project a
+Python APK with build parameters and Python code to taste.
 
-See the quickstart etc.
 
-Contents:
+Contents
+========
 
 .. toctree::
    :maxdepth: 2
diff --git a/doc/source/troubleshooting.rst b/doc/source/troubleshooting.rst
@@ -2,6 +2,18 @@
 Troubleshooting
 ===============
 
+Debug output
+------------
+
+Add the ``--verbose`` option to any python-for-android command to see
+full debug output including the output of all the external tools used
+in the compilation and packaging steps.
+
+If reporting a problem by email or irc, it is usually helpful to
+include this full log, via e.g. a `pastebin
+<http://paste.ubuntu.com/>` or `Github gist
+<https://gist.github.com/>`.
+
 Getting help
 ------------
 
