X-Git-Url: http://jsfdemo.indexdata.com/?a=blobdiff_plain;f=README;h=96bd7ef3ee421b5c7fed0133235fcfe9d2c80867;hb=f774dad47ebce13e0bd13a461ce1765d1b7d0f96;hp=3144b20785c8655a592f3023684a13c9804a2ac6;hpb=ecfec1648acd77e8364bd1fd22d206bed9df0e9c;p=mkws-moved-to-github.git

diff --git a/README b/README
index 3144b20..96bd7ef 100644
--- a/README
+++ b/README
@@ -3,42 +3,50 @@ OVERVIEW
 
 The MasterKey Widget Set, or MKWS, provides HTML/JS/CSS widgets that
 can be dropped into ANY website, irrespective of CMS or lack thereof,
-to enable MasterKey searching.
+to enable MasterKey searching. See the contents of the "doc" directory
+for further documentation.
 
 
 WHAT'S WHAT
 ===========
 
 README   -- this file
+LICENSE  -- The GNU LGPL (Lesser General Public Licence)
 Makefile -- delegates to tools/htdocs/Makefile
+src      -- source-code that is compiled into the tools area
 tools 	 -- the tools that make up the Widget Set
 examples -- examples of applications that use MKWS
-
+doc      -- documentation (in Markdown, compiles to HTML)
+test     -- regression-testing scripts
 notes    -- internal documents, not for customers
 
 
 Required devel tools
 ====================
 
-On debian, you will need:
-$ sudo apt-get install curl git-core pandoc yui-compressor node-js libbsd-resource-perl
+If you are building the widget set, as opposed to just using it, you
+will need the following Debian packages (or their equivalents on your
+operating system):
+
+$ sudo apt-get install curl git pandoc yui-compressor libbsd-resource-perl
 
-On Debian 7 (wheezy), you do not need git-core, plain git will do, but
-you probably have that on a development box already. Unfortunately, node-js
-is not available for wheezy. Either you can get it from wheezy-backports,
-or you can download the source from http://nodejs.org/download/ and build
-it yourself. Looks like you need node and npm, make install puts them
-into /usr/local/bin.
+You also need Node.js, but unfortunately the node-js package is not
+available for Debian wheezy. You can either get it from
+wheezy-backports or download the source from
+http://nodejs.org/download/ and build it yourself. You need node and
+npm, its package manager: make install puts them into /usr/local/bin.
 
 To compile the default templates you'll need to install the stable version
-of Handlebars. Currently it's at 1.3.0 and available by npm:
+of Handlebars. Currently it's at 2.0.0 and available by npm:
 
-  npm install handlebars@1.3.0 -g
+  npm install handlebars@2.0.0 -g
 
 For apache setup, see tools/apache2/README
 
+
 NEWS
-=========
+====
 
 see tools/htdocs/NEWS
 
+