Publishing docs to gh-pages instead of locally.

Added a script to generate doxygen docs from within $NUPIC, switch to the gh-pages branch, and publish the docs within that branch.

Added start, stop, restart, status scripts that wrap 'forever'.

Author: rhyolight

bin/generate_nupic_docs.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+
+## Assumptions
+# - NuPIC is checked out somewhere within reach cloned from  
+#   [email protected]:numenta/nupic.git as `origin`.
+# - $NUPIC points to the location of this checkout.
+# - A local `gh-pages` branch exists, tracking the remote 'gh-pages' branch.
+
+echo
+echo "Building NuPIC API docs from $NUPIC"
+echo
+
+if [ -z "$NUPIC" ]; then
+    echo "In order for this script to run properly, you must have the "
+    echo "\$NUPIC environment variable set to the NuPIC checkout."
+    exit 1
+fi
+
+cwd=`pwd`
+cd $NUPIC
+
+echo "Checking out NuPIC master branch for doxygen build..."
+git checkout master
+git pull origin master
+
+echo "Running Doxygen..."
+doxygen
+
+echo "Checking out NuPIC gh-pages branch for documentation push..."
+git checkout gh-pages
+# pull latest changes
+git fetch origin
+git merge origin/gh-pages --no-edit
+# move html directory into right place
+rm -rf docs
+mv html docs
+# add new docs
+git add docs
+# commit new docs
+git commit -m "NuPIC Doxygen automated doc build."
+# push new docs
+git push origin gh-pages
+
+echo "Switching back to NuPIC master branch..."
+git checkout master
+
+echo
+echo Done.
+
+cd $cwd

bin/restart.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+
+script_dir="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+$script_dir/stop.sh
+$script_dir/start.sh

bin/start.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+
+script_dir="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+cwd=`pwd`
+tools_server="${script_dir}/../program.js"
+
+# Forever is a node.js tool used to keep programs running.
+
+echo
+echo "Starting: ${tools_server}"
+forever start $tools_server
+
+echo
+forever list

bin/status.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+# Forever is a node.js tool used to keep programs running.
+forever list

bin/stop.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+# Forever is a node.js tool used to keep programs running.
+forever stopall