rsence 2.0.0.10.pre → 2.0.0.11

data/.yardopts

@@ -0,0 +1,10 @@
+  bin/rsence
+  lib/rsence.rb
+  lib/**/*.rb
+  plugins/**/*.rb
+  --no-private
+  --hide-void-return
+  --exclude lib/util/ruby19_fixes.rb
+  --exclude lib/http/rackup.rb
+  - conf/default_*.yaml INSTALL.rdoc LICENSE.txt VERSION
+    docs/*.rdoc

data/INSTALL.rdoc

@@ -1,46 +1,41 @@
-= Installation
+= Install Guide
 
 If you already have a working ruby environment and know what to do, the easiest way is just:
 
- gem install rsence --pre
-
+ gem install rsence
 
 Otherwise, follow these instructions:
 
 
 == 1. System Dependencies
 
-This is a list of system level dependencies. You only need to do this step once.
+This is a list of system level dependencies. You only need to do this step once; follow the steps of for your target operating system.
 
 === 1.1. Mac OS X
 
-This applies to all version of Mac OS X
+==== 1.1.1 Mac OS X 10.6
 
-* Install a recent version of *XCode* from http://developer.apple.com/mac/ to install the essential development tools.
-* Install the most recent version of *MacPorts* from http://www.macports.org/
-* Proceed with step 1.1.1. *or* 1.1.2. according to your version of Mac OS X
+* Install *XCode*[http://developer.apple.com/mac/] to get the essential development tools, like compilers.
+* Proceed to section 3.0
 
-==== 1.1.1. Mac OS X 10.4 and 10.5
+==== 1.1.2. Mac OS X 10.4 and 10.5
 
-This step applies only to Mac OS X 10.4 Tiger and 10.5 Leopard. The bundled ruby build of these versions of Mac OS X is somewhat broken.
+This step applies only to Mac OS X 10.4 "Tiger" and 10.5 "Leopard". The default ruby build of these versions of Mac OS X is somewhat broken.
 
+* Install *XCode*[http://developer.apple.com/mac/] to get the essential development tools, like compilers.
+* Install *MacPorts*[http://www.macports.org/]
 * Install the ruby and rb-rubygems packages using Terminal like this:
-
-  sudo port install ruby
-  sudo port install rb-rubygems
-
-==== 1.1.2 Mac OS X 10.6
-
-RSence works out-of-the box in Mac OS X 10.6 Snow Leopard.
+    sudo port install ruby
+    sudo port install rb-rubygems
+* Proceed to section 3.0
 
 === 1.2. Debian and Ubuntu Linux
 
 This step applies only to Debian, Ubuntu and similar Linux distributions.
 
 * Install these packages:
-
-  sudo apt-get install build-essential ruby-full rubygems rake
-
+    sudo apt-get install build-essential ruby-full rubygems rake
+* Proceed to section 3.0
 
 === 1.3. Microsoft Windows
 
@@ -55,19 +50,17 @@ Windows compatibility has been officially tested on Windows XP SP3 and Windows 7
     * Associate .rb and .rbw files with this Ruby installation
 * Download and Install the Development Kit from http://rubyinstaller.org/download.html
   * Extract the included directories into the directory where you installed ruby.
-    * It's C:\ruby by default.
+    * It's +C:\ruby+ by default.
 
 ==== 1.3.2. Install RSence
 * In the command prompt, run:
     gem update --system
-    gem install rsence --pre
+    gem install rsence
     rsence help
 
 ==== 1.3.3. Create RSence environment
 
-This assumes you have \my_projects directory.
-Also, the 'my_project' project directory is just for illustration purposes.
-Use something else instead of those.
+Replace the +\my_projects+ path with the path to the directory where you want to run or develop your projects. Likewise, replace +my_project+ with something descriptive for your project.
 
 * In the command prompt, run:
     cd \my_projects
@@ -76,20 +69,21 @@ Use something else instead of those.
 * In the command prompt, run:
     rsence run my_project
 * Open your web browser in the address as configured.
-  * If the address is 0.0.0.0, ether 127.0.0.1 instead.
-  * Using just defaults, the following url should work: http://127.0.0.1:8001/
+  * If the address is +0.0.0.0+, enter +127.0.0.1+ instead.
+  * Using just defaults, the following URL should work: http://127.0.0.1:8001
 
 ==== 1.3.4. Windows limitations
 If you install the sqlite dll and the sqlite3-ruby gem, you'll gain persistent sessions and this warning message will disappear:
-  Warning: Session database is not available. Can't use persistent sessions
-It's not, however, depended on in the default install, because it's not strictly required and makes the first installation much easier. Also, you can use any other database supported by Sequel instead of Sqlite.
+`Warning: Session database is not available. Can't use persistent sessions`
+
+It's not a dependency in the default install, because it's not strictly required and makes the first installation much easier. Also, you can use any other database supported by Sequel instead of Sqlite.
 
-Backgrounding is not yet implemented, because POSIX signals are not fully implemented in windows and backgrounding requires some windows service hooks.
+Backgrounding on Windows is not yet implemented, because POSIX signals are not fully implemented in windows and backgrounding requires some Windows-specific service hooks.
 
-However, if you run RSence under Cygwin, everything should work like on a unix machines.
+However, if you run RSence under Cygwin, everything should work like on a UNIX machines.
 
 
-=== 1.99. Other UNIX / Linux systems:
+=== 1.4. Other UNIX / Linux systems:
 
 This step applies to systems not listed above.
 
@@ -97,72 +91,44 @@ You'll have to figure out how to install the dependencies on your own, but gener
 
 * Ruby
   * Version 1.8.7 or newer
-  * http://ruby-lang.org/
+  * http://ruby-lang.org
 * RubyGems
   * Ruby package manager
 * A standard set of compilers and build tools to build the gems with C extensions.
   * gcc, make etc.
 
 
-== 2. Ruby Dependencies
+== 2. Ruby Library Dependencies
 
-The 'rsence' gem depends on the dummy 'rsence-deps' gem, which depends on all essential dependencies of RSence.
-Optionally, you probably want at a database and a database adapter supported by Sequel: http://sequel.rubyforge.org/
+The `rsence` gem depends on the dummy `rsence-deps` gem, which depends on all essential dependencies of RSence.
+Optionally, you probably want at a database and a database adapter supported by Sequel[http://sequel.rubyforge.org]
 This not only enables SessionStorage (persistent sessions between RSence restarts), but some plugins written for RSence depend on at least Sqlite.
 
-=== 2.1 Detailed list of ruby dependencies
+=== 2.1 Detailed list of ruby libraries used
 
-* *rake*
+* *rake*[http://rake.rubyforge.org]
   * Ruby build tool
   * Not necessarily required via ruby gems, if installed via a system-level package
-  * http://rake.rubyforge.org/
-* *rack*
+* *rack*[http://rack.rubyforge.org]
   * Abstract ruby web server interface
-  * http://rack.rubyforge.org/
-  * Additionally, you need a rack handler, one of the following is suggested:
-    * *unicorn*
-      * Suggested for production deployment
-      * Use Apache, Nginx or similar front-ends for virtual hosts, SSL and such.
-      * http://unicorn.bogomips.org/
-    * *mongrel*
-      * Suggested for development use.
-      * Solid
-      * Pretty fast
-      * Reliable
-      * http://github.com/fauna/mongrel
-    * *thin*
-      * Quick
-      * Not as stable or reliable as mongrel (not at least yet)
-      * http://code.macournoyer.com/thin/
-    * *webrick*
-      * No installation needed, part of the standard library
-      * Very slow
-      * Use as last resort
-* *json*
-  * Library for JSON - Ruby - JSON object conversion.
-  * http://flori.github.com/json/
-  * http://json.org/
-* *yaml*
-  * Library for handling YAML files
-  * Part of the standard library of Ruby 1.9 and newer
-  * http://yaml4r.sourceforge.net/doc/
-  * http://www.yaml.org/
-* *jsmin_c*
-  * Javascript whitespace removal library
-* *jscompress*
-  * Javascript compression and obfuscation library
-* *html_min*
-  * HTML whitespace removal library
-* *cssmin*
-  * CSS whitespace removal library
-* *sequel*
-  * http://www.sequel.org/
-  * Additionally, you need a sequel driver for your database
-    * *sqlite3-ruby*
-      * Lightweight SQL library
-    * Other database adapters compatible with sequel are fine. Just configure your setup accordingly.
-* *highline*
-  * Used by the initenv command.
+  * A rack handler is also required. One of the following is suggested:
+    * *unicorn*[http://unicorn.bogomips.org] :: Suggested for production deployment. Use Apache, Nginx or similar front-ends for virtual hosts, SSL and such.
+    * *mongrel*[http://github.com/fauna/mongrel] :: Suggested for development use, also works for production when combined with a front-end proxy for virtual hosts etc.
+    * *thin*[http://code.macournoyer.com/thin] ::  Alternative for development use.
+    * *webrick*:: Bundled with ruby (no installation required). Very slow; use as last resort
+* *json*[http://flori.github.com/json]:: Library for bi-directional JSON[http://json.org] conversion.
+* *yaml*[http://yaml4r.sourceforge.net/doc]:: Library for handling YAML[http://www.yaml.org] files
+* *randgen*:: C-optimized random string generator developed for RSence specifically
+* *jsmin_c*:: C-optimized Javascript whitespace removal library; Ruby wrapper developed for RSence specifically; based on the original JSMin[http://www.crockford.com/javascript/jsmin.html]
+* *jscompress*:: C-optimized Javascript compression and obfuscation library developed for RSence specifically
+* *html_min*:: C-optimized HTML whitespace removal library developed for RSence specfically
+* *cssmin*:: CSS whitespace removal library
+* *sequel*[http://www.sequel.org]
+  * Generic SQL database ORM
+  * A Sequel driver for your preferred database is also needed:
+    * *sqlite3-ruby*:: SQLite[http://www.sqlite.org] is a light-weight SQL library. Recommended for development and small projects.
+    * Other database adapters compatible with Sequel are fine. Just configure RSence accordingly.
+* *highline*:: Console-based menu prompt system by the initenv command.
 * rmagick
   * Optional, but suggested, because RSence has RMagick -savvy features, like serving RMagick objects using tickets that are rendered only when requested.
   * Some plugins depend on it directly.
@@ -181,7 +147,7 @@ Even if RubyGems is up-to-date, ensure your installed gems are up-to-date, some
 === 3.1. Install RSence
 
 This will install RSence via RubyGems, the preferred method. All dependencies are installed too, except for the ones you already might have installed.
-  gem install rsence --pre
+  gem install rsence
 
 Optionally, you might want to contribute to RSence development, just clone or fork the GIT repository on Github:
   * http://github.com/rsence/rsence

data/README.rdoc

@@ -1,73 +1,76 @@
 
-= RSence 2.0.0.x.pre                                                       2010-??-??
-
-http://rsence.org/
+= RSence-2.0.0[http://rsence.org/]
 
 == Introduction
 
-RSence is a RIA framework designed for responsive GUI applications on the web.
-
-RSence is a flexible and high-performance RIA framework aimed on building responsive, scalable and over-all as high-performance GUI Applications as possible with the chosen technologies.
-
-RSence includes a server for backend tasks and client suppert as well as a Javascript GUI framework to provide responsive user interfaces.
+RSence is a RIA framework designed for responsive GUI applications on the web; it's implemented as a hybrid Ruby - Javascript system. The server is written in Ruby and C. Applications are installed as plugin bundles. The GUI framework is written in Javascript; it doesn't strictly require the server, but has extensive transport support with automatic data synchronization with the server. User interfaces are usually described in structured view trees represented by YAML data structures, which are automatically converted for rendering in the client. 
 
-The purpose of the server is to provide a highly optimized yet easy to use Ruby framework for writing applications containing all their assets needed as self-contained plugins bundles. The bundles enable easy distribution and maintenance of RSence projects.
+Javascript knowledge is required only when creating custom client-driven functionality; basic understanding of the YAML GUITree structures is enough in most cases. Likewise, no Ruby knowledge is needed if you want to create stand-alone Javascript applitations. Javascript component themes are easily created with just basic web designer skills. Data API's are easy to link no matter what language is used to create them. Skills in your organization are easily combined for various parts of larger applications.
 
-RSence is not primarily targeted as an engine for plain old html web sites, there are plenty of other tools for that purpose and some of them are easily integrated into RSence.
+RSence is not primarily targeted as an engine for plain old html web sites, there are plenty of other tools for that purpose and RSence is easily integrated with them in various ways.
 
 
-== Installation (pre-release):
+== Installing
+Just run this command in the shell, if you have ruby installed. Otherwise, read the {file:INSTALL Install Guide} for full installation instructions.
+ gem install rsence
 
- gem install rsence --pre
 
-== Setting up a project
+== Initializing a new project
 
- rsence initenv /path/of/project
+The +initenv+ command will cretate a directory called `env_dir` in this example. It asks a few questions about the environment. Use a path and project name that matches your purposes.
+ rsence initenv /home/me/rsence_projects/env_dir
 
-== Project anatomy:
 
-The expected structure of a project environment (where 'project_directory'
-is the directory of your project) is:
+== Project environment structure
 
-  [dir]   project_directory   :: The directory of your project.
-    [dir]   conf              :: The directory of config files.
-      [file]  config.yaml     :: The config file to load by default.
-    [dir]   var               :: Directory containing various runtime files.
-      [dir]  run              :: Directory containing PID files.
-      [dir]  log              :: Directory containing log files.
-      [dir]  db               :: Directory containing database files.
-    [dir]   plugins           :: Directory containing installed plugins.
+==== The basic structure of a project environment (where `env_dir` is the directory of your project) is:
 
-The 'config.yaml' file contains patches specific to your project.
+*dir* :: +env_dir/+ :: The environment directory of your project.
+*file* :: +env_dir/conf/config.yaml+ :: The configuration file to load by default. It extends the {file:default_conf default configuration}.
+*dir* :: +env_dir/run/+ :: This default directory for runtime files, like the PID file of the running rsence instance.
+*dir* :: +env_dir/log/+ :: The default directory for log files. +rsence.stderr+ contains error output of the RSence server daemon and installed plugins, including warnings. +rsence.stdout+ contains the standard output of the RSence server daemon and installed plugins.
+*dir* :: +env_dir/db/+ :: The default directory for database files. +ses.db+ is the standard SQLite session database, if enabled.
+*dir* :: +env_dir/plugins/+ :: The default directory for installed plugin bundles. A newly initialized environment includes the +welcome+ plugin. Feel free to remove it.
+*file* :: +env_dir/VERSION+ :: The version of RSence used to initialize the environment. Reserved for future upgrade usage.
+*file* :: +env_dir/README+ :: A README file template. Describes what the `env_dir` is about. Edit it to match your project.
 
+=== Configuration file loading order
 The configuration files are loaded and applied in this order:
-  1:  [rsence_install_path]/conf/default_conf.yaml
-  2:  [rsence_install_path]/conf/local_conf.yaml
-  3:  /etc/rsence/config.yaml
-  4:  ~/.rsence/config.yaml
-  5:  [project_directory]/conf/config.yaml
-  6:  Any files given using --conf parameters, in order of occurrence.
- 
-The plugins directory contains the plugins installed in the project.
+1.  *rsence_gem_path*/conf/default_conf.yaml
+2.  *rsence_gem_path*/conf/local_conf.yaml
+3.  /etc/rsence/config.yaml
+4.  ~/.rsence/config.yaml
+5.  *env_dir*/conf/config.yaml
+6.  Any files given using +--conf+ arguments, in order of occurrence.
+
+Use the additional configuration files to match system- or user-specific configurations that are common for all projects.
 
 == Running a project
 
-Each command-line tool command takes a number of options, the path defaults to the current working directory.
+Each command-line tool command takes a number of options, the +env_dir+ argument defaults to the current working directory, otherwise specify the relative or full path to your project environment.
+
+==== Some common options are:
++-a+:: Automatic updates. RSence reloads automatically changed plugin bundles and client libraries.
++-f+:: Doesn't redirect the standard output into a log file. Useful for development when combined with the +run+ command.
++-d+:: Debug mode. Like +-a+ but much more verbose and doesn't obfuscate client data.
 
-=== Starting RSence in foreground
-  rsence run /path/of/project
+=== Running RSence in foreground
+  rsence run [options] [env_dir]
 
 === Starting the RSence daemon
-  rsence start /path/of/project
+  rsence start [options] [env_dir]
 
 === Stopping the RSence daemon
-  rsence stop /path/of/project
+  rsence stop [options] [env_dir]
 
 === Restarting the RSence daemon
-  rsence restart /path/of/project
+  rsence restart [options] [env_dir]
 
 === Checking if project is running
-  rsence status /path/of/project
+  rsence status [options] [env_dir]
+
+=== Example:
+  rsence run -af /home/me/projects/hello_world
 
 == RSence command-line tool help
 
@@ -77,19 +80,19 @@ Each command-line tool command takes a number of options, the path defaults to t
 === Getting detailed help of a command
   rsence help <command>
 
-Example:
+=== Example:
 
   rsence help run
 
 
-For more detailed installation and usage instructions, read the INSTALL.rdoc document.
+For more detailed installation and usage instructions, read the {file:INSTALL Install Guide} document.
 
-=== Licensing:
-* Free: *GPL*
-* Alternative licensing queries for commercial interests are available via http://riassence.com/ and sales@riassence.com
+=== Licensing and commercial support options
+* {file:LICENSE.txt *GPL*} version 3 by default.
+* Riassence[http://riassence.com/] Inc. provides commercial support, custom licensing arrangements and various other services.
 
-=== Community support:
-* Web: http://rsence.org/
-* IRC chat: #rsence on the IRCNet and FreeNode networks
+=== Community support
+* http://rsence.org
+* IRC channel +#rsence+ on the IRCNet and FreeNode networks
 
 

data/VERSION

@@ -1 +1 @@
-2.0.0.10.pre
+2.0.0.11

data/bin/rsence

@@ -1,5 +1,4 @@
 #!/usr/bin/env ruby
-#--
 ##   RSence
  #   Copyright 2010 Riassence Inc.
  #   http://riassence.com/
@@ -7,19 +6,18 @@
  #   You should have received a copy of the GNU General Public License along
  #   with this software package. If not, contact licensing@riassence.com
  ##
- #++
+
 
 require 'profile' if ARGV.include?('--profile')
 
-## Auto-construct paths using this file as the waypoint
+# @private  Auto-construct paths using this file as the waypoint
 SERVER_PATH = File.split( File.expand_path(File.dirname(__FILE__)) )[0]
 
-## Include server & lib in the search path
+# Include server & lib in the search path
 $LOAD_PATH << SERVER_PATH
 $LOAD_PATH << File.join( SERVER_PATH, 'lib' )
 
-# Requires the ARGVParser that functions as the command-line user interface.
-require 'conf/argv'
+require 'rsence'
 
 # Start RSence, if the command supplied was one of the ones
 # triggering a start and the environment is ok.

data/conf/default_conf.yaml

@@ -1,336 +1,345 @@
-
-#### Server configuration
-#
-# The :base_url specifies the prefix for all default http responders.
-:base_url: '/'
-#
-# This setting defines if requests should be gzip-compressed or not.
-# This is a trade-off between cpu cycles used and network bandwidth used.
-# It's generally a good idea to leave it as false (gzipping enabled).
-:no_gzip: false
-#
-# Enabling this appends all msg.reply call output to stdout
-:trace: false
-#
-# The settings for the index_html plugin
-:index_html:
-  #
-  # HTML template file path relative to the plugin dir
-  :index_tmpl: 'tmpl/index.html'
-  #
-  # The index.html page <title>
-  :title: 'RSence'
-  #  
-  :noscript: '<h1>Sorry!</h1><p>This site requires a Javascript -capable web browser.</p><p>Please enable Javascript or upgrade your browser.</p>'
-  #
-  :instance: null
+  #### Server configuration
   #
-  # A list of javascript dependencies to include in the html
-  :deps: [ ]
-#
-# The settings for the main plugin
-:main_plugin:
+  # The :base_url specifies the prefix for all default http responders.
+  :base_url: '/'
   #
-  # The background color of the web page when loading is done
-  :bg_color:            '#ffffff'
-  #
-  # how many milliseconds to wait before doing an idle poll
-  :server_poll_interval: 2000 # 2 seconds
-#
-# Switches on debug-mode:
-#  - Generates more output
-#  - Each time /hello is post-requested:
-#    - Plugins are reloaded from source 
-#    - GZFiles are reloaded (if more recent than in memory)
-:debug_mode: false
-#
-# Web server-related settings:
-:http_server:
+  # This setting defines if requests should be gzip-compressed or not.
+  # This is a trade-off between cpu cycles used and network bandwidth used.
+  # It's generally a good idea to leave it as false (gzipping enabled).
+  :no_gzip: false
   #
-  # Simulate network latency. Good for testing how your
-  # app behaves with laggy connections.
-  :latency: 0
+  # Enabling this appends all msg.reply call output to stdout
+  :trace: false
   #
-  # HTTP Port number to listen to.
-  :port:  8001
+  # The settings for the index_html plugin
+  :index_html:
+    #
+    # HTML template file path relative to the plugin dir
+    :index_tmpl: 'tmpl/index.html'
+    #
+    # The index.html page <title>
+    :title: 'RSence'
+    #  
+    :noscript: '<h1>Sorry!</h1><p>This site requires a Javascript -capable web browser.</p><p>Please enable Javascript or upgrade your browser.</p>'
+    #
+    :instance: null
+    #
+    # A list of javascript dependencies to include in the html
+    :deps: [ ]
   #
-  # Bind this ip address ('0.0.0.0' means all)
-  :bind_address:  '0.0.0.0'
+  # The settings for the main plugin
+  :main_plugin:
+    #
+    # The background color of the web page when loading is done
+    :bg_color:            '#ffffff'
+    #
+    # how many milliseconds to wait before doing an idle poll
+    :server_poll_interval: 2000 # 2 seconds
   #
-  # Rack handler to use, defaults to thin
-  :rack_require: mongrel
-#
-# When enabled, sets http cache headers
-# to cache content as long as possible.
-:cache_maximize: true
-#
-# When :cache_maximize is enabled,
-# this is the time (in seconds) the cached
-# content will expire in
-:cache_expire: 14515200 # 6 months
-#
-# Paths to scan for available plugins
-:plugin_paths: [ ]
-#
-# List of files that include strings
-:string_files: [
-  "conf/default_strings.yaml"
-]
-#
-# Transporter settings:
-:transporter_conf:
+  # Switches on debug-mode:
+  #  - Generates more output
+  #  - Each time /hello is post-requested:
+  #    - Plugins are reloaded from source 
+  #    - GZFiles are reloaded (if more recent than in memory)
+  :debug_mode: false
   #
-  # The HApplication priority of the client, when actively polling.
-  :client_poll_priority: 60
-#
-#
-# Session-related settings
-:session_conf:
+  # Web server-related settings:
+  :http_server:
+    #
+    # Simulate network latency. Good for testing how your
+    # app behaves with laggy connections.
+    :latency: 0
+    #
+    # HTTP Port number to listen to.
+    :port:  8001
+    #
+    # Bind this ip address ('0.0.0.0' means all)
+    :bind_address:  '0.0.0.0'
+    #
+    # Rack handler to use, defaults to thin
+    :rack_require: mongrel
   #
-  # Enable cookie-based sessions
-  :session_cookies: true
+  # When enabled, sets http cache headers
+  # to cache content as long as possible.
+  :cache_maximize: true
   #
-  # Trusting the cookies means ignoring the client protocol session key exchange.
-  # Enabled by default, because in most cases, extreme security measures aren't necessary
-  # and the drawback of having an invalid session because a tcp packet got lost isn't
-  # tolerable as a default setting.
-  :trust_cookies: true
+  # When :cache_maximize is enabled,
+  # this is the time (in seconds) the cached
+  # content will expire in
+  :cache_expire: 14515200 # 6 months
   #
-  # The comment string in the session cookie
-  :ses_cookie_comment: "RSence Session Key"
+  # Paths to scan for available plugins
+  :plugin_paths: [ ]
   #
-  # Disposable keys. When enabled, runs in a more secure way and changes the session key on each xhr.
-  :disposable_keys:    true
+  # List of files that include strings
+  :string_files: [
+    "conf/default_strings.yaml"
+  ]
   #
-  # Timeout controls how long a session is valid
-  :timeout_secs:       900 # 15 minutes
+  # Transporter settings:
+  :transporter_conf:
+    #
+    # The HApplication priority of the client, when actively polling.
+    :client_poll_priority: 60
   #
-  # Key length controls the length of the random-part of the key.
-  :key_length:   12
   #
-  # Cookie keys are this many times longer than xhr keys
-  :cookie_key_multiplier: 2
+  # Session-related settings
+  :session_conf:
+    #
+    # Enable cookie-based sessions
+    :session_cookies: true
+    #
+    # Trusting the cookies means ignoring the client protocol session key exchange.
+    # Enabled by default, because in most cases, extreme security measures aren't necessary
+    # and the drawback of having an invalid session because a tcp packet got lost isn't
+    # tolerable as a default setting.
+    :trust_cookies: true
+    #
+    # The comment string in the session cookie
+    :ses_cookie_comment: "RSence Session Key"
+    #
+    # Disposable keys. When enabled, runs in a more secure way and changes the session key on each xhr.
+    :disposable_keys:    true
+    #
+    # Timeout controls how long a session is valid
+    :timeout_secs:       900 # 15 minutes
+    #
+    # Key length controls the length of the random-part of the key.
+    :key_length:   12
+    #
+    # Cookie keys are this many times longer than xhr keys
+    :cookie_key_multiplier: 2
+    #
+    #
+    # When enabled, deletes all old sessions upon server startup.
+    # If the --reset-sessions command-line switch is provided,
+    # switches this one to true.
+    :reset_sessions: false
+    #
+    # When this is enabled, multiple sessions are allowed for each client
+    # When it's enabled, the old session is left intact and a new one is
+    # created by making a clone of the last session.
+    # If enabled, also check the maximum number of clones allowed in
+    # :session_cookie_max_clones
+    # Defaults to false, will be the default in a future version.
+    :clone_cookie_sessions: true
+    #
+    # This limits the amount of cloned targets of a source session.
+    # NOTE: This has no effect yet, the code is not implemented.
+    :max_cloned_sessions: 10
+    #
+    # This option overrides the default session timeout.
+    # Don't set this to less than the expected poll interval,
+    # otherwise the session might expire before the previous
+    # (cloned) session re-connects the next time.
+    # A safe value for a 60 second poll interval is 120 (default).
+    :cloned_session_expires_in: 120
+    #
+    # Message strings
+    :messages:
+      #
+      # if the session is invalid for one reason or another, display this:
+      :invalid_session:
+        :title: 'Invalid Session'
+        :descr: 'Your session is invalid. Please reload the page to continue.'
+        :uri:    '/'
   #
+  # Database configuration
+  :database:
+    # Session database storage string. Leave empty here to enable the wizard for storage.
+    :ses_db: 'sqlite://db/ses.db'
+
   #
-  # When enabled, deletes all old sessions upon server startup.
-  # If the --reset-sessions command-line switch is provided,
-  # switches this one to true.
-  :reset_sessions: false
+  # ValueManager settings
+  :values_conf:
+    # Key length controls the length of the random-part of the key.
+    :key_length:    8
+    #
+    # Disposable keys, when enabled, changes the value id on each session restoration
+    :disposable_keys:   true
   #
-  # When this is enabled, multiple sessions are allowed for each client
-  # When it's enabled, the old session is left intact and a new one is
-  # created by making a clone of the last session.
-  # If enabled, also check the maximum number of clones allowed in
-  # :session_cookie_max_clones
-  # Defaults to false, will be the default in a future version.
-  :clone_cookie_sessions: true
+  # Daemon helper files, leave empty for defaults.
+  :daemon: {
+    #:pid_fn: /var/run/rsence.pid
+    #:log_fn: /var/log/rsence.log
+  }
   #
-  # This limits the amount of cloned targets of a source session.
-  # NOTE: This has no effect yet, the code is not implemented.
-  :max_cloned_sessions: 10
+  # Entered by code, empty container
+  :broker_urls: { }
+
+
+  #### Client package build configuration
   #
-  # This option overrides the default session timeout.
-  # Don't set this to less than the expected poll interval,
-  # otherwise the session might expire before the previous
-  # (cloned) session re-connects the next time.
-  # A safe value for a 60 second poll interval is 120 (default).
-  :cloned_session_expires_in: 120
   #
-  # Message strings
-  :messages:
-    #
-    # if the session is invalid for one reason or another, display this:
-    :invalid_session:
-      :title: 'Invalid Session'
-      :descr: 'Your session is invalid. Please reload the page to continue.'
-      :uri:    '/'
-#
-# Database configuration
-:database:
-  # Session database storage string. Leave empty here to enable the wizard for storage.
-  :ses_db: 'sqlite://db/ses.db'
+  :client_pkg:
 
-#
-# ValueManager settings
-:values_conf:
-  # Key length controls the length of the random-part of the key.
-  :key_length:    8
-  #
-  # Disposable keys, when enabled, changes the value id on each session restoration
-  :disposable_keys:   true
-#
-# Daemon helper files, leave empty for defaults.
-:daemon: {
-  #:pid_fn: /var/run/rsence.pid
-  #:log_fn: /var/log/rsence.log
-}
-#
-# Entered by code, empty container
-:broker_urls: { }
+    # Source directories to scan
+    :src_dirs: []
 
+      # RSence Client Framework
+      #- js
 
-#### Client package build configuration
-#
-#
-:client_pkg:
-  
-  # Source directories to scan
-  :src_dirs: []
-    
-    # RSence Client Framework
-    #- js
-    
-    # How to include your own custom js package directory:
-    # - /home/me/code/extra_components
-  
-  # List of theme names to include and pack
-  :theme_names:
-    - default  # Makes default_theme.js containing css and html templates
-    - bright   # Makes bright_theme.js containing css and html templates
-  
-  # List of packages to build
-  :packages:
-    
-    # The core package, loaded by default using index_html
-    core:
-      - class             # HClass
-      - elem              # ELEM
-      - event             # EVENT
-      - sha               # SHAClass
-      - system            # HSystem
-      - valueresponder    # HValueResponder
-      - application       # HApplication
-      - comm              # COMM
-      - queue             # COMM.Queue
-      - session           # COMM.Session
-      - transporter       # COMM.Transporter
-      - sessionwatcher    # COMM.SessionWatcher
-      - urlresponder      # COMM.URLResponder
-      - autosync          # ( automatic sync setup )
-      - values            # COMM.Values
-      - value             # HValue
-      - jsloader          # COMM.JSLoader
-      - json_renderer     # COMM.JSONRenderer
-      - valuematrix       # HValueMatrixInterface & HValueMatrix
-      - point             # HPoint
-      - rect              # HRect
-      - thememanager      # HThemeManager
-      - markupview        # HMarkupView
-      - morphanimation    # HMorphAnimation
-      - viewdefaults      # HViewDefaults
-      - view              # HView
-      - eventresponder    # HEventResponder
-      - dummyvalue        # HDummyValue
-      - controldefaults   # HControlDefaults
-      - control           # HControl
-      - dyncontrol        # HDynControl
-      - centerview        # HCenterView
-      - scrollview        # HScrollView
-      - inlineview        # HInlineView
-    
-    # The default collection of simple control widgets (components)
-    controls:
-      - button            # HButton & HClickValueButton
-      - checkbox          # HCheckbox
-      - radiobutton       # HRadioButton
-      - stringview        # HStringView
-      - textcontrol       # HTextControl
-      - passwordcontrol   # HPasswordControl
-      - textarea          # HTextArea
-      - uploader          # HUploader
-      - slider            # HSlider
-      - vslider           # HVSlider
-      - progressbar       # HProgressBar
-      - progressindicator # HProgressIndicator
-      - imageview         # HImageView
-      - stepper           # HStepper
-      - validatorview     # HValidatorView
-      - window            # HWindow
-      - tab               # HTab & HTabView & HTabItem
-      - sheet             # HSheet
-      - alert_sheet       # HAlertSheet
-      - confirm_sheet     # HConfirmSheet
-    
-    # Server error message application ( the Reload / Reset Session dialog )
-    servermessage:
-      - reloadapp # ReloadApp
-    
-    # Special package for Internet Explorer 6.0
-    iefix:
-      - iefix
-    
-    # Date and time -related control widgets (components)
-    # These are not complete; they are still under development
-    # and will be included in the controls package when finalized.
-    datetime:
-      - datetimevalue       # HDateTime
-      - calendar            # HCalendar
-      - timesheet           # HTimeSheet
-      - timesheet_item      # HTimeSheetItem
-      - timesheet_item_edit # HTimeSheetItemEditor
-    
-    # List related control widgets (components)
-    # These are not complete; they are still under development
-    # and will be included in the controls package when finalized.
-    lists:
-      - listitems           # HListItems
-      - checkboxlist        # HCheckboxList
-      - radiobuttonlist     # HRadiobuttonList
-  
-  # Special packages that include other packages (not used currently)
-  :compound_packages:
-    allinone:
-      - core
-      - iefix
-      - default_theme
-      - bright_theme
-      - controls
-      - lists
-      - datetime
-  
-  # List of variables and other names beginning
-  # with a underscore that should not be obfuscated
-  :reserved_names:
-    - _ID
-    - _WIDTH
-    - _width
-    - _HEIGHT
-    - _height
-    - _
-  
-  # List of file extensions considered graphics image types.
-  # Used for theme graphics inclusion.
-  :gfx_formats:
-    - .jpg
-    - .gif
-    - .png
-    - .swf
-    - .svg
-    - .pdf
-  
-  # The name of the include file
-  :js_inc: js.inc
-  
-  # If disabled, makes packages out of single source bundles automatically
-  :dont_pack_undefined: true
+      # How to include your own custom js package directory:
+      # - /home/me/code/extra_components
+
+    # List of theme names to include and pack
+    :theme_names:
+      - default  # Makes default_theme.js containing css and html templates
+      - bright   # Makes bright_theme.js containing css and html templates
+
+    # List of packages to build
+    :packages:
+
+      # The core package, loaded by default using a script tag in index_html
+      core:
   
-  # Replacement prefix for obfuscated names
-  :repl_prefix: _
+        # RSence.*
+        - rsence_ns
   
-  # If enabled, doesn't obfuscate code (useful for debugging)
-  :no_obfuscation: false
+        # RSence.Core
+        - class             # HClass
+        - elem              # ELEM
+        - event             # Event
   
-  # If enabled, doesn't remove whitespace (useful for debugging)
-  :no_whitespace_removal: false
+        # RSence.Util
+        - sha               # SHA
   
-  # If enabled, doesn't make gzipped packages
-  :no_gzip: false
+        # RSence.Foundation
+        - system            # HSystem
+        - valueresponder    # HValueResponder
+        - application       # HApplication
   
-  # The strategy for gzip, a number between 0 and 9
-  #  - 0 means largest size, but fast compression
-  #  - 9 means smallest size, but slow compression
-  #  - any number in between is a compromise
-  :gz_strategy: 9
+        # COMM
+        - comm              # COMM
+        - queue             # COMM.Queue
+        - session           # COMM.Session
+        - transporter       # COMM.Transporter
+        - sessionwatcher    # COMM.SessionWatcher
+        - urlresponder      # COMM.URLResponder
+        - autosync          # ( automatic sync setup )
+        - values            # COMM.Values
+        - value             # HValue
+        - jsloader          # COMM.JSLoader
+        - json_renderer     # COMM.JSONRenderer
+        - valuematrix       # HValueMatrixInterface & HValueMatrix
+        - point             # HPoint
+        - rect              # HRect
+        - thememanager      # HThemeManager
+        - markupview        # HMarkupView
+        - morphanimation    # HMorphAnimation
+        - viewdefaults      # HViewDefaults
+        - view              # HView
+        - eventresponder    # HEventResponder
+        - dummyvalue        # HDummyValue
+        - eventmanager      # EVENT
+        - controldefaults   # HControlDefaults
+        - control           # HControl
+        - dyncontrol        # HDynControl
+        - centerview        # HCenterView
+        - scrollview        # HScrollView
+        - inlineview        # HInlineView
+
+      # The default collection of simple control widgets (components)
+      controls:
+        - button            # HButton & HClickValueButton
+        - checkbox          # HCheckbox
+        - radiobutton       # HRadioButton
+        - stringview        # HStringView
+        - textcontrol       # HTextControl
+        - passwordcontrol   # HPasswordControl
+        - textarea          # HTextArea
+        - uploader          # HUploader
+        - slider            # HSlider
+        - vslider           # HVSlider
+        - progressbar       # HProgressBar
+        - progressindicator # HProgressIndicator
+        - imageview         # HImageView
+        - stepper           # HStepper
+        - validatorview     # HValidatorView
+        - window            # HWindow
+        - tab               # HTab & HTabView & HTabItem
+        - sheet             # HSheet
+        - alert_sheet       # HAlertSheet
+        - confirm_sheet     # HConfirmSheet
+
+      # Server error message application ( the Reload / Reset Session dialog )
+      servermessage:
+        - reloadapp # ReloadApp
+
+      # Special package for Internet Explorer 6.0
+      iefix:
+        - iefix
+
+      # Date and time -related control widgets (components)
+      # These are not complete; they are still under development
+      # and will be included in the controls package when finalized.
+      datetime:
+        - datetimevalue       # HDateTime
+        - calendar            # HCalendar
+        - timesheet           # HTimeSheet
+        - timesheet_item      # HTimeSheetItem
+        - timesheet_item_edit # HTimeSheetItemEditor
+
+      # List related control widgets (components)
+      # These are not complete; they are still under development
+      # and will be included in the controls package when finalized.
+      lists:
+        - listitems           # HListItems
+        - checkboxlist        # HCheckboxList
+        - radiobuttonlist     # HRadiobuttonList
+
+    # Special packages that include other packages (not used currently)
+    :compound_packages:
+      allinone:
+        - core
+        - default_theme
+        - controls
+        - lists
+        - datetime
+
+    # List of variables and other names beginning
+    # with a underscore that should not be obfuscated
+    :reserved_names:
+      - _ID
+      - _WIDTH
+      - _width
+      - _HEIGHT
+      - _height
+      - _
+
+    # List of file extensions considered graphics image types.
+    # Used for theme graphics inclusion.
+    :gfx_formats:
+      - .jpg
+      - .gif
+      - .png
+      - .swf
+      - .svg
+      - .pdf
+
+    # The name of the include file
+    :js_inc: js.inc
+
+    # If disabled, makes packages out of single source bundles automatically
+    :dont_pack_undefined: true
+
+    # Replacement prefix for obfuscated names
+    :repl_prefix: _
+
+    # If enabled, doesn't obfuscate code (useful for debugging)
+    :no_obfuscation: false
+
+    # If enabled, doesn't remove whitespace (useful for debugging)
+    :no_whitespace_removal: false
+
+    # If enabled, doesn't make gzipped packages
+    :no_gzip: false
+
+    # The strategy for gzip, a number between 0 and 9
+    #  - 0 means largest size, but fast compression
+    #  - 9 means smallest size, but slow compression
+    #  - any number in between is a compromise
+    :gz_strategy: 9