[CB-1759] fix up the doc


Started with a bug requiring a small change, blossomed
into a bit more general cleanup.
diff --git a/weinre.doc/ChangeLog.body.html b/weinre.doc/ChangeLog.body.html
index f1bd9b9..202d397 100644
--- a/weinre.doc/ChangeLog.body.html
+++ b/weinre.doc/ChangeLog.body.html
@@ -48,6 +48,7 @@
 <li><a href="https://issues.apache.org/jira/browse/CB-873">CB-873</a>  - setTimeout() and setInterval() usage with string arguments is busted
 <li><a href="https://issues.apache.org/jira/browse/CB-984">CB-984</a>  - cannot install weinre with Node 0.8.0
 <li><a href="https://issues.apache.org/jira/browse/CB-1666">CB-1666</a> - "INVALID_STATE_ERR: DOM Exception 11" with chbrody/Cordova-SQLitePlugin
+<li><a href="https://issues.apache.org/jira/browse/CB-1759">CB-1759</a> - doc indicates that you should launch weinre with a command prefix of `node`
 <!-- ======================================================================= -->
diff --git a/weinre.doc/Home.body.html b/weinre.doc/Home.body.html
index 1edcae4..cb3cf6a 100644
--- a/weinre.doc/Home.body.html
+++ b/weinre.doc/Home.body.html
@@ -57,10 +57,10 @@
 <td><a href="https://github.com/apache/incubator-cordova-weinre">https://github.com/apache/incubator-cordova-weinre</a>
 <tr><td>mailing lists at Apache:
-<td><a href="http://incubator.apache.org/cordova/#mailing-list">http://incubator.apache.org/cordova/#mailing-list</a> (use callback-dev)
+<td><a href="http://incubator.apache.org/cordova/#mailing-list">http://incubator.apache.org/cordova/#mailing-list</a> (for weinre development)
 <tr><td>discussion at Google Group:
-<td><a href="http://groups.google.com/group/weinre">http://groups.google.com/group/weinre</a>
+<td><a href="http://groups.google.com/group/weinre">http://groups.google.com/group/weinre</a> (for weinre usage)
diff --git a/weinre.doc/Installing.body.html b/weinre.doc/Installing.body.html
index d004010..3d635af 100644
--- a/weinre.doc/Installing.body.html
+++ b/weinre.doc/Installing.body.html
@@ -17,39 +17,50 @@
  * under the License.
-<p><span class="weinre">weinre</span> is shipped as binary packages
-available at Apache.
+<p><span class="weinre">weinre</span> is implemented as a
+<a href="http://nodejs.org/">node.js</a> application, and so you'll
+need to <a href="http://nodejs.org/download/">download and install
+a node runtime</a> to run <span class="weinre">weinre</span>.
-<p>To install <span class="weinre">weinre</span>, download a <tt>bin</tt> package, unarchive
-to wherever you'd wish.  <span class="weinre">weinre</span> is not
-sensitive to the directory it's installed in, and does not 
+<p>To install <span class="weinre">weinre</span>, use <tt>npm</tt>,
+or download a binary package. <span class="weinre">weinre</span> is not
+sensitive to the directory it's installed in, and does not
 write to any files.
 <!-- ======================================================================= -->
 <h2>npm installation</h2>
-<p><span class="weinre">weinre</span> can be installed as an 
+<p><span class="weinre">weinre</span> can be installed as an
 <a href="http://npmjs.org/doc/README.html">npm package</a>.  The
-<tt>*-bin.tar.gz</tt> urls/files can be used as a target of the 
+<tt>*-bin.tar.gz</tt> urls/files for binary packages
+can be used as a target of the
 <a href="http://npmjs.org/doc/install.html"><tt>npm install</tt></a>
-command.  For example, use the following command to install 
-<span class="weinre">weinre</span> locally, from this example URL:
+<p>It's likely you will want to install <span class="weinre">weinre</span>
+globally instead of locally (in the <tt>npm</tt> sense), which means you
+will typically want to use the <tt>npm -g</tt> option to install.  For
+*ix and Mac, this also means prefixing your command with sudo.  For Windows,
+AFAIK, you don't need sudo or any equivalent.
+<p>Here's an example of installing from a binary package via URL:
-npm install http://example.com/path/to/apache-cordova-weinre-X.Y.Z-bin.tar.gz
+sudo npm -g install http://example.com/path/to/apache-cordova-weinre-X.Y.Z-bin.tar.gz
-<p>weinre is also deployed on
-<a href="http://search.npmjs.org/#/weinre">http://search.npmjs.org/#/weinre</a>
+<p><span class="weinre">weinre</span> is also deployed on
+<a href="https://npmjs.org/package/weinre">https://npmjs.org/package/weinre</a>
 so that you can install it via:
-npm install weinre
+sudo npm -g install weinre
 <!-- ======================================================================= -->
 <h2>Binary Packages</h2>
 <p>The recent source and binary release archives should be available at:
@@ -65,6 +76,7 @@
 <br><b><i>(at the time of this writing, that link does not actually resolve because
 there are no official releases)</i></b>
 <p>Unofficial binary packages for your convenience:
diff --git a/weinre.doc/Running.body.html b/weinre.doc/Running.body.html
index 6c2f228..cc80795 100644
--- a/weinre.doc/Running.body.html
+++ b/weinre.doc/Running.body.html
@@ -62,15 +62,18 @@
 to function as a <b>Debug Target</b>.
 <!-- ======================================================== -->
-<h2>Running the debug server using the weinre-node distribution</h2>
+<h2>Running the debug server using an <tt>npm</tt> installation</h2>
-<p>To run <span class="weinre">weinre</span> from the weinre-node distribution,
-execute the following command:
+<p>To run <span class="weinre">weinre</span> from an <tt>npm</tt>
+installation, assuming you've installed it globally (in the <tt>npm</tt>
+sense), execute the following command:
-node path-to-weinre-node/weinre [options]
+weinre [options]
+<p>The server will run until you kill it.  Control-C will do the job.
 <p>Options available are:
 <ul class="spaced no-bullet">
@@ -139,12 +142,18 @@
+<!-- ======================================================== -->
+<h2>The <tt>~/.weinre/server.properties</tt> file</h2>
 <p>You may also create a file named
 <tt>server.properties</tt> in the
 directory <tt>.weinre</tt> in your
 home directory (eg.
-The keys should be
+Your home directory is the determined by the value of either the
+<tt>HOME</tt> or <tt>USERPROFILE</tt> environment variable.
+<p>The keys should be
 the same as the name of the options above,
 with the same values.
@@ -162,8 +171,6 @@
 <p>Command-line options override the options specified in the
 <tt>~/.weinre/server.properties</tt> file.
-<p>The server will run until you kill it.  Control-C will do the job.
 <!-- ======================================================== -->
 <h2>Running the debug server bound to something other than <tt>localhost</tt></h3>
diff --git a/weinre.doc/boilerplate-header.html.txt b/weinre.doc/boilerplate-header.html.txt
index e93d93b..b33bec7 100644
--- a/weinre.doc/boilerplate-header.html.txt
+++ b/weinre.doc/boilerplate-header.html.txt
@@ -28,9 +28,9 @@
-<a class="no-decoration" href="https://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre.git"><div class="ribbon">clone weinre at apache</div></a>
+<div class="ribbon">clone weinre at
+<a href="https://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre.git">apache</a>
 <!-- ======================================================================= -->
 <h1 class="page-title">weinre - @PAGE_NAME@</h1>
diff --git a/weinre.doc/css/main.css b/weinre.doc/css/main.css
index 8e4078d..fa2db24 100644
--- a/weinre.doc/css/main.css
+++ b/weinre.doc/css/main.css
@@ -26,13 +26,13 @@
 .ribbon {
     position:               absolute;
     top:                    0;
-    left:                   0;
-    border-right:           thin solid #000;
+    right:                  0;
+    border-left:            thin solid #000;
     border-bottom:          thin solid #000;
-    -moz-border-radius-bottomright:     0.5em;
-    -webkit-border-bottom-right-radius: 0.5em;
+    -moz-border-radius-bottomleft:     0.5em;
+    -webkit-border-bottom-left-radius: 0.5em;
     padding:                0.25em 0.5em;
-    background-color:       #FF0;
+    background-color:       #FF8;
     font-style:             italic;
     -webkit-box-shadow:     5px 5px 15px #888;
     -moz-box-shadow:        5px 5px 15px #888;