Update README and doxygen configuration

.gitignore

@@ -0,0 +1,7 @@
+/dep/
+/build/
+/build.paho/
+*.swp
+*.pyc
+/doc/MQTTSNClient/
+/doc/MQTTSNPacket/

README.md

@@ -1,18 +1,47 @@
-# Eclipse Paho MQTT-SN Embedded C
+# Eclipse Paho MQTT-SN C/C++ client for Embedded platforms
+
+This repository contains the source code for the [Eclipse Paho](http://eclipse.org/paho) MQTT-SN C/C++ client library for Embedded platorms.
+
+It is dual licensed under the EPL and EDL (see about.html and notice.html for more details).  You can choose which of these licenses you want to use the code under.  The EDL allows you to embed the code into your application, and distribute your application in binary or source form without contributing any of your code, or any changes you make back to Paho.  See the EDL for the exact conditions.
+
+There are three sub-projects:
+
+1. MQTTSNPacket - simple de/serialization of MQTT-SN packets, plus helper functions
+2. MQTTGateway - MQTT-SN transparent gateway - connects MQTT-SN clients with an MQTT server.  See the README within the project for more information.
+3. MQTTSNClient - high(er) level C++ client (not yet complete)
+
+The *MQTTSNPacket* directory contains the lowest level C library with the smallest requirements.  This supplies simple serialization
+and deserialization routines.  They serve as a base for the higher level libraries, but can also be used on their own.
+It is mainly up to you to write and read to and from the network.
+
+The *MQTTSNGateway* directory contains an MQTT-SN to MQTT transparent gateway (see the MQTT-SN specification for a description of that.)  It can
+be used to connect the MQTT-SN client to an MQTT server.
+
+The *MQTTSNClient* directory contains the next level C++ library.  This is intended to mirror the way the MQTTClient works in the Paho embedded
+MQTT project, but it's not yet complete.
+
+## Build requirements / compilation
+
+CMake builds for MQTTSNPacket with a Makefile for MQTTSNGateway have been introduced, along with Travis-CI configuration for automated build & testing.
+
+The travis-build.sh file has the full build and test sequence for Linux.
 
 
-## Project description:
+## Usage and API
 
-The Paho project has been created to provide reliable open-source implementations of open and standard messaging protocols aimed at new, existing, and emerging applications for Machine-to-Machine (M2M) and Internet of Things (IoT).
-Paho reflects the inherent physical and cost constraints of device connectivity. Its objectives include effective levels of decoupling between devices and applications, designed to keep markets open and encourage the rapid growth of scalable Web and Enterprise middleware and applications.
+See the samples directories for examples of intended use.  Doxygen config files are available in the doc directory.
+
+## Runtime tracing
 
 
-## Links
+## Reporting bugs
 
-- Project Website: [https://www.eclipse.org/paho](https://www.eclipse.org/paho)
-- Eclipse Project Information: [https://projects.eclipse.org/projects/iot.paho](https://projects.eclipse.org/projects/iot.paho)
-- Paho MQTT-SN Embedded C Page: [https://www.eclipse.org/paho/clients/c/embedded-sn/](https://www.eclipse.org/paho/clients/c/embedded-sn/)
-- GitHub: [https://github.com/eclipse/paho.mqtt-sn.embedded-c](https://github.com/eclipse/paho.mqtt-sn.embedded-c)
-- Twitter: [@eclipsepaho](https://twitter.com/eclipsepaho)
-- Issues: [https://github.com/eclipse/paho.mqtt-sn.embedded-c/issues](https://github.com/eclipse/paho.mqtt-sn.embedded-c/issues)
-- Mailing-list: [https://dev.eclipse.org/mailman/listinfo/paho-dev](https://dev.eclipse.org/mailman/listinfo/paho-dev)
+This project uses GitHub Issues here: [github.com/eclipse/paho.mqtt-sn.embedded-c/issues](https://github.com/eclipse/paho.mqtt-sn.embedded-c/issues) to track ongoing development and issues.
+
+## More information
+
+Discussion of the Paho clients takes place on the [Eclipse Mattermost Paho channel](https://mattermost.eclipse.org/eclipse/channels/paho) and the [Eclipse paho-dev mailing list](https://dev.eclipse.org/mailman/listinfo/paho-dev).
+
+General questions about the MQTT protocol are discussed in the [MQTT Google Group](https://groups.google.com/forum/?hl=en-US&fromgroups#!forum/mqtt).
+
+More information is available via the [MQTT community](http://mqtt.org).