glimmer-dsl-swt 4.18.7.7 → 4.19.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ea8c8ccaf5bed68b086f7152510acf44d0ce50026d3d6ddc6d6f5a2bff9a75c
-  data.tar.gz: f492f57e327e40fe4995b1b38ba737cc7dce46f48c6955581514812c4b873a68
+  metadata.gz: 2a6d3f8e7bb2a7212ba94580c1293d23205f7eba98da2dacc2be280546f8a048
+  data.tar.gz: 56e3d8a75782146d32d3c59eecbb1528d53879c41ac5754dd3afe95809f9a566
 SHA512:
-  metadata.gz: d5d460f70cc1eadab8e75d973b264e0c98833ddac519065b9449abb74a43bea201b2d31b70e20904647cc56c006b604bdf85b5648865842b103ad3e5a6e57ebc
-  data.tar.gz: 2007bd5c63d1141670973bbe2fc6254dabea7f74695716e542aa39322f25f5badaefc2b3cdfd70d33114920bdc58e4f902efb9e51718a3c64d7611c3e6720140
+  metadata.gz: e3ec40fd6f34affc274aab6de90f9ae7798de2292a687adca7655298b46c87130b72aabe222c7aac1b585ec3ed5675638a11fc12084900891914077aec593f74
+  data.tar.gz: 4d312fd5501bac1cebeeeaa04c61113be221a28cc3a812c3d9adc20b650f2c5dd3ef4c0a95d617f903bd1cdc64193b754bbde8facee2367acf7f592f0e6f8803

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Change Log
 
+### 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

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.7
+# [<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.19.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)
@@ -15,7 +15,7 @@
 [<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.7 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.19.0.0 includes [SWT 4.19](https://download.eclipse.org/eclipse/downloads/drops4/R-4.19-202103031800/), which was released on March 3, 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.
 
 [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.
 
@@ -308,14 +308,14 @@ 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)
+- JRuby 9.2.16.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.19 (already included in the [glimmer-dsl-swt](https://rubygems.org/gems/glimmer-dsl-swt) gem)
 - 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
+rvm install jruby-9.2.16.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.
@@ -342,13 +342,23 @@ jgem install glimmer-dsl-swt
 
 Or this command if you want a specific version:
 ```
-jgem install glimmer-dsl-swt -v 4.18.7.7
+jgem install glimmer-dsl-swt -v 4.19.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 +370,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.7'
+gem 'glimmer-dsl-swt', '~> 4.19.0.0'
 ```
 
 And, then run:
@@ -381,7 +391,7 @@ glimmer
 ```
 
 ```
-Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.18.7.7
+Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.19.0.0
       
 Usage: glimmer [--bundler] [--pd] [--quiet] [--debug] [--log-level=VALUE] [[ENV_VAR=VALUE]...] [[-jruby-option]...] (application.rb or task[task_args]) [[application2.rb]...]
 

data/RUBY_VERSION

@@ -1 +1 @@
-jruby-9.2.14.0
+jruby-9.2.16.0

data/VERSION

@@ -1 +1 @@
-4.18.7.7
+4.19.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:
 
 ```

data/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md

@@ -368,7 +368,7 @@ These proxy objects have an API and provide some convenience methods, some of wh
 
 Glimmer SWT proxies come with the instance method `#swt_widget`, which returns the actual SWT `Widget` object wrapped by the Glimmer widget proxy. It is useful in cases you'd like to do some custom SWT programming outside of Glimmer.
 
-##### Shell widget proxy methods
+##### Shell Widget Proxy Methods
 
 Shell widget proxy has extra methods specific to SWT Shell:
 - `#open`: Opens the shell, making it visible and active, and starting the SWT Event Loop (you may learn more about it here: https://help.eclipse.org/2019-12/nftopic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/widgets/Display.html). If shell was already open, but hidden, it makes the shell visible.
@@ -1040,6 +1040,10 @@ shell(:no_resize) {
 }
 ```
 
+##### Fill Screen Window
+
+SWT Shell can open and fill the screen with this style `swt(:fill_screen)`. This makes it have the size of the display, thus filling the screen. Keep in mind that this is different from being maximized (which is a special window state, not just filling the screen).
+
 ### Widget Properties
 
 Widget properties such as text value, enablement, visibility, and layout details are set within the widget block using methods matching SWT widget property names in lower snakecase. You may refer to SWT widget guide for details on available widget properties:
@@ -3471,7 +3475,7 @@ shell { |app_shell|
 }.open
 ```
 
-If you use a Custom Shell as the top-level app shell, you may invoke the class method `::launch` instead to avoid building an app class yourself or including Glimmer into the top-level namespace (e.g. `Tetris.launch` instead of `include Glimmer; tetris.open`)
+If you use a Custom Shell as the top-level app shell, you may invoke the class method `.launch` instead to avoid building an app class yourself or including Glimmer into the top-level namespace (e.g. `Tetris.launch` instead of `include Glimmer; tetris.open`)
 
 You may check out [Hello, Custom Shell!](GLIMMER_SAMPLES.md#hello-custom-shell) for another example.
 

data/docs/reference/GLIMMER_PACKAGING_AND_DISTRIBUTION.md

@@ -20,6 +20,12 @@ You may choose to generate a specific type of packaging instead by addionally pa
 glimmer package[msi]
 ```
 
+Make sure to surround with double-quotes when running from ZShell (zsh):
+
+```
+glimmer "package[msi]"
+```
+
 - Available Mac packaging types are `dmg`, `pkg`, and `image` (image means a pure Mac `app` without a setup program). Keep in mind that the packages you produce are compatible with the same MacOS you are on or older.
 - Available Windows packaging types are `msi`, `exe`, and `image` (image means a Windows application directory without a setup program). Learn more about Windows packaging are [over here](#windows-application-packaging).
 
@@ -190,7 +196,7 @@ Currently, `Glimmer::RakeTask::Package.javapackager_extra_args` is only honored
 You can get around that in zsh by running glimmer package commands with `bash -c` prefix:
 
 ```
-bash -c 'glimmer package'
+bash -c 'source ~/.glimmer_source; glimmer package'
 ```
 
 4. Java on Windows System PATH

data/docs/reference/GLIMMER_SAMPLES.md

@@ -2,7 +2,9 @@
   - [Hello Samples](#hello-samples)
     - [Hello, World!](#hello-world)
     - [Hello, Tab!](#hello-tab)
+    - [Hello, C Tab!](#hello-c-tab)
     - [Hello, Combo!](#hello-combo)
+    - [Hello, C Combo!](#hello-c-combo)
     - [Hello, List Single Selection!](#hello-list-single-selection)
     - [Hello, List Multi Selection!](#hello-list-multi-selection)
     - [Hello, Computed!](#hello-computed)
@@ -101,6 +103,18 @@ Code:
 ![Hello Tab English](/images/glimmer-hello-tab-english.png)
 ![Hello Tab French](/images/glimmer-hello-tab-french.png)
 
+#### Hello, C Tab!
+
+This sample demonstrates custom tab widget usage (`c_tab_folder` and `c_tab_item`), which supports more customizations to tab fonts/background/foreground colors and display of extra additional tabs via a drop down.
+
+Code:
+
+[samples/hello/hello_c_tab.rb](/samples/hello/hello_c_tab.rb)
+
+![Hello C Tab](/images/glimmer-hello-c-tab.png)
+![Hello C Tab Extra Tabs](/images/glimmer-hello-c-tab-extra-tabs.png)
+![Hello C Tab Other Tab](/images/glimmer-hello-c-tab-other-tab.png)
+
 #### Hello, Combo!
 
 This sample demonstrates combo data-binding.
@@ -112,6 +126,17 @@ Code:
 ![Hello Combo](/images/glimmer-hello-combo.png)
 ![Hello Combo Expanded](/images/glimmer-hello-combo-expanded.png)
 
+#### Hello, C Combo!
+
+This sample demonstrates the custom combo variation on combo, which allows the adjustment of the combo height based on font height or layout data.
+
+Code:
+
+[samples/hello/hello_c_combo.rb](/samples/hello/hello_c_combo.rb)
+
+![Hello Combo](/images/glimmer-hello-c-combo.png)
+![Hello Combo Expanded](/images/glimmer-hello-c-combo-expanded.png)
+
 #### Hello, List Single Selection!
 
 This sample demonstrates list single-selection data-binding.