QTWRTCS/README

Create Nokia Widget
(c) 2010 by Samuel Kobelkowsky - yalla ya!  
samuel@yalla-ya.com

This code allows you to easily create a Nokia WRT Widget using SVN repository. The idea is to allow a group
of users to commit changes to a widget and have a widget created instantly. If the widget is visible in a 
webserver directory, you can point your phone web browser (or better, create a bookmark in the home screen) 
and download the widget any time a new version is created.

This simplifies enourmously the process of testing a widget.

How to use:

1. Copy the local-svn-update and create-nokia-widget2 to the /usr/local/bin directory and give execution
   permissions to both.
2. Create a SVN repository for your widget (using svnadmin tool). A directory will be created, containing the 
   following subdirectories and files: conf, dav, db, format, hooks, locks and README.txt
3. Go to the hooks directory and create the post-commit file. (Don't get confused with post-commit.tmpl. It 
   is just a template, we don't want the .tmpl extension). It should have the following contents. 
   Replace WWWREPOS, WIDGET and MAILTO as you need:

      #!/bin/bash
      PATH=/bin:/usr/bin

      # Path in the host where the local copy in the SVN server is
      WWWREPOS=/path/to/your/local/copy

      # Filename, including path, of the wgz file
      WIDGET=/filename/of/the/widget.wgz

      # Email to send a report of this transaction. Can contain several address,
      # comma separated
      MAILTO=yourname@example.com

      /usr/local/bin/local-svn-update $1 $2 $WWWREPOS $MAILTO
      
      /usr/local/bin/create-nokia-widget2 $WWWREPOS $WIDGET

4. Give execution permissions to the post-commit file.
5. Now, whenever you commit a change to your code, a widget will be created!