added new README
authorKevron Rees <tripzero.kev@gmail.com>
Mon, 12 Jan 2015 07:10:04 +0000 (23:10 -0800)
committerKevron Rees <tripzero.kev@gmail.com>
Mon, 12 Jan 2015 07:10:04 +0000 (23:10 -0800)
README [deleted file]
README.md [new file with mode: 0644]

diff --git a/README b/README
deleted file mode 100644 (file)
index 9091660..0000000
--- a/README
+++ /dev/null
@@ -1,80 +0,0 @@
-Automotive Message Broker is a vehicle network abstraction system.  It brokers information from the vehicle
-to applications.  It provides application with a rich API for accessing vehicle data.
-
-Automotive Message Broker is built using CMake and requires libltdl (libtool), libjson-c, and boost packages.  
-
-
-About the Git Tree:
-master is expected to be unstable and may not even compile.  If you want something more stable, checkout one of the 
-release branches (ie, 0.9.0, 0.10, etc)
-
-
-To build:
-
-cd automotive-message-broker
-mkdir build
-cd build
-cmake ..
-make
-
-To install:
-
-sudo make install
-
-To run:
-
-ambd
-
-ambd can load different plugins.  The config file specifies what plugins to use.  The default config located in
-/etc/ambd/config.  You can change this or use your own config to have ambd use your own plugins.  For example:
-
-# copy the config to your own config
-cp /etc/ambd/config myconfig
-
-# edit myconfig and specify the path to your plugin:
-# change the line: 
-"sources" : [ { "path" : "../plugins/examplesourceplugin.so" } ],
-# to:
-"sources" : [ { "path" : "/path/to/mysourceplugin.so" } ],
-
-Now you can run ambd with:
-
-ambd -c /path/to/myconfig
-
-also see ambd -h
-
-Typically, AMB will be used with the DBus plugin.  The DBus plugin automatically makes internal AMB properties 
-available over DBus.  See the DBus plugin documentation for more information (plugins/dbus/README).
-
-
-Running with other plugins
-
-To learn about running AMB with other plugins, please see the plugins/*/README.  
-
-
-Running with the Qt mainloop:
-
-Some source and sink plugins may want to use the Qt-based mainloop to take advantage of Qt features. To enable
-the Qt mainloop, run cmake with -Duse_qtcore=On:
-
-cmake .. -Dqtmainloop=On
-
-You will also need to edit your config to enable the Qt-based mainloop:
-
-{
-       "mainloop" : "/usr/lib/automotive-message-broker/qtmainloopplugin.so",
-       "sources" : [...],
-       "sinks" : [...]
-}
-
-NOTE: by default the glib mainloop will be used.
-
-
-
-Questions/Issues/Comments:
-
-Questions or Comments can be emailed to:
-tripzero.kev@gmail.com
-
-Issues can be submitted on our github page:
-https://github.com/otcshare/automotive-message-broker/issues
diff --git a/README.md b/README.md
new file mode 100644 (file)
index 0000000..8de7054
--- /dev/null
+++ b/README.md
@@ -0,0 +1,76 @@
+# Automotive Message Broker
+
+Version 0.13.801
+
+## Introduction
+
+Automotive Message Broker is a vehicle network abstraction system.  It brokers information from the vehicle
+to applications.  It provides application with a rich API for accessing vehicle data.
+
+Automotive Message Broker is built using CMake and requires libltdl (libtool), libjson-c, and boost packages.
+
+## Git
+About the Git Tree:
+master is expected to be unstable and may not even compile.  If you want something more stable, checkout one of the
+release branches (ie, 0.9.0, 0.10, etc)
+
+## Building
+
+To build:
+
+~~~~~~~~~~~~~{.bash}
+cd automotive-message-broker
+mkdir build
+cd build
+cmake ..
+make
+~~~~~~~~~~~~~
+
+## Installing
+
+To install:
+
+~~~~~~~~~~~~~{.bash}
+sudo make install
+~~~~~~~~~~~~~
+
+## Running
+To run:
+
+~~~~~~~~~~~~~{.bash}
+ambd
+~~~~~~~~~~~~~
+
+*also see **ambd -h** for additional command line options*
+
+## Configuration
+
+For information on ambd's configuration, please see ambd-configuration.idl.
+
+## Running with the Qt mainloop:
+
+Some source and sink plugins may want to use the Qt-based mainloop to take advantage of Qt features. To enable
+the Qt mainloop, run cmake with -Duse_qtcore=On:
+
+~~~~~~~~~~~~~{.bash}
+cmake .. -Dqtmainloop=On
+~~~~~~~~~~~~~
+
+You will also need to edit your config to enable the Qt-based mainloop:
+
+~~~~~~~~~~~~~{.json}
+{
+       "mainloop" : "/usr/lib/x86_64-linux-gnu/automotive-message-broker/qtmainloopplugin.so",
+       "plugins" : "/etc/ambd/plugins.d"
+}
+~~~~~~~~~~~~~
+
+NOTE: by default the glib mainloop will be used.
+
+## Questions/Issues/Comments:
+
+Questions or Comments can be emailed to the amb mailing list:
+**amb at lists.01.org**
+
+Issues and Feature requests can be submitted on our github page:
+https://github.com/otcshare/automotive-message-broker/issues