glimmer 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3610ccbe7872450d8b38005411e05be5b282c6f9785dbb21f87a239944ff304b
-  data.tar.gz: d80b1a110bd98b8dd5bd84be107ef9cd316af755cc052f94449b2249ddee1d4b
+  metadata.gz: a2c1935b1d8ac63f8f79323e754e9a32a6c3ed8465db80da479a36e28f377d7a
+  data.tar.gz: 1b64ca831d6d2b911278abfd6156fa6267a9a88b82bc8a5a5a4bf7b35c09c403
 SHA512:
-  metadata.gz: 9d7810d076c698cab8d9c43fb4c7c3743ba37cad314e090e5d4112dcee50d6b5b5a389dce908e63e2c35a755079e944d69acff2b8ee9620f3541d474f97190a7
-  data.tar.gz: 64843e0799b6c035ca8aafa09be1ace82fda2ae7c188553e4db61ed8579b33598bc0f141ee90d8fb99f2383e810059278f2dfec8f4cbb862eac7d6e6288c0ae7
+  metadata.gz: ccab304701eefa5bcd8560995878b2f50cf739f6ec092244b5a0bfdc686e15859f81f74c62939beaccb0efd5052a126adfe2dbde887afb13d697af7430b68f7f
+  data.tar.gz: 1ba3e00febd0b60e3c9105b0737c4a875c438cc450048c7cc49bc8d06a84eb0a311b3581d5c61845c3b0a17fd1ec7dbc554428d02b8d3853e048e14b3fcca9fb

data/README.markdown

@@ -1,4 +1,4 @@
-# Glimmer 0.6.0 Beta (JRuby Desktop UI DSL + Data-Binding)
+# Glimmer 0.7.0 Beta (JRuby Desktop UI DSL + Data-Binding)
 [![Coverage Status](https://coveralls.io/repos/github/AndyObtiva/glimmer/badge.svg?branch=master)](https://coveralls.io/github/AndyObtiva/glimmer?branch=master)
 
 Glimmer is a native-UI cross-platform desktop development library written in Ruby. Glimmer's main innovation is a JRuby DSL that enables productive and efficient authoring of desktop application user-interfaces while relying on the robust Eclipse SWT library. Glimmer additionally innovates by having built-in data-binding support to greatly facilitate synchronizing the UI with domain models. As a result, that achieves true decoupling of object oriented components, enabling developers to solve business problems without worrying about UI concerns, or alternatively drive development UI-first, and then write clean business components test-first afterwards.
@@ -7,7 +7,7 @@ Glimmer is a native-UI cross-platform desktop development library written in Rub
 
 ### Hello World
 
-Glimmer code (from `samples/hello_world.rb`):
+Glimmer code (from `samples/hello/hello_world.rb`):
 ```ruby
 include Glimmer
 
@@ -21,7 +21,7 @@ shell {
 
 Run:
 ```
-glimmer samples/hello_world.rb
+glimmer samples/hello/hello_world.rb
 ```
 
 Glimmer app:
@@ -30,7 +30,7 @@ Glimmer app:
 
 ### Tic Tac Toe
 
-Glimmer code (from `samples/tictactoe/tic_tac_toe.rb`):
+Glimmer code (from `samples/elaborate/tic_tac_toe.rb`):
 
 ```ruby
 # ...
@@ -58,7 +58,7 @@ shell {
 Run:
 
 ```
-glimmer samples/tictactoe/tic_tac_toe.rb
+glimmer samples/elaborate/tic_tac_toe.rb
 ```
 
 Glimmer app:
@@ -70,7 +70,7 @@ NOTE: Glimmer is in beta mode. Please help make better by adopting for small or
 ## Table of Contents
 
 <!-- TOC START min:1 max:3 link:true asterisk:false update:true -->
-- [Glimmer 0.6.0 Beta (JRuby Desktop UI DSL + Data-Binding)](#glimmer-058-beta-jruby-desktop-ui-dsl--data-binding)
+- [Glimmer 0.7.0 Beta (JRuby Desktop UI DSL + Data-Binding)](#glimmer-058-beta-jruby-desktop-ui-dsl--data-binding)
   - [Examples](#examples)
     - [Hello World](#hello-world)
     - [Tic Tac Toe](#tic-tac-toe)
@@ -143,9 +143,9 @@ https://www.eclipse.org/swt/faq.php
 
 ## Pre-requisites
 
-* Java SE Runtime Environment 7 or higher (find at https://www.oracle.com/java/technologies/javase-downloads.html)
-* JRuby 9.2.11.1 (supporting Ruby 2.5.x syntax) (find at https://www.jruby.org/download)
-* SWT 4.15 (comes included in Glimmer gem)
+- SWT 4.15 (comes included in Glimmer gem)
+- JRuby 9.2.11.1 (supporting Ruby 2.5.x syntax) (find at https://www.jruby.org/download)
+- Java SE Runtime Environment 7 or higher (find at https://www.oracle.com/java/technologies/javase-downloads.html)
 
 On **Mac** and **Linux**, an easy way to obtain JRuby is through [RVM](http://rvm.io) by running:
 
@@ -163,14 +163,18 @@ Please follow these instructions to make the `glimmer` command available on your
 
 Run this command to install directly:
 ```
-jgem install glimmer -v 0.6.0
+jgem install glimmer -v 0.7.0
 ```
 
+`jgem` is JRuby's version of `gem` command. 
+RVM allows running `gem` as an alias.
+Otherwise, you may also run `jruby -S gem install ...`
+
 ### Option 2: Bundler
 
 Add the following to `Gemfile`:
 ```
-gem 'glimmer', '~> 0.6.0'
+gem 'glimmer', '~> 0.7.0'
 ```
 
 And, then run:
@@ -191,7 +195,7 @@ the glimmer ruby gem and SWT jar dependency.
 
 Example:
 ```
-glimmer samples/hello_world.rb
+glimmer samples/hello/hello_world.rb
 ```
 This runs the Glimmer "Hello, World!" sample.
 
@@ -199,30 +203,166 @@ If you cloned this project locally, you may run `bin/glimmer` instead.
 
 Example:
 ```
-bin/glimmer samples/hello_world.rb
+bin/glimmer samples/hello/hello_world.rb
 ```
 
 ### Advanced Usage
 
+Below are the full usage instructions that come up when running `glimmer` without args.
+
 ```
-glimmer [--log-level=VALUE] [[ENV_VAR=VALUE]...] [[-jruby-option]...] application.rb [[application2.rb]...]
-```
+Usage: glimmer [--debug] [--log-level=VALUE] [[ENV_VAR=VALUE]...] [[-jruby-option]...] (application.rb or task[task_args]) [[application2.rb]...]
+
+Runs Glimmer applications/tasks.
+
+Either a single task or one or more applications may be specified.
+
+When a task is specified, it runs via rake. Some tasks take arguments in square brackets.
+
+Available tasks are below (you may also lookup by adding `require 'glimmer/rake_task'` in Rakefile and running rake -T):
+glimmer package                                                   # Package app for distribution (generating config, jar, and native files)
+glimmer package:config                                            # Generate JAR config file
+glimmer package:jar                                               # Generate JAR file
+glimmer package:native                                            # Generate Native files (DMG/PKG/APP on the Mac)
+glimmer scaffold[app_name]                                        # Scaffold a Glimmer application directory structure to begin building a new app
+glimmer scaffold:custom_shell[custom_shell_name,namespace]        # Scaffold a Glimmer::UI::CustomShell subclass (represents a full window view) under app/views (namespace is optional)
+glimmer scaffold:custom_widget[custom_widget_name,namespace]      # Scaffold a Glimmer::UI::CustomWidget subclass (represents a part of a view) under app/views (namespace is optional)
+glimmer scaffold:custom_widget_gem[custom_widget_name,namespace]  # Scaffold a Glimmer::UI::CustomWidget subclass (represents a part of a view) under its own Ruby gem project (namespace is required)
 
-Accepts JRuby options and multiple Glimmer applications to run simultaneously, each in a JRuby thread.
+When applications are specified, they are run using JRuby, 
+automatically preloading the glimmer Ruby gem and SWT jar dependency.
 
-Example (JRuby option):
+Optionally, extra Glimmer options, JRuby options and environment variables may be passed in.
+
+Concerning Glimmer options:
+- "--debug"           : Displays extra debugging information and passes "--debug" to JRuby
+- "--log-level=VALUE" : Sets Glimmer's Ruby logger level ("ERROR" / "WARN" / "INFO" / "DEBUG"; default is "WARN")
+
+Example: glimmer samples/hello/hello_world.rb
+
+This runs the Glimmer application samples/hello/hello_world.rb
 ```
-glimmer --debug samples/hello_world.rb
+
+Example (Glimmer/JRuby option specified):
+```
+glimmer --debug samples/hello/hello_world.rb
 ```
 
 Runs Glimmer application with JRuby debug option to enable JRuby debugging.
 
 Example (Multiple apps):
 ```
-glimmer samples/hello_world.rb samples/hello_tab.rb
+glimmer samples/hello/hello_world.rb samples/hello_tab.rb
+```
+
+Launches samples/hello/hello_world.rb and samples/hello_tab.rb at the same time, each in a separate JRuby thread.
+
+### Scaffolding
+
+Glimmer borrows from Rails the idea of Scaffolding, that is generating a structure for your app files that
+helps you get started just like true building scaffolding helps construction workers, civil engineers, and architects.
+
+Glimmer scaffolding goes way beyond just scaffolding the app files that Rails does. It also packages it and launches it, 
+getting you to a running and delivered state of an advanced "Hello, World!" Glimmer application right off the bat.
+
+This should greatly facilitate building a new Glimmer app by helping you be productive and focus on app details while 
+letting Glimmer scaffolding take care of initial app file structure concerns, such as adding:
+- Main application class that includes Glimmer
+- Main application view that houses main window content
+- View and Model directories
+- Rakefile including Glimmer tasks
+- Version
+- License
+- Icon
+- Bin file for starting application
+
+#### App
+
+Before you start, make sure you are in a JRuby environment with Glimmer gem installed as per "Direct Install" pre-requisites. 
+
+To scaffold a Glimmer app from scratch, run the following command:
+
+```
+glimmer scaffold[AppName]
+```
+
+This will generate an advanced "Hello, World!" app, package it as a Mac native file (DMG/PKG/APP), and launch it all in one fell swoop.
+
+Suppose you run:
+
+```
+glimmer scaffold[CarMaker]
+```
+
+You should see output like the following:
+
+```
+Created CarMaker/.ruby-version
+Created CarMaker/.ruby-gemset
+Created CarMaker/VERSION
+Created CarMaker/LICENSE.txt
+Created CarMaker/Gemfile
+Created CarMaker/Rakefile
+Created CarMaker/app/car_maker.rb
+Created CarMaker/app/views/car_maker/app_view.rb
+Created CarMaker/package/macosx/Car Maker.icns
+Created CarMaker/bin/car_maker
+...
+```
+
+Eventually, it will launch an advanced "Hello, World!" app window having the title of your application and a Mac icon.
+
+![Glimmer Scaffold App](images/glimmer-scaffolding-app.png)
+
+#### Custom Shell
+
+To scaffold a Glimmer custom shell (full window view) for an existing Glimmer app, run the following command:
+
+```
+glimmer scaffold:custom_shell[custom_shell_name]
+```
+
+#### Custom Widget
+
+To scaffold a Glimmer custom widget (part of a view) for an existing Glimmer app, run the following command:
+
+```
+glimmer scaffold:custom_widget[custom_widget_name]
+```
+
+#### Custom Shell Gem
+
+Custom shell gems are self-contained Glimmer apps as well as reusable custom shells.
+
+To scaffold a Glimmer custom shell gem (full window view externalized into a gem) for an existing Glimmer app, run the following command:
+
+```
+glimmer scaffold:custom_shell_gem[custom_shell_name, namespace]
+```
+
+It is important to specify a namespace to avoid having your gem clash with existing gems.
+
+The Ruby gem name will follow the convention "glimmer-cs-customwidgetname-namespace" (the 'cs' is for Custom Shell)
+
+Only official Glimmer gems created by the Glimmer project committers will have no namespace (e.g. "glimmer-cs-gladiator" Ruby gem)
+
+Example: [https://github.com/AndyObtiva/glimmer-cs-gladiator](https://github.com/AndyObtiva/glimmer-cs-gladiator)
+
+#### Custom Widget Gem
+
+To scaffold a Glimmer custom widget gem (part of a view externalized into a gem) for an existing Glimmer app, run the following command:
+
 ```
+glimmer scaffold:custom_widget_gem[custom_widget_name, namespace]
+```
+
+It is important to specify a namespace to avoid having your gem clash with existing gems.
+
+The Ruby gem name will follow the convention "glimmer-cw-customwidgetname-namespace" (the 'cw' is for Custom Widget)
 
-Launches samples/hello_world.rb and samples/hello_tab.rb at the same time, each in a separate JRuby thread.
+Only official Glimmer gems created by the Glimmer project committers will have no namespace (e.g. "glimmer-cw-video" Ruby gem)
+
+Example: [https://github.com/AndyObtiva/glimmer-cw-video](https://github.com/AndyObtiva/glimmer-cw-video)
 
 ## Girb (Glimmer irb) Command
 
@@ -287,7 +427,7 @@ Every **widget** is sufficiently declared by name, but may optionally be accompa
 - SWT **style** ***argument*** wrapped by parenthesis according to [Glimmer Style Guide](#glimmer-coding-style) (see [next section](#widget-styles) for details).
 - Ruby block containing **properties** (widget attributes) and **content** (nested widgets)
 
-For example, if we were to revisit `samples/hello_world.rb` above (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
+For example, if we were to revisit `samples/hello/hello_world.rb` above (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
 
 ```ruby
 shell {
@@ -341,7 +481,7 @@ It is centered upon initial display and has a minimum width of 130 (can be re-ce
 
 Check out the [samples](samples) directory for more examples.
 
-Example from [hello_tab.rb](samples/hello_tab.rb) sample (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
+Example from [hello_tab.rb](samples/hello/hello_tab.rb) sample (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
 
 ![Hello Tab 1](images/glimmer-hello-tab1.png)
 
@@ -787,7 +927,7 @@ composite {
 # ...
 ```
 
-Here is a more sophisticated example taken from [hello_computed.rb](samples/hellocomputed/hello_computed.rb) sample:
+Here is a more sophisticated example taken from [hello_computed.rb](samples/hello/hello_computed.rb) sample:
 ```ruby
 shell {
   text "Hello Computed"
@@ -970,7 +1110,7 @@ This example demonstrates computed value data binding whereby the value of `name
 
 This example demonstrates nested indexed computed value data binding whereby the value of `profiles[0].name` depends on changes to both nested `profiles[0].first_name` and `profiles[0].last_name`.
 
-Example from [samples/hello_combo.rb](samples/hello_combo.rb) sample (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
+Example from [samples/hello/hello_combo.rb](samples/hello_combo.rb) sample (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
 
 ![Hello Combo](images/glimmer-hello-combo.png)
 
@@ -1015,7 +1155,7 @@ HelloCombo.new.launch
 
 `combo` widget is data-bound to the country of a person. Note that it expects `person` object to have `:country` attribute and `:country_options` attribute containing all available countries.
 
-Example from [samples/hello_list_single_selection.rb](samples/hello_list_single_selection.rb) sample:
+Example from [samples/hello/hello_list_single_selection.rb](samples/hello_list_single_selection.rb) sample:
 
 ![Hello List Single Selection](images/glimmer-hello-list-single-selection.png)
 
@@ -1039,7 +1179,7 @@ shell {
 
 Nonetheless, in the next example, a multi-selection list is declared instead allowing data-binding of multiple selection values to the bindable attribute on the model.
 
-Example from [samples/hello_list_multi_selection.rb](samples/hello_list_multi_selection.rb) sample (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
+Example from [samples/hello/hello_list_multi_selection.rb](samples/hello_list_multi_selection.rb) sample (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
 
 ![Hello List Multi Selection](images/glimmer-hello-list-multi-selection.png)
 
@@ -1139,7 +1279,7 @@ shell {
           text        bind(@tic_tac_toe_board[row, column], :sign)
           enabled     bind(@tic_tac_toe_board[row, column], :empty)
           on_widget_selected {
-            @tic_tac_toe_board.mark_box(row, column)
+            @tic_tac_toe_board.mark(row, column)
           }
         }
       }
@@ -1148,9 +1288,9 @@ shell {
 }
 ```
 
-Note that every Tic Tac Toe grid cell has its `text` and `enabled` properties data-bound to the `sign` and `empty` attributes on the `TicTacToeBoard` model respectively.
+Note that every Tic Tac Toe grid cell has its `text` and `enabled` properties data-bound to the `sign` and `empty` attributes on the `TicTacToe::Board` model respectively.
 
-Next however, each of these Tic Tac Toe grid cells, which are clickable buttons, have an `on_widget_selected` observer, which once triggered, marks the box (cell) on the `TicTacToeBoard` to make a move.
+Next however, each of these Tic Tac Toe grid cells, which are clickable buttons, have an `on_widget_selected` observer, which once triggered, marks the cell on the `TicTacToe::Board` to make a move.
 
 **Regarding number 2**, you can figure out all available events by looking at the `org.eclipse.swt.SWT` API:
 
@@ -1221,8 +1361,8 @@ class TicTacToe
   def initialize
     # ...
     observe(@tic_tac_toe_board, :game_status) { |game_status|
-      display_win_message if game_status == TicTacToeBoard::WIN
-      display_draw_message if game_status == TicTacToeBoard::DRAW
+      display_win_message if game_status == Board::WIN
+      display_draw_message if game_status == Board::DRAW
     }
   end
   # ...
@@ -1231,7 +1371,7 @@ end
 
 Observers can be a good mechanism for displaying dialog messages in Glimmer (using SWT's `MessageBox`).
 
-Look at [`samples/tictactoe/tic_tac_toe.rb`](samples/tictactoe/tic_tac_toe.rb) for more details starting with the code included below.
+Look at [`samples/elaborate/tictactoe/tic_tac_toe.rb`](samples/tictactoe/tic_tac_toe.rb) for more details starting with the code included below.
 
 ```ruby
 class TicTacToe
@@ -1241,8 +1381,8 @@ class TicTacToe
   def initialize
     # ...
     observe(@tic_tac_toe_board, :game_status) { |game_status|
-      display_win_message if game_status == TicTacToeBoard::WIN
-      display_draw_message if game_status == TicTacToeBoard::DRAW
+      display_win_message if game_status == Board::WIN
+      display_draw_message if game_status == Board::DRAW
     }
   end
 
@@ -1561,11 +1701,12 @@ Also, you may invoke `Display.setAppVersion('1.0.0')` if needed for OS app versi
 #### Multi-DSL Support
 
 Glimmer supports two other DSLs in addition to the SWT DSL; that is Glimmer XML DSL and Glimmer CSS DSL. It also allows mixing DSLs, which comes in handy when doing things like using the `browser` widget. Glimmer automatically recognizes top-level keywords in each DSL
-and switches DSLs accordingly until it finishes processes the top-level keywords, at which point it switches back to the prior DSL.
+and switches DSLs accordingly. Once done processing a top-level keyword, it switches back to the prior DSL automatically.
 
 For example, the SWT DSL has the following top-level keywords:
 - `shell`
 - `display`
+- `color`
 - `observe`
 - `async_exec`
 - `sync_exec`
@@ -1599,7 +1740,7 @@ puts @xml
 Output:
 
 ```
-<html><head><meta name=\"viewport\" content=\"width=device-width, initial-scale=2.0\" /></head><body><h1>Hello, World!</h1></body></html>
+<html><head><meta name="viewport" content="width=device-width, initial-scale=2.0" /></head><body><h1>Hello, World!</h1></body></html>
 ```
 
 Example (explicit XML tag / you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
@@ -1629,7 +1770,7 @@ puts @xml
 Output:
 
 ```
-<w3c:html id=\"thesis\" class=\"document\"><w3c:body id=\"main\"></w3c:body></w3c:html>
+<w3c:html id="thesis" class="document"><w3c:body id="main"></w3c:body></w3c:html>
 ```
 
 Example (XML namespaces using dot operator / you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
@@ -1656,16 +1797,21 @@ Once done, you may call `to_s` or `to_css` to get the formatted CSS output.
 
 `css` is the only top-level keyword in the Glimmer CSS DSL
 
+Selectors may be specified by `s` keyword or HTML element keyword directly (e.g. `body`)
+Rule property values may be specified by `pv` keyword or underscored property name directly (e.g. `font_size`)
+
 Example (you may copy/paste in [`girb`](#girb-glimmer-irb-command)):
 
 ```ruby
 @css = css {
   body {
-    font_size "1.1em"
+    font_size '1.1em'
+    pv 'background', 'white'
   }
   
   s('body > h1') {
     background_color :red
+    pv 'font-size', '2em'
   }
 }
 puts @css
@@ -1675,84 +1821,9 @@ puts @css
 
 ![Video Widget](images/glimmer-video-widget.png)
 
-Glimmer comes with a video widget not in SWT. It comes with very basic video functionality at the moment, such as autoplay by default, displaying controls, looping, and setting background.
-
-Options (passed in an options hash as arguments to video widget):
-- `autoplay` (true [default] or false): plays video automatically as soon as loaded
-- `controls` (true [default] or false): displays controls
-- `looped` (true or false [default]): plays video in looped mode
-- `background` (Glimmer color [default: white]): sets background color just like with any other widget
-- `fit_to_width` (true [default] or false): fits video width to widget allotted width regardless of video's original size. Maintains video aspect ratio.
-- `fit_to_height` (true [default] or false): fits video height to widget allotted height regardless of video's original size. Maintains video aspect ratio.
-- `offset_x` (integer [default: 0]): offset from left border. Could be a negative number if you want to show only an area of the video. Useful when fit_to_width is false to pick an area of the video to display.
-- `offset_y` (integer [default: 0]): offset from top border. Could be a negative number if you want to show only an area of the video. Useful when fit_to_height is false to pick an area of the video to display.
-
-Methods:
-- `#play`: plays video
-- `#pause`: pauses video
-- `#reload`: reloads video restarting from beginning
-- `#position`: position in seconds (and fractions)
-- `#position=`: seeks a new position in video
-- `#duration`: length of video, maximum video position possible
-- `#loaded?`: returns true when video has been initially loaded or reloaded
-- `#playing?`: returns true when video is actively playing
-- `#paused?`: returns true when video is not playing
-- `#ended?`: returns true when video has reached the end (position == duration)
-
-Events (to observe):
-- `on_loaded`: invoked when video `#loaded?` becomes true
-- `on_ended`: invoked when video `#ended?` becomes true
-- `on_playing`: invoked when video `#playing?` becomes true
-- `on_paused`: invoked when video `#paused?` becomes true
-
-Example ([samples/video/hello_video.rb](samples/video/hello_video.rb)):
-
-```ruby
-# ...
-shell {
-  video(file: video_file)
-}.open
-```
-
-Example ([samples/video/hello_looped_video_with_black_background.rb](samples/video/hello_looped_video_with_black_background.rb)):
-
-```ruby
-# ...
-shell {
-  minimum_size 1024, 640
-  video(file: video_file, looped: true, background: :black)
-}.open
-```
+Glimmer supports a [video custom widget](https://github.com/AndyObtiva/glimmer-cw-video) not in SWT. 
 
-Example ([samples/video/hello_video_observers.rb](samples/video/hello_video_observers.rb)):
-
-```ruby
-# ...
-def display_video_status(video, status)
-  message_box = MessageBox.new(video.swt_widget.getShell)
-  message_box.setText(status)
-  message = "Video Position: #{video.position} seconds\n"
-  message += "Video Duration: #{video.duration} seconds"
-  message_box.setMessage(message)
-  message_box.open
-end
-
-@shell = shell {
-  minimum_size 800, 500
-  @video = video(file: video_file, background: :black) {
-    on_playing {
-      display_video_status(@video, 'Playing')
-    }
-    on_paused {
-      display_video_status(@video, 'Paused')
-    }
-    on_ended {
-      display_video_status(@video, 'Ended')
-    }
-  }
-}
-@shell.open
-```
+You may obtain via `glimmer-cw-video` gem.
 
 #### Browser Widget
 
@@ -1822,16 +1893,13 @@ samples/launch
 For "Hello, World!" type samples, check the following:
 
 ```
-glimmer samples/hello_world.rb
-glimmer samples/hello_browser.rb
-glimmer samples/hello_tab.rb
-glimmer samples/hello_combo.rb
-glimmer samples/hello_list_single_selection.rb
-glimmer samples/hello_list_multi_selection.rb
-glimmer samples/hellocomputed/hello_computed.rb
-glimmer samples/video/hello_video.rb
-glimmer samples/video/hello_looped_video_with_black_background.rb
-glimmer samples/video/hello_video_observers.rb
+glimmer samples/hello/hello_world.rb
+glimmer samples/hello/hello_browser.rb # demonstrates browser widget
+glimmer samples/hello/hello_tab.rb # demonstrates tabs
+glimmer samples/hello/hello_combo.rb # demonstrates combo data-binding
+glimmer samples/hello/hello_list_single_selection.rb # demonstrates list single-selection data-binding
+glimmer samples/hello/hello_list_multi_selection.rb # demonstrates list multi-selection data-binding
+glimmer samples/hello/hello_computed.rb # demonstrates computed data-binding
 ```
 
 ### Elaborate Samples
@@ -1839,42 +1907,15 @@ glimmer samples/video/hello_video_observers.rb
 For more elaborate samples, check the following:
 
 ```
-glimmer samples/login.rb # demonstrates basic data-binding
-glimmer samples/contactmanager/contact_manager.rb # demonstrates table data-binding
-glimmer samples/tictactoe/tic_tac_toe.rb # demonstrates a full MVC application
-glimmer samples/gladiator.rb # demonstrates a text editor with tree/list data-binding
+glimmer samples/elaborate/login.rb # demonstrates general data-binding
+glimmer samples/elaborate/contact_manager.rb # demonstrates table data-binding
+glimmer samples/elaborate/tic_tac_toe.rb # demonstrates a full MVC application
 ```
 
 ![Gladiator](images/glimmer-gladiator.png)
 
-Gladiator (short for Glimmer Editor) is an on-going sample project under continuous development. It is used as the main text editor for developing Glimmer.
-
-It currently supports the following text editing features:
-- File explorer navigation to open file
-- File lookup by name
-- Find & Replace
-- Show Line Numbers
-- Jump to Line
-- Remember last opened file, caret position, and top line
-- Autosave on focus out/quit/open new file
-- Watch open file for external changes to reflect in editor
-- Duplicate Line(s)
-- Kill Line(s)
-- Move up one line
-- Move down one line
-
-Gladiator has been made available in [Glimmer's gem](https://rubygems.org/gems/glimmer) via the `gladiator` command should others find useful too.
-
-If you cloned this project and followed [CONTRIBUTING.md](CONTRIBUTING.md) instructions, you may invoke via `bin/gladiator` instead. 
-
-Gotcha:
-
-Gladiator repetitively displays a signaling error that is harmless in practice:
-```
-The signal HUP is in use by the JVM and will not work correctly on this platform
-The signal INT is in use by the JVM and will not work correctly on this platform
-The signal TERM is in use by the JVM and will not work correctly on this platform
-```
+[Gladiator](https://github.com/AndyObtiva/glimmer-cs-gladiator) (short for Glimmer Editor) is a Glimmer sample project under on-going development.
+You may check it out to learn how to build a Glimmer Custom Shell gem.
 
 ## In Production
 
@@ -1944,11 +1985,12 @@ https://github.com/jruby/jruby/wiki/CallingJavaFromJRuby
 
 ## Logging
 
-Glimmer comes with a Ruby Logger accessible via `Glimmer.logger`
+Glimmer comes with a Ruby Logger accessible via `Glimmer::Config.logger`
 Its level of logging defaults to `Logger::WARN`
 It may be configured to show a different level of logging as follows:
 ```ruby
-Glimmer.logger&.level = Logger::DEBUG
+Glimmer::Config.enable_logging
+Glimmer::Config.logger.level = Logger::DEBUG
 ```
 This results in more verbose debugging log to `STDOUT`, which is helpful in troubleshooting Glimmer DSL syntax when needed.
 
@@ -2048,6 +2090,7 @@ In order to explicitly configure javapackager, Mac package attributes, or sign y
 - https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javapackager.html
 - https://docs.oracle.com/javase/8/docs/technotes/guides/deploy/self-contained-packaging.html#BCGICFDB
 - https://docs.oracle.com/javase/8/docs/technotes/guides/deploy/self-contained-packaging.html
+- https://developer.apple.com/library/archive/releasenotes/General/SubmittingToMacAppStore/index.html#//apple_ref/doc/uid/TP40010572-CH16-SW8
 
 The Glimmer rake task allows passing extra options to javapackager via:
 - `Glimmer::Packager.javapackager_extra_args="..."` in your application Rakefile
@@ -2056,9 +2099,13 @@ The Glimmer rake task allows passing extra options to javapackager via:
 Example (Rakefile):
 
 ```ruby
-Glimmer::Package.javapackager_extra_args = '-BlicenseType="MIT" -Bmac.category="arithmetic" -Bmac.signing-key-developer-id-app="Andy Maleh"'
+Glimmer::Package.javapackager_extra_args = '-BlicenseType="MIT" -Bmac.category="public.app-category.business" -Bmac.signing-key-developer-id-app="Andy Maleh"'
 ```
 
+Note that `mac.category` defaults to "public.app-category.business", but can be overridden with one of the category UTI values mentioned here: 
+
+https://developer.apple.com/library/archive/releasenotes/General/SubmittingToMacAppStore/index.html#//apple_ref/doc/uid/TP40010572-CH16-SW8 
+
 Example (env var):
 
 ```
@@ -2126,7 +2173,11 @@ Glimmer::Package.javapackager_extra_args = '-srcfiles "ACME.txt" -BlicenseFile="
 
 If you run `rake glimmer:package` multiple times, sometimes it leaves a mounted DMG project in your finder. Unmount before you run the command again or it might fail with an error saying: "Error: Bundler "DMG Installer" (dmg) failed to produce a bundle."
 
-By the way, keep in mind that during normal operation, it does also indicate a false-negative while completing successfully (please ignore): "Exec failed with code 2 command [[/usr/bin/SetFile, -c, icnC, /var/folders/4_/g1sw__tx6mjdgyh3mky7vydc0000gp/T/fxbundler4076750801763032201/images/MathBowling/.VolumeIcon.icns] in unspecified directory"
+By the way, keep in mind that during normal operation, it does also indicate a false-negative while completing successfully similar to the following (please ignore): 
+
+```
+Exec failed with code 2 command [[/usr/bin/SetFile, -c, icnC, /var/folders/4_/g1sw__tx6mjdgyh3mky7vydc0000gp/T/fxbundler4076750801763032201/images/MathBowling/.VolumeIcon.icns] in unspecified directory
+```
 
 ## Resources