raspberry_pi.md: fixed Raspberry Pi model 2 pin mapping docs
[contrib/mraa.git] / docs / debugging.md
index d05d78f..26f5b2e 100644 (file)
@@ -1,30 +1,31 @@
 Debugging libmraa                         {#debugging}
 =================
 
-This page contains a few debugging tip, when filing an issue please go through
-this list as if you don't it's the first thing we'll have to ask you to do.
+This page contains a few debugging tip. When filing an issue please go through
+this list as it's the first thing we'll ask you to do.
 
-### Version
+### Finding your mraa version
 
 Getting the exact version of libmraa you're running is really important to us.
 The best way to get this is to call mraa_get_version() or mraa.getVersion(). If
 mraa returns x.x.x-dirty then your version was not built from a git tree or you
 built out of tree (see our building doc) - or you don't have git installed.
 
-### Syslog
+### Finding error logs
 
-mraa logs pretty much everything that goes wrong to syslog, these days it'll go
-to the systemd journal usually so check with `sudo journalctl -f` whilst
-running your app or check all libmraa messages with `journalctl -t libmraa`.
-Grab all the messages from the initialisation message right up to your last
-one, using a pastebin is always a good idea, I like dpaste.com. If your system
-does not have systemd likely your log is in /var/log/messages or similar.
+mraa logs pretty much everything that goes wrong to syslog. These days it'll go
+to the systemd journal so check with `sudo journalctl -f` whilst running your
+app or check all libmraa messages with `journalctl -t libmraa`.  Grab all the
+messages from the initialisation message right up to your last one. Using a
+pastebin is always a good idea, I like dpaste.com. If your system does not have
+systemd likely your log is in /var/log/messages or a similar location.
 
-### Common Errors
+### Common errors to check for
 
 * Not running as root
-* Incorrect IO numbers, mraa uses physical connector pin numbering see your
-  platform doc for details
-* Unsuported platform
-* Using the wrong pin, check pin capabilities
+* Incorrect IO pin numbers, mraa uses physical connector pin numbering see your
+  platform documentation for details
+* Your platform is unsupported
+* Using the wrong pin, check pin capabilities either using the API or your
+  platform documentation