glimmer-dsl-swt 4.18.7.6 → 4.20.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f9004ad05389af266956ee36a467e07fa97845f64d8717e0c24b716ae81420ac
-  data.tar.gz: f78e73a1b5708769a03e5ad4747df729e7cbe93e9922845d35c5ae0cdba98bc5
+  metadata.gz: 21989f606fc509c36ef0be6f2429ef43082f60a0aa800ad42fbe956e39168333
+  data.tar.gz: 3307a4cc805b6e72eefa059c984584464ac9f759f4e0c3c0968b0e151fb7bbd0
 SHA512:
-  metadata.gz: 6496f86ebe9ddd173de6d9d3853e6ea4bb39e069eed9951c0c4756647cc518cce4fe174918f18f6f05d18bd6a74fb474824e92c29bb0f57db9bcc9f72357e732
-  data.tar.gz: b78d493257309b1cf703b0e6894cd1158b1101be393cf85362ab210a6ce23cdd07ca254ab50f92d7e0251eb309dccf1478b77e71e06dccfbd2dc1b23cfee0bdb
+  metadata.gz: bb070bb78b470ba5be916cd0c58917b91d757b0174ddd37992dc92d6b9238e5697e144292c13b48de70b6e2f8bc77206786a6c7ddfe9b7ad47f83ed03fbbe4c7
+  data.tar.gz: 0fe369459de55d705acb992c40345e4f0ff12b4931ad32af7e103c0c850ca4b3c7cdfd465899246ecb998b694a23c1a4356afc173296bc45e47abb10571d4db9

data/CHANGELOG.md

@@ -1,8 +1,52 @@
 # Change Log
 
+### 4.20.0.0
+
+- Upgrade to SWT 4.20, supporting AARCH64 experimentally
+- Upgrade to JRuby 9.2.19.0
+- Shine syntax for data-binding
+- Tweak/Fix Samples
+
+### 4.19.0.2
+
+- Fixed issue with Meta-Sample code editing not showing changes properly (although recording them)
+- Stop Mandelbrot Fractal sample background calculation when its custom shell is closed
+
+### 4.19.0.1
+
+- Upgrade to JRuby 9.2.17.0
+- Fix Hello, C Tab! sample not showing flags on Windows
+- Fix Stock Ticker elaborate sample non-scrolling and clipped stock names on Windows
+
+### 4.19.0.0
+
+- Upgrade to SWT 4.19
+- Upgrade to JRuby 9.2.16.0
+- Speed up glimmer command startup time by not spawning a jruby a second time for handling Mac-specific options (cutting down glimmer app startup time to half)
+- glimmer-setup command configures `glimmer` and `girb` for the Mac with `-X-JstartOnFirstThread` in a `JRUBY_OPTS` environment variable
+- Switch all scaffolded models/views to `Model::` and `View::` namespacing instead of the namespaceless 'models' and 'views' directories (new scheme was originally introduced in the Tetris sample)
+- Make sure that scaffolded shell/app uses new custom shell built-in `.launch` method instead of custom written `.open` method
+- Make `scaffold:desktopify` generated app window shell fill the screen by default
+- Support `c_tab_folder` and `c_tab_item`
+- Support `c_combo` (`org.eclipse.swt.custom.CCombo` SWT widget) data-binding
+- Hello, CCombo!
+- Hello, C Tab!
+- Shape#clear_shapes just like that of Drawable in WidgetProxy
+- Set default background of `rgb(230, 230, 230)` on sash_form to make it more spottable to resize the sash
+- Fix issue with processing arguments for the `glimmer package` command.
+- Fix mandelbrot fractal sample on Windows (added missing `jruby-win32ole` gem for use with `concurrent-ruby` gem)
+- Fix this `glimmer package` message, which comes out even with the right Java version: `WARNING! Glimmer Packaging Pre-Requisite Java Version 1.8.0_241 Is Not Found!`
+
+### 4.18.7.7
+
+- Upgrade to glimmer v1.3.0
+- Handle `code_text` encountering errors in adding observation request
+- Always notify widget binding observer on `async_exec: true` data-bindings
+
 ### 4.18.7.6
 
 - Update the Hello, Code Text! sample to use data-binding
+- Upgrade `puts_debuggerer` gem dependency to version 0.12.0
 - Fix issue with `code_text` data-binding
 
 ### 4.18.7.5

data/README.md

@@ -1,4 +1,4 @@
-# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for SWT 4.18.7.6
+# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for SWT 4.20.0.0
 ## JRuby Desktop Development GUI Framework
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-swt.svg)](http://badge.fury.io/rb/glimmer-dsl-swt)
 [![Travis CI](https://travis-ci.com/AndyObtiva/glimmer-dsl-swt.svg?branch=master)](https://travis-ci.com/github/AndyObtiva/glimmer-dsl-swt)
@@ -10,14 +10,16 @@
 
 **(The Original Glimmer Library Handling the World’s Ruby GUI Needs Since 2007. Beware of Imitators!)**
 
-[Glimmer](https://github.com/AndyObtiva/glimmer) DSL for SWT is a native-GUI cross-platform desktop development library written in [JRuby](https://www.jruby.org/), an OS-threaded faster JVM version of [Ruby](https://www.ruby-lang.org/en/). [Glimmer](https://github.com/AndyObtiva/glimmer) was the [first Ruby gem](https://rubygems.org/gems/glimmer) to bring [SWT](https://www.eclipse.org/swt/) (Standard Widget Toolkit) to [Ruby](https://www.ruby-lang.org/en/), thanks to its creator [Andy Maleh](https://andymaleh.blogspot.com/), an EclipseCon/EclipseWorld/RubyConf speaker and expert. [Glimmer](https://github.com/AndyObtiva/glimmer)'s main innovation is a declarative [Ruby DSL](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#glimmer-dsl-syntax) that enables productive and efficient authoring of desktop application user-interfaces by relying on the robust [Eclipse SWT library](https://www.eclipse.org/swt/). [Glimmer](https://rubygems.org/gems/glimmer) additionally innovates by having built-in [data-binding](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#data-binding) support, which greatly facilitates synchronizing the GUI with domain models, thus achieving true decoupling of object oriented components and enabling developers to solve business problems (test-first) without worrying about GUI concerns, or alternatively drive development GUI-first, and then write clean business models (test-first) afterwards. Not only does Glimmer provide a large set of GUI [widgets](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#widgets), but it also supports drawing Canvas Graphics like [Shapes](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#canvas-shape-dsl) and [Animations](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#canvas-animation-dsl). To get started quickly, [Glimmer](https://rubygems.org/gems/glimmer) offers [scaffolding](docs/reference/GLIMMER_COMMAND.md#scaffolding) options for [Apps](#in-production), [Gems](docs/reference/GLIMMER_COMMAND.md#custom-shell-gem), and [Custom Widgets](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#custom-widgets). [Glimmer](https://rubygems.org/gems/glimmer) also includes native-executable [packaging](docs/reference/GLIMMER_PACKAGING_AND_DISTRIBUTION.md) support, sorely lacking in other libraries, thus enabling the delivery of desktop apps written in [Ruby](https://www.ruby-lang.org/en/) as truly native DMG/PKG/APP files on the [Mac](https://www.apple.com/ca/macos) + [App Store](https://developer.apple.com/macos/distribution/), MSI/EXE files on [Windows](https://www.microsoft.com/en-ca/windows), and [Gem Packaged Shell Scripts](docs/reference/GLIMMER_COMMAND.md#packaging) on [Linux](https://www.linux.org/).
+[Glimmer](https://github.com/AndyObtiva/glimmer) DSL for SWT is a native-GUI cross-platform desktop development library written in [JRuby](https://www.jruby.org/), an OS-threaded faster JVM version of [Ruby](https://www.ruby-lang.org/en/). [Glimmer](https://github.com/AndyObtiva/glimmer)'s main innovation is a declarative [Ruby DSL](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#glimmer-dsl-syntax) that enables productive and efficient authoring of desktop application user-interfaces by relying on the robust [Eclipse SWT library](https://www.eclipse.org/swt/). [Glimmer](https://rubygems.org/gems/glimmer) additionally innovates by having built-in [data-binding](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#data-binding) support, which greatly facilitates synchronizing the GUI with domain models, thus achieving true decoupling of object oriented components and enabling developers to solve business problems (test-first) without worrying about GUI concerns, or alternatively drive development GUI-first, and then write clean business models (test-first) afterwards. Not only does Glimmer provide a large set of GUI [widgets](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#widgets), but it also supports drawing Canvas Graphics like [Shapes](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#canvas-shape-dsl) and [Animations](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#canvas-animation-dsl). To get started quickly, [Glimmer](https://rubygems.org/gems/glimmer) offers [scaffolding](docs/reference/GLIMMER_COMMAND.md#scaffolding) options for [Apps](#in-production), [Gems](docs/reference/GLIMMER_COMMAND.md#custom-shell-gem), and [Custom Widgets](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#custom-widgets). [Glimmer](https://rubygems.org/gems/glimmer) also includes native-executable [packaging](docs/reference/GLIMMER_PACKAGING_AND_DISTRIBUTION.md) support, sorely lacking in other libraries, thus enabling the delivery of desktop apps written in [Ruby](https://www.ruby-lang.org/en/) as truly native DMG/PKG/APP files on the [Mac](https://www.apple.com/ca/macos) + [App Store](https://developer.apple.com/macos/distribution/), MSI/EXE files on [Windows](https://www.microsoft.com/en-ca/windows), and [Gem Packaged Shell Scripts](docs/reference/GLIMMER_COMMAND.md#packaging) on [Linux](https://www.linux.org/). [Glimmer](https://github.com/AndyObtiva/glimmer) was the [first Ruby gem](https://rubygems.org/gems/glimmer) to bring [SWT](https://www.eclipse.org/swt/) (Standard Widget Toolkit) to [Ruby](https://www.ruby-lang.org/en/), thanks to creator [Andy Maleh](https://andymaleh.blogspot.com/), an EclipseCon/EclipseWorld/RubyConf speaker and expert.
 
 [<img src="https://covers.oreillystatic.com/images/9780596519650/lrg.jpg" width=105 /><br />
 Featured in JRuby Cookbook](http://shop.oreilly.com/product/9780596519650.do) and [Chalmers/Gothenburg University Software Engineering Master's Lecture Material](http://www.cse.chalmers.se/~bergert/slides/guest_lecture_DSLs.pdf)
 
-[Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) 4.18.7.6 includes [SWT 4.18](https://download.eclipse.org/eclipse/downloads/drops4/R-4.18-202012021800/), which was released on December 2, 2020. Gem version numbers are in sync with the SWT library versions. The first two digits represent the SWT version number. The last two digits represent the minor and patch versions of Glimmer DSL for SWT.
+[Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) 4.20.0.0 includes [SWT 4.20](https://download.eclipse.org/eclipse/downloads/drops4/R-4.20-202106111600/), which was released on June 11, 2021. Gem version numbers are in sync with the SWT library versions. The first two digits represent the SWT version number. The last two digits represent the minor and patch versions of Glimmer DSL for SWT. Note that SWT now supports AARCH64 on Mac and Linux, but it is not fully tested in Glimmer DSL for SWT yet, so deem its support experimental for the time being without guarantees for functionality until declared otherwise (report any issues you may encounter).
 
-[Glimmer DSL for SWT receives two updates per month](https://rubygems.org/gems/glimmer-dsl-swt/versions). You can trust [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) with your Ruby desktop GUI development needs! [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) brings great ideas to the table, such as declarative programming via domain specific languages, currently under-utilized in the GUI domain. That said, it may not be feature complete enough for everybody's needs, so please help make [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) even better by providing feedback and [contributing](#contributing) when possible. The project is very active, so any feature suggestions that are accepted could be implemented within weeks if not days. Also, you are welcome to [hire me](#hire-me) full-time if you want long-term development of [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) for your project needs.
+**Starting in version 4.20.0.0, [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) comes with the new [***Shine***](/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#shine) syntax** for highly intuitive and visually expressive View/Model Attribute Mapping, relying on `<=>` for bidirectional (two-way) data-binding and `<=` for unidirectional (one-way) data-binding, providing an alternative to the `bind` keyword (keep in mind that it is still an early alpha, so default back to `bind` whenever needed).
+
+Please help make [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) better by providing feedback and [contributing](#contributing) whenever possible. Any feature suggestions that are accepted could be implemented within weeks if not days.
 
 Glimmer DSL gems:
 - [glimmer-dsl-swt](https://github.com/AndyObtiva/glimmer-dsl-swt): Glimmer DSL for SWT (JRuby Desktop Development GUI Framework)
@@ -308,18 +310,15 @@ https://www.eclipse.org/swt/faq.php
 ## Pre-requisites
 
 - JDK 8u241 (1.8.0_241) (find at https://www.oracle.com/java/technologies/javase/javase8u211-later-archive-downloads.html / On Windows, ensure PATH includes Java bin directory  like C:\Program Files\Java\jdk1.8.0_241\bin for javapackager to work during packaging Glimmer applications)
-- JRuby 9.2.14.0 (supporting Ruby 2.5.x syntax) (get via [RVM](http://rvm.io) on Mac and Linux or find at [https://www.jruby.org/download](https://www.jruby.org/download) for Windows)
-- SWT 4.18 (already included in the [glimmer-dsl-swt](https://rubygems.org/gems/glimmer-dsl-swt) gem)
+- [RVM](http://rvm.io) on Mac & Linux (not available on Windows)
+- JRuby 9.2.19.0 (supporting Ruby 2.5.x syntax) (get via [RVM](http://rvm.io) on Mac and Linux by running `rvm install jruby-9.2.19.0`; On Windows, find at [https://www.jruby.org/download](https://www.jruby.org/download))
+- SWT 4.20 (already included in the [glimmer-dsl-swt](https://rubygems.org/gems/glimmer-dsl-swt) gem). Note that SWT now supports AARCH64 on Mac and Linux, but it is not fully tested with Glimmer DSL for SWT yet, so it is considered experimental until declared otherwise.
 - Git (comes with Mac and Linux. Install on Windows: https://git-scm.com/download/win )
 
-To obtain JRuby through [RVM](http://rvm.io), you may run:
-
-```bash
-rvm install jruby-9.2.14.0
-```
-
 Glimmer might still work on other versions of Java, JRuby and SWT, but there are no guarantees, so it is best to stick to the pre-requisites outlined above.
 
+To change the SWT version to a custom `swt.jar` version that you have, simply set the 'SWT_JAR_FILE_PATH' env var.
+
 ## Setup
 
 Please follow these instructions to make the `glimmer` command available on your system via the [`glimmer-dsl-swt`](https://github.com/AndyObtiva/glimmer-dsl-swt) gem.
@@ -342,13 +341,23 @@ jgem install glimmer-dsl-swt
 
 Or this command if you want a specific version:
 ```
-jgem install glimmer-dsl-swt -v 4.18.7.6
+jgem install glimmer-dsl-swt -v 4.20.0.0
 ```
 
 `jgem` is JRuby's version of `gem` command.
 RVM allows running `gem install` directly as an alias.
 Otherwise, you may also run `jruby -S gem install ...`
 
+Afterwards, you can use `glimmer` and `girb` commands.
+
+On the Mac, you also have to run:
+
+```
+glimmer-setup
+```
+
+This ensures configuring extra required Mac options before using `glimmer` and `girb` commands.
+
 If you are new to Glimmer and would like to continue learning the basics, you may continue to the [Glimmer Command](https://github.com/AndyObtiva/glimmer#glimmer-command) section.
 
 Otherwise, if you are ready to build a Glimmer app, you can jump to the [Glimmer Scaffolding](https://github.com/AndyObtiva/glimmer-dsl-swt/blob/master/docs/reference/GLIMMER_COMMAND.md#scaffolding) section next.
@@ -360,7 +369,7 @@ Note: if you're using activerecord or activesupport, keep in mind that Glimmer u
 
 Add the following to `Gemfile`:
 ```
-gem 'glimmer-dsl-swt', '~> 4.18.7.6'
+gem 'glimmer-dsl-swt', '~> 4.20.0.0'
 ```
 
 And, then run:
@@ -381,7 +390,7 @@ glimmer
 ```
 
 ```
-Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.18.7.6
+Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.20.0.0
       
 Usage: glimmer [--bundler] [--pd] [--quiet] [--debug] [--log-level=VALUE] [[ENV_VAR=VALUE]...] [[-jruby-option]...] (application.rb or task[task_args]) [[application2.rb]...]
 
@@ -478,6 +487,8 @@ table(:multi) {
 }
 ```
 
+If you need more widgets, you can check out the [Nebula Project](https://github.com/AndyObtiva/glimmer-cw-nebula) (50+ enterprise-grade custom widgets)
+
 Learn more at: [docs/reference/GLIMMER_GUI_DSL_SYNTAX.md](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md)
 
 ## Glimmer Configuration
@@ -492,7 +503,7 @@ Learn more at: [docs/reference/GLIMMER_CONFIGURATION.md](docs/reference/GLIMMER_
 
 ## Samples
 
-Check the [samples](samples) directory in [glimmer-dsl-swt](https://github.com/AndyObtiva/glimmer-dsl-swt) for examples on how to write Glimmer applications. To run a sample, make sure to install the `glimmer-dsl-swt` gem first and then run:
+Check the [samples](/docs/reference/GLIMMER_SAMPLES.md) directory in [glimmer-dsl-swt](https://github.com/AndyObtiva/glimmer-dsl-swt) for examples on how to write Glimmer applications. To run a sample, make sure to install the `glimmer-dsl-swt` gem first and then run:
 ```
 glimmer samples
 ```
@@ -501,7 +512,7 @@ glimmer samples
 
 ![Glimmer Meta-Sample](/images/glimmer-meta-sample.png)
 
-See a listing of samples including screenshots and explanations at: [docs/reference/GLIMMER_SAMPLES.md](docs/reference/GLIMMER_SAMPLES.md)
+See a listing of samples including screenshots and explanations at: [docs/reference/GLIMMER_SAMPLES.md](/docs/reference/GLIMMER_SAMPLES.md)
 
 ## In Production
 
@@ -529,6 +540,10 @@ If you have a Glimmer app you would like referenced here, please mention in a Pu
 
 [<img alt="Connector Logo" src="https://raw.githubusercontent.com/AndyObtiva/connector/master/package/linux/Connector.png" height=40 /> Connector](https://github.com/AndyObtiva/connector): A minimalist open-source multi-engine web browser
 
+### The DCR Programming Language
+
+[<img alt="Connector Logo" src="https://raw.githubusercontent.com/AndyObtiva/dcr/f31cd45a8503051e899ed8e831fd03654d38e418/package/linux/Draw%20Color%20Repeat.png" height=40 /> Draw Color Repeat](https://github.com/AndyObtiva/dcr): A young boy programming language for Drawing and Coloring with Repetition
+
 ## Packaging & Distribution
 
 Glimmer simplifies the process of native-executable packaging and distribution on Mac and Windows via a single command:
@@ -666,10 +681,6 @@ You may apply for contributing to any of these Glimmer DSL gems whether you pref
 
 [Click here to view contributor commits.](https://github.com/AndyObtiva/glimmer-dsl-swt/graphs/contributors)
 
-## Hire Me
-
-If your company would like to invest fulltime in further development of the Glimmer open-source project, [hire me](https://www.linkedin.com/in/andymaleh/).
-
 ## License
 
 [MIT](LICENSE.txt)
@@ -679,3 +690,5 @@ Copyright (c) 2007-2021 - Andy Maleh.
 --
 
 [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=40 />](https://github.com/AndyObtiva/glimmer) Built for [Glimmer](https://github.com/AndyObtiva/glimmer) (DSL Framework).
+
+Glimmer logo was made by [Freepik](https://www.flaticon.com/authors/freepik) from [www.flaticon.com](http://www.flaticon.com)

data/RUBY_VERSION

@@ -1 +1 @@
-jruby-9.2.14.0
+jruby-9.2.19.0

data/VERSION

@@ -1 +1 @@
-4.18.7.6
+4.20.0.0

data/bin/girb

@@ -1,7 +1,7 @@
 #!/usr/bin/env jruby
 
 # Copyright (c) 2007-2021 Andy Maleh
-# 
+#
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the
 # "Software"), to deal in the Software without restriction, including
@@ -9,10 +9,10 @@
 # distribute, sublicense, and/or sell copies of the Software, and to
 # permit persons to whom the Software is furnished to do so, subject to
 # the following conditions:
-# 
+#
 # The above copyright notice and this permission notice shall be
 # included in all copies or substantial portions of the Software.
-# 
+#
 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
@@ -21,11 +21,12 @@
 # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
-trap "SIGINT" do
-  # No Op for irb
-end
+# This script was written for Windows and Linux only
 
-require_relative '../lib/glimmer/launcher'
+ENV['JRUBY_OPTS'] = ARGV.select {|arg| arg.start_with?('-')}.join(' ')
 
-girb_runner = File.expand_path('../girb_runner.rb', __FILE__)
-Glimmer::Launcher.new(["irb -r #{girb_runner}"] + ARGV).launch
+require_relative 'girb_runner'
+
+require 'irb'
+
+IRB.start('.')

data/bin/girb_runner.rb

@@ -1,5 +1,5 @@
 # Copyright (c) 2007-2021 Andy Maleh
-# 
+#
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the
 # "Software"), to deal in the Software without restriction, including
@@ -7,10 +7,10 @@
 # distribute, sublicense, and/or sell copies of the Software, and to
 # permit persons to whom the Software is furnished to do so, subject to
 # the following conditions:
-# 
+#
 # The above copyright notice and this permission notice shall be
 # included in all copies or substantial portions of the Software.
-# 
+#
 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
@@ -20,6 +20,11 @@
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 require 'puts_debuggerer'
+require_relative '../lib/glimmer-dsl-swt'
+
+trap "SIGINT" do
+  # No Op for irb
+end
 
 include Glimmer
 

data/bin/glimmer

@@ -21,6 +21,15 @@
 # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
+# This script was written for Windows and Linux only
+
+require_relative '../lib/glimmer-dsl-swt'
 require_relative '../lib/glimmer/launcher'
 
-Glimmer::Launcher.new(ARGV).launch
+# Initialize launcher, consuming ARGV args that are for Glimmer only
+launcher = Glimmer::Launcher.new(ARGV)
+
+# Set remaining ARGV args (starting with `-`) as JRuby options
+ENV['JRUBY_OPTS'] = ARGV.select {|arg| arg.start_with?('-')}.join(' ')
+
+launcher.launch

data/bin/glimmer-setup

@@ -0,0 +1,58 @@
+#!/usr/bin/env jruby
+
+# Copyright (c) 2020-2021 Andy Maleh
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'os'
+
+if OS.mac?
+  require 'fileutils'
+  home_dir = `echo ~`.strip
+  
+  [
+    ['.bash_profile', '.bashrc'],
+    ['.zprofile', '.zshrc']
+  ].each do |profile_and_fallback|
+    shell_profile_file_name = profile_and_fallback.first
+    shell_profile_file_name = profile_and_fallback.last if !File.exist?("#{home_dir}/#{shell_profile_file_name}")
+    shell_profile_file = "#{home_dir}/#{shell_profile_file_name}"
+    FileUtils.touch(shell_profile_file)
+    shell_profile = File.read(shell_profile_file)
+    glimmer_source_statement = 'export JRUBY_OPTS="$JRUBY_OPTS -J-XstartOnFirstThread"'
+    unless shell_profile.split("\n").detect {|line| line.include?(glimmer_source_statement) }
+      File.write(shell_profile_file, "#{shell_profile}\n#{glimmer_source_statement}")
+    end
+    puts "~/#{shell_profile_file_name} has been modified"
+  end
+  
+  puts <<~OUTPUT
+    
+    Before using `glimmer` or `girb`, start a new shell session in the same directory (open a new terminal tab and go to the same directory) or run the following command:
+    
+    export JRUBY_OPTS="$JRUBY_OPTS -J-XstartOnFirstThread"
+    
+    Afterwards, you may run the following commands:
+    
+    glimmer
+    girb
+    
+  OUTPUT
+end

data/bin/glimmer_runner.rb

@@ -0,0 +1,4 @@
+require_relative '../lib/glimmer-dsl-swt'
+require_relative '../lib/glimmer/launcher'
+
+Glimmer::Launcher.new(ARGV).launch

data/docs/reference/GLIMMER_COMMAND.md

@@ -166,15 +166,12 @@ $ glimmer scaffold[greeter]
   create  Rakefile
   create  Gemfile
   create  LICENSE.txt
-  create  README.rdoc
+  create  README.markdown
   create  .document
   create  lib
-  create  lib/greeter.rb
-  create  spec
-  create  spec/spec_helper.rb
-  create  spec/greeter_spec.rb
+  create  lib/snowboard_utah.rb
   create  .rspec
-Juwelier has prepared your gem in ./greeter
+Juwelier has prepared your gem in ./snowboard_utah
 Created greeter/.gitignore
 Created greeter/.ruby-version
 Created greeter/.ruby-gemset
@@ -183,17 +180,19 @@ Created greeter/LICENSE.txt
 Created greeter/Gemfile
 Created greeter/Rakefile
 Created greeter/app/greeter.rb
-Created greeter/app/views/greeter/app_view.rb
-Created greeter/package/windows/Greeter.ico
-Created greeter/package/macosx/Greeter.icns
-Created greeter/package/linux/Greeter.png
+Created greeter/app/greeter/view/app_view.rb
+Created greeter/package/windows/Snowboard Utah.ico
+Created greeter/package/macosx/Snowboard Utah.icns
+Created greeter/package/linux/Snowboard Utah.png
+Created greeter/app/greeter/launch.rb
 Created greeter/bin/greeter
-Created greeter/spec/spec_helper.rb
 ...
 ```
 
 Eventually, it will launch an advanced "Hello, World!" app window having the title of your application ("Greeter").
 
+(note: javapackager might claim at the end "Error: Bundler "DMG Installer" (dmg) failed to produce a bundle.", but it's a false negative since it works fully anyways)
+
 ![Glimmer Scaffold App](/images/glimmer-scaffolding-app.png)
 
 It also comes with a boilerplate Preferences dialog.
@@ -256,21 +255,6 @@ You should see output like the following:
 
 ```
 $ glimmer scaffold:desktopify[snowboard_utah,https://www.brightonresort.com]
-Fetching kamelcase-0.0.2.gem
-Fetching github_api-0.19.0.gem
-Fetching highline-2.0.3.gem
-Fetching juwelier-2.4.9.gem
-Fetching hashie-3.6.0.gem
-Fetching nokogiri-1.10.10-java.gem
-Fetching semver2-3.4.2.gem
-Successfully installed semver2-3.4.2
-Successfully installed kamelcase-0.0.2
-Successfully installed highline-2.0.3
-Successfully installed hashie-3.6.0
-Successfully installed github_api-0.19.0
-Successfully installed nokogiri-1.10.10-java
-Successfully installed juwelier-2.4.9
-7 gems installed
   create  .gitignore
   create  Rakefile
   create  Gemfile
@@ -289,16 +273,19 @@ Created snowboard_utah/LICENSE.txt
 Created snowboard_utah/Gemfile
 Created snowboard_utah/Rakefile
 Created snowboard_utah/app/snowboard_utah.rb
-Created snowboard_utah/app/views/snowboard_utah/app_view.rb
+Created snowboard_utah/app/snowboard_utah/view/app_view.rb
 Created snowboard_utah/package/windows/Snowboard Utah.ico
 Created snowboard_utah/package/macosx/Snowboard Utah.icns
 Created snowboard_utah/package/linux/Snowboard Utah.png
+Created snowboard_utah/app/snowboard_utah/launch.rb
 Created snowboard_utah/bin/snowboard_utah
 ...
 ```
 
 Eventually, it will launch a desktopified version of "https://www.brightonresort.com" having the title of ("Snowboard Utah").
 
+(note: javapackager might claim at the end "Error: Bundler "DMG Installer" (dmg) failed to produce a bundle.", but it's a false negative since it works fully anyways)
+
 Desktopified App on Mac
 
 ![Glimmer Scaffold App](/images/glimmer-scaffolding-desktopify.png)
@@ -570,10 +557,10 @@ Output:
 
   Glimmer Custom Shape Gems at rubygems.org:
                                                                                                      
-     Name                Gem             Version     Author                 Description              
+     Name                Gem             Version     Author                 Description
                                                                                                      
-  Bevel         glimmer-cp-bevel         0.1.1     Andy Maleh   Bevel - Glimmer Custom Shape         
-  Stickfigure   glimmer-cp-stickfigure   0.1.1     Andy Maleh   Stick Figure - Glimmer Custom Shape  
+  Bevel         glimmer-cp-bevel         0.1.1     Andy Maleh   Bevel - Glimmer Custom Shape
+  Stickfigure   glimmer-cp-stickfigure   0.1.1     Andy Maleh   Stick Figure - Glimmer Custom Shape
   
 ```
 
@@ -631,6 +618,8 @@ Or, the following on Mac:
 jruby -J-XstartOnFirstThread -r glimmer-dsl-swt -S application.rb
 ```
 
+Unless you ran `glimmer-setup`, which adds `JRUBY_OPTS` environment variable that includes the `-J-XstartOnFirstThread` option automatically so you would not have to specify manually.
+
 If you want to use a specific custom version of SWT, run the following on Windows/Linux:
 
 ```