General README and deb package building.

Author: raidoz

README.md

@@ -1,2 +1,30 @@
 # go-devparam
-Go library and application for accessing device parameters.
+
+Go library and applications for accessing device parameters using the
+deviceparameters protocol: <https://github.com/thinnect/tos-devparam>.
+
+`deviceparameter`
+A basic utility for dealing with individual nodes and parameters.
+See the [deviceparameter README](cmd/deviceparameter/README.md) for details.
+
+`deviceparameters`
+A utility for dealing with several parameters on multiple nodes.
+See the [deviceparameters README](cmd/deviceparameters/README.md) for details.
+
+# Dependencies
+Go dependencies have been vendored as submodules under the vendor directory.
+
+Building the _deb_ package requires `checkinstall` and `ronn`.
+
+`ronn` can be obtained from <https://github.com/rtomayko/ronn>.
+
+# Building
+
+Check out all submodules, install `ronn` and `checkinstall`.
+
+Enter `cmd/deviceparameter` or `cmd/deviceparameters` and execute `make` or
+enter `cmd` and execute the `build-deb.sh` script.
+
+Both applications can be cross-compiled for Windows and for use on ARM based
+Linux platforms, though packaging only works on the native architecture. Take a
+look at the Makefiles for details.

cmd/Makefile

@@ -0,0 +1,19 @@
+# Makefile for building and installing deviceparameter and deviceparameters
+MAKEFILE_LOCATION := $(patsubst %/,%,$(dir $(abspath $(lastword $(MAKEFILE_LIST)))))
+
+all: deviceparameter deviceparameters
+
+deviceparameter:
+	cd deviceparameter && make clean && make
+
+deviceparameters:
+	cd deviceparameters && make clean && make
+
+install: deviceparameter deviceparameters
+	install -m0755  $(MAKEFILE_LOCATION)/deviceparameter/deviceparameter /usr/bin
+	install -m0664  $(MAKEFILE_LOCATION)/deviceparameter/deviceparameter.1.gz /usr/local/man/man1
+	install -m0755  $(MAKEFILE_LOCATION)/deviceparameters/deviceparameters /usr/bin
+	install -m0664  $(MAKEFILE_LOCATION)/deviceparameters/deviceparameters.1.gz /usr/local/man/man1
+
+.PHONY: deviceparameter
+.PHONY: deviceparameters

cmd/build-deb.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+
+RELEASE_DATE=$(date -u +'%Y%m%d')
+
+OPTIONS+=" --type=debian"
+OPTIONS+=" --default"     # answer yes to any questions
+OPTIONS+=" --fstrans"     # simulate filesystem so root permissions not needed
+OPTIONS+=" --install=no"  # just make, don't install the package
+OPTIONS+=" --nodoc"       # as long as actual docs don't exist
+
+OPTIONS+=" --pkgname=mist-device-parameters"
+OPTIONS+=" --pkgversion=0.1.0"
+OPTIONS+=" --pkgrelease=$RELEASE_DATE"
+OPTIONS+=" --provides=mist-device-parameters"
+OPTIONS+=" --pkglicense=MIT"
+OPTIONS+=" --maintainer=somebody@thinnect.com"
+
+checkinstall $OPTIONS

cmd/description-pak

@@ -0,0 +1 @@
+Mist deviceparameter and deviceparameters.

cmd/deviceparameter/Makefile

@@ -3,7 +3,7 @@
 BUILD_DATE = $(shell date -u '+%Y-%m-%d_%H:%M:%S')
 BUILD_DISTRO = $(shell lsb_release -sd)
 
-all: deviceparameter
+all: deviceparameter manual
 
 win32: export GOOS=windows
 win32: export GOARCH=386
@@ -39,3 +39,9 @@ manual: deviceparameter.1.gz
 install: deviceparameter manual
 	install -m 0755 deviceparameter /usr/local/bin
 	install -m 0644 deviceparameter /usr/local/man/man1
+
+clean:
+	rm -f deviceparameter
+	rm -f deviceparameter.1.gz
+
+.PHONY: clean

cmd/deviceparameters/Makefile

@@ -3,7 +3,7 @@
 BUILD_DATE = $(shell date -u '+%Y-%m-%d_%H:%M:%S')
 BUILD_DISTRO = $(shell lsb_release -sd)
 
-all: deviceparameters
+all: deviceparameters manual
 
 win32: export GOOS=windows
 win32: export GOARCH=386
@@ -39,3 +39,9 @@ manual: deviceparameters.1.gz
 install: deviceparameters manual
 	install -m 0755 deviceparameters /usr/local/bin
 	install -m 0644 deviceparameters /usr/local/man/man1
+
+clean:
+	rm -f deviceparameters
+	rm -f deviceparameters.1.gz
+
+.PHONY: clean