X-Git-Url: http://git.rot13.org/?a=blobdiff_plain;f=README;h=14d7b0e48adcf346e0d52d1b3c67ca47814e40f5;hb=4c26ead649e3118c016577279ed1fec491cca453;hp=e43c0d75a8ae1f365242f470146168b97f5c4ab1;hpb=3ada104973c8a698bafa8c071cf1f46b4d410e7e;p=MojoFacets.git

diff --git a/README b/README
index e43c0d7..14d7b0e 100644
--- a/README
+++ b/README
@@ -15,14 +15,69 @@ we all read as single data set, allowing easy analysys of search results, for ex
 
 Start with:
 
-  LANG=hr_HR.utf8 ./script/mojo_facets daemon --reload
+    LANG=hr_HR.utf8 ./script/mojo_facets daemon --reload
+
+
+Changing tabular data:
+
+Just double click on any table cell and click outside or focus out to save change.
+
+
+Data action and changes:
+
+There are two kinds of audit log in MojoFacets:
+
+1. actions stored in /tmp/actions are clicks on user interface with parameters,
+   they will probably be erased on next reboot since they are in /tmp
+
+2. changes in data/database.changes are more structured, including old value
+   and unique identifiers for that row
+
+Changes can be applied on any dataset currently in memory.
+
+Whole idea of changes is to create audit log which is detailed enough to recostruct
+current state of dataset from source file and list of changes. However, to speed
+up operations, you can periodically save your in-memory data to /tmp/ in perl
+storeable format using save link in interface.
 
 
 Data replication:
 
-  # master
-  ./script/mojo_facets daemon --listen 'http://*:4444' --reload
+Actions can be replicated to other hosts using MASTER enviroment variable
+or config menu
+
+    # slave
+    MASTER=http://localhost:4444 ./script/mojo_facets daemon --reload
+
+
+Code console to modify data using perl snippets:
+
+Experimental REPL console supports perl snippets which get $row hash which is one
+element from your dataset.
+
+If you want to create or update values, you will have to use $update hash to set
+new values.
+
+If you want to report something from your dataset (also called reduce in map/reduce
+terminology) you can use $out hash to store values which will be used to generate
+new dataset using $key and $value for column names.
+
+All values are repetable, but if you create just a scalar, magic(tm) inside MojoFacets
+will try to upgrade it to [ $scalar ] so you don't have to do it explicitly.
+
+Code examples are stored in public/code
+
+They use column1,column2.description.pl notatition so only snippets which have applicable
+column will be shown.
+
+
+Export data:
+
+All exported data is stored in public/export/database/
+
+There you can find saved filters and items generated with export checkbox
+
+    filter.column_name.optional_description
+	items.column1.column2.column3
 
-  # slave
-  MASTER=http://localhost:4444 ./script/mojo_facets daemon --reload