rsence 2.0.9.22.pre → 2.0.9.23

data/VERSION

@@ -1 +1 @@
-2.0.9.22.pre
+2.0.9.23

data/js/foundation/eventmanager/eventmanager.js

@@ -711,13 +711,6 @@ EVENT = {
         _stopEvent--;
       }
     }
-    // Stop the event only when we are hovering over some control, allows normal DOM events to co-exist.
-    if (_this.enableDroppableChecks) {
-      if ((_stopEvent === 0) && (_this.hovered.length !== 0) && _newActiveControl) {
-        Event.stop(e);
-      }
-    }
-    //if(_this.hovered.length!==0){Event.stop(e);}
     return true;
   },
 

data/js/lists/listitems/listitems.js

@@ -66,6 +66,10 @@ HListItems = HValueResponder.extend({
           }
           _listItems.push( [_value, _label] );
         }
+        // Arrays as-is
+        else if ( _rowType == 'a' ){
+          _listItems.push( _row );
+        }
         // strings and integers
         else if ( ['s','n'].indexOf(_rowType) !== -1 ){
           _label = _row.toString();

data/js/util/reloadapp/reloadapp.js

@@ -99,7 +99,7 @@ ReloadApp = HApplication.extend({
         _this.setStyle('color','#000');
         _this.setStyle('font-size','13px');
         ELEM.setCSS(_alertIcon,'position:absolute;left:8px;top:8px;width:48px;height:48px;background-image:url('+_iconUrl+');');
-        ELEM.setCSS(_alertTitle,'position:absolute;left:64px;top:8px;width:300px;height:24px;line-height:24px;vertical-align:middle;text-align:center;font-weight:bold;overflow:hidden;text-overflow:ellipsis;line-wrap:nowrap;');
+        ELEM.setCSS(_alertTitle,'position:absolute;left:64px;top:8px;width:300px;height:24px;line-height:24px;vertical-align:middle;text-align:center;font-weight:bold;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;');
         ELEM.setHTML(_alertTitle,_this.app._title);
         ELEM.setCSS(_alertMessage,'position:absolute;left:64px;top:42px;width:332px;height:186px;border-bottom:1px dotted #999;line-height:17px;vertical-align:middle;overflow:auto;');
         ELEM.setHTML(_alertMessage,_this.app._message);

data/setup/welcome/gui/welcome.yaml

@@ -1,19 +1,34 @@
+# RSence user interfaces can be defined as YAML files.
+# The structure is converted to JSON for the client and "special" variables are processed by the server.
+# The server tries to find a match in its gui_params for all values that begin with a colon (they are parsed as symbols on ruby).
+
+# Read more about YAML on http://yaml.org/
+
+# GUITree is used as the type identifier for user interface definition structures.
 type: GUITree
+# The version defines what version of the structure is used. New features are added constantly, each incrementing the version by 0.1
 version: 0.6
 
+# List of javascript packages the user interface needs. These are automatically loaded once per session.
 dependencies:
-  - default_theme
-  - controls
+  - default_theme # The default_theme package contains all the theme resources needed when using the default theme.
+  - controls      # The controls package contains the basic set of widget components.
 
+# The root level class for user interfaces must be an instance of HApplication (RSence.GUIApp is extended from the HApplication class).
 class: RSence.GUIApp
+# Each class takes a number of options for its constructor.
 options:
   title: Welcome App
-  priority: 20
+# The subviews use the class defined above as their parent component.
 subviews:
+  # The sheet is used as the main visual container for the gui in this app.
+  # HSheet is an component that dims the background and shows a dialog sheet while its value is 0.
   - class: HSheet
-    rect: [ 0, 0, 600, 500 ]
-    bind: :values.close
-    extend:
+    rect: [ 0, 0, 600, 500 ] # For HSheet, the rect defines the inner dialog size (it's always centered).
+    bind: :values.close      # Values are bound to their component responders using the bind keyword.
+    extend:                  # The extend keyword takes a dictionary of properties to extend the class with.
+      # Extending refreshValue with a javascript function that terminates its application,
+      # including all the subviews. It's triggered when the value becomes 1, when the Close button is clicked.
       refreshValue: |
         function(){
           this.base();
@@ -21,20 +36,38 @@ subviews:
             this.app.die();
           }
         }
+    # Subviews of the HSheet, nested visual-logical structure.
     subviews:
+      # A button in the lower right corner of the HSheet that triggers destruction of this GUITree (see the extension of HSheet above)
+      - class: HClickButton
+        rect: [ null, null, 60, 24, 8, 8 ]
+        bind: :values.close
+        options:
+          label: Close
+      # A checkbox in the lower right corner of the HSheet that triggers an server action to disable the whole plugin when combined with the close button's value.
+      - class: HCheckbox
+        rect: [ null, null, 130, 24, 74, 8 ]
+        bind: :values.dont_show_again
+        options:
+          label: Don't show again
+      # The HScrollView contains a number of subviews that are inside its scrollbars (if the inner content area is bigger than the outer dimensions of HScrollView itself).
       - class: HScrollView
-        rect: [ 0, 0, 550, 300, 0, 42 ]
+        rect: [ 0, 0, 550, 300, 0, 42 ] # This rectangle stretches the component to contain all of the parent's space except the bottom-most 42 pixels.
         options:
-          scrollX: false
-          scrollY: auto
-          style:
+          scrollX: false # Disables horizontal scroll bars.
+          scrollY: auto  # Makes vertical scroll bars appear automatically when needed.
+          style: # Custom styling using style properties. There are several ways to display nested arrays. This is one:
             - [ 'background-color', 'white' ]
             - [ 'border-bottom', '1px solid black' ]
+        # Subviews of the HScrollView; items inside are displayed inside the scrollbars.
         subviews:
+          # The RSence logo image:
           - class: HImageView
             rect: [ 18, 10, 559, 110 ]
             options:
+              # Images use the value as the URL of the image.
               value: http://rsence.org/rsence_org_logo.gif
+          # A plain view containing a hyperlink, positioned in the right bottom corner of the logo image.
           - class: HView
             rect: [ null, 95, 310, 25, 35, null ]
             options:
@@ -42,13 +75,14 @@ subviews:
                 <i style="font-family:Helvetica,Arial,sans-serif;font-size:16px;">
                   <a style="color:#28c;font-weight:bold" href="http://rsence.org/">http://www.rsence.org/</a>
                 </i>
-              style:
+              style: # Another way to define nested arrays for the style:
                 - - text-align
                   - right
+          # The HInlineView is a simple HTML container, designed to contain "flowing layout" html.
           - class: HInlineView
             rect: [ 0, 0, null, null, 0, 0 ]
             options:
-              html: :text.welcome
+              html: :text.welcome # See the gui_params method of welcome.rb to understand how the contents of the text/welcome.html files is linked like this.
               style:
                 - - font-family
                   - 'Helvetica, Arial, sans-serif'
@@ -56,13 +90,3 @@ subviews:
                   - 16px
                 - - line-height
                   - 20px
-      - class: HClickValueButton
-        rect: [ null, null, 60, 24, 8, 8 ]
-        bind: :values.close
-        options:
-          label: Close
-      - class: HCheckbox
-        rect: [ null, null, 130, 24, 74, 8 ]
-        bind: :values.dont_show_again
-        options:
-          label: Don't show again

data/setup/welcome/info.yaml

@@ -3,7 +3,7 @@
 title: Welcome message
 
 # The human-readable version of the package
-version: 1.0.0
+version: 1.0.1
 
 # A brief description of the package (rdoc formatting supported)
 description: |
@@ -11,6 +11,3 @@ description: |
   environments, when the rsence initenv in executed.
   You may safely remove this plugin bundle.
 
-# System version requirement.
-sys_version: '>= 2.0.0'
-

data/setup/welcome/text/welcome.html

@@ -1,3 +1,4 @@
+<!-- This data is included in the gui/welcome.yaml via the gui_params method in the welcome.rb file. -->
 <div style="margin-left:40px;margin-top:140px;margin-right:20px">
 <h1>Congratulations!</h1>
 <p>This message is served to you by RSence running in your new environment.</p>
@@ -5,4 +6,4 @@
 <p>Use the <code>rsence help</code> command to learn more about the <code>rsence</code> command-line tool and its various commands and options.</p>
 <p>You may want to install or write some software to run in your new RSence environment next.</p>
 <p>Go to <a href="http://rsence.org/">rsence.org</a> to learn more about RSence.</p>
-</span>
+</span>

data/setup/welcome/values.yaml

@@ -1,6 +1,9 @@
+# Value for the checkbox. When true combined with 1 of the close value, disables the plugin. See welcome.rb
 :dont_show_again:
   :value: false
+
+# Value for the close button.
 :close:
   :value: 0
-  :responders:
-  - { :method: close_button }
+  :responders: # See the 'close_button' method of welcome.rb to see what a responder is.
+  - :method: close_button

data/setup/welcome/welcome.rb

@@ -7,12 +7,10 @@
  ##
 
 
-# RSence 'Welcome' plugin
+# RSence 'Welcome' plugin.
+# An instance of a class extended from GUIPlugin includes basic functionality
+# to initialize their user interface from YAML files without extra code.
 class WelcomePlugin < GUIPlugin
-  def disable_self
-    file_write( 'disabled', '' )
-    @plugins.unload_bundle( @name )
-  end
   
   def gui_params( msg )
     params = super
@@ -22,11 +20,35 @@ class WelcomePlugin < GUIPlugin
     return params
   end
   
+  # Responder for the value defined as `:close` in values.yaml
+  # A responder is called whenever its value is changed on the client.
   def close_button( msg, value )
+    
+    # Gets the value of the checkbox
     dont_show_again = get_ses(msg)[:dont_show_again]
+    
+    # If both the checkbox is checked (true) and the button clicked,
+    # calls the disable_self method defined below.
     if (value.data == 1) and (dont_show_again.data == true)
       disable_self
     end
+    
+    # For most uses of HClickButton combined with a value, resetting the data
+    # to 0 (to make the button clickable again) is done like this:
+    # value.set( msg, 0 )
+    
+    # Responders should always return true, until more specific return
+    # values are defined in a future version of RSence.
+    # Returning false causes the responder to be called on every request
+    # the client makes until the responder returns true.
     return true
   end
+  
+  # Called by close_button, when the checkbox is checked (true) and the Close-button is clicked (1).
+  def disable_self
+    file_write( 'disabled', 'This plugin is disabled. Remove this file to re-enable.' )
+    @plugins.unload_bundle( @name )
+  end
+  
 end
+

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification 
 name: rsence
 version: !ruby/object:Gem::Version 
-  hash: 961916132
-  prerelease: true
+  hash: 101
+  prerelease: false
   segments: 
   - 2
   - 0
   - 9
-  - 22
-  - pre
-  version: 2.0.9.22.pre
+  - 23
+  version: 2.0.9.23
 platform: ruby
 authors: 
 - Riassence Inc.
@@ -17,7 +16,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-08-25 00:00:00 +03:00
+date: 2010-08-28 00:00:00 +03:00
 default_executable: rsence
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -385,20 +384,18 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version 
-      hash: 25
+      hash: 3
       segments: 
-      - 1
-      - 3
-      - 1
-      version: 1.3.1
+      - 0
+      version: "0"
 requirements: []
 
-rubyforge_project: 
+rubyforge_project: rsence-
 rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: Pre-Release 2.0 version of the RSence framework.
+summary: Release 2.0 version of the RSence framework.
 test_files: []