glimmer-cw-cdatetime-nebula 1.4.0.2.0 → 1.5.0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b37eeaba86e192bbf3f0e00c57b267ab0c56e6574c310567489c23f1837c2190
-  data.tar.gz: 33f2acdd08fad52407236b598046aad6da491bdd61adc95c31ca89781acca617
+  metadata.gz: b2b27a5ece4803fbb7129f299f334db84f2e04a3493771b4450422960444feeb
+  data.tar.gz: aeb73d132ab04b909950c530699aa4ab32737c674318742e0331951f4ddb06c6
 SHA512:
-  metadata.gz: 173b9ff49a578b5e5952eb88513c6b5bf5518eb47036d915bbfc52bba7ce90906d93f6b4cb1cb1e7f825f9c22bca4c78bfb99263bb182d0021f96b146802eec4
-  data.tar.gz: a0b93d1badec9d7054197b44bfc3610b0f6ad0b8c5c329ae920c0d1ea083311c3335e7849ee0f32570b8b98eba7c5de60728347033f6ad9bb2d9054c89582864
+  metadata.gz: d4e3c7f7caa2e359da5ec4c799c573e18f3e35ca66d63b7b4aee3d5d4b72e73f8b0f39943a6d680f078b59a66f9272057e87fca41e8c6a3c2df2d295bbf3d036
+  data.tar.gz: 90080b9ed297c65bf21007debb9e6fe58a81513371bde8f25239e3e04e8b608b988341dcd17785f841f493e70a832f272cf41772762e55b015ebc6eb86805105

data/CHANGELOG.md

@@ -0,0 +1,49 @@
+# Change Log
+
+## 1.5.0.2.0
+
+- Support Glimmer DSL for Opal with `c_time`, `c_time_drop_down`, `c_time_compact`, `c_date`, and `c_date_drop_down`
+- Update c_date_time_gallery sample to use data-binding
+- c_date_time_gallery sample running in Glimmer DSL for Opal
+- Upgraded gem to a Rails Engine gem to share assets with a Rails app
+
+## 1.5.0.1.0
+
+- Upgraded to support glimmer-dsl-swt 4.17.2.0 up to 5.0.0.0
+
+## 1.5.0.0.1
+
+- Just corrected gem documentation to avoid mentioning older Nebula CDateTime 1.4.0
+
+## 1.5.0.0.0
+
+- Upgrade to Nebula CDateTime 1.5.0
+- Upgrade to Glimmer DSL for SWT 4.17.0.0
+
+## 1.4.0.2.1
+
+- Make sure `#text_widget_content` returns nil with plain style
+- Support c_date_time keyword aliases as a table editor
+- Fix issue with overwriting specified styles with default styles
+
+## 1.4.0.2.0
+
+- Actual CDateTimeProxy class that is a subclass of WidgetProxy
+- Smart defaults
+` `cdt` keyword for easily building `CDT` styles
+- `c_date`, `c_time` aliases for date only and time only
+- `c_date_time_drop_down`, `c_date_drop_down`, `c_time_drop_down` for drop down configured widgets
+- `c_date_time_spinner`, `c_date_spinner`, `c_time_spinner` for spinner configured widgets
+- `c_date_time_compact`, `c_date_compact`, `c_time_compact` for compact style configured widgets
+- `text_widget_proxy` method to retrieve a Glimmer widget proxy for the inner text widget of CDateTime, thus enabling direct adding of observers and data-binding
+- `toggle_open` method to programmatically toggle between open and closed (works better and is more convenient than `.swt_widget.set_open` in some situations)
+- Nebula CDateTime Glimmer Custom Widget Gallery [sample](samples/nebula/c_date_time_gallery.rb)
+
+## 1.4.0.1
+
+- Prevent table editor from saving upon traversing months in drop down Calendar
+
+## 1.4.0.0
+
+- Initial version containing a Glimmer configured and wrapped CDateTime Nebula custom widget
+- Support use as editor of Glimmer table items.

data/README.md

@@ -1,45 +1,51 @@
-# Nebula CDateTime Widget 1.4.0.2.0
-## [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=40 /> Glimmer Custom Widget](https://github.com/AndyObtiva/glimmer#custom-widget-gem)
+# Nebula CDateTime Widget 1.5.0.2.0
+## [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer-dsl-swt/master/images/glimmer-logo-hi-res.png" height=40 /> Glimmer Custom Widget](https://github.com/AndyObtiva/glimmer-dsl-swt#custom-widget-gem)
 [![Gem Version](https://badge.fury.io/rb/glimmer-cw-cdatetime-nebula.svg)](http://badge.fury.io/rb/glimmer-cw-cdatetime-nebula)
 
 [<img alt="Nebula CDateTime Widget" src="https://www.eclipse.org/nebula/widgets/cdatetime/images/CDTSnippet02.png" />](https://www.eclipse.org/nebula/widgets/cdatetime/cdatetime.php)
 
-The [Nebula CDateTime Widget](https://www.eclipse.org/nebula/widgets/cdatetime/cdatetime.php) is a Date and Time selection widget that can be used in a plain (graphical), dropdown, spinner, or compact text style.
+The [Nebula CDateTime Widget](https://www.eclipse.org/nebula/widgets/cdatetime/cdatetime.php) is a Date and Time selection widget that can be used in a simple, dropdown, spinner, or compact style.
 
-Packaged as a [Glimmer Custom Widget](https://github.com/AndyObtiva/glimmer#custom-widget-gem) to provide date/time selection via a combo/dropdown-style widget in [Glimmer](https://github.com/AndyObtiva/glimmer) using the `c_date_time` [Glimmer DSL](https://github.com/AndyObtiva/glimmer#glimmer-dsl-syntax) keyword.
+Packaged as a [Glimmer Custom Widget](https://github.com/AndyObtiva/glimmer-dsl-swt#custom-widget-gem) to provide date/time selection via a combo/dropdown-style widget in [Glimmer DSL for SWT](https://github.com/AndyObtiva/glimmer-dsl-swt) using the `c_date_time` [Glimmer DSL](https://github.com/AndyObtiva/glimmer-dsl-swt#glimmer-gui-dsl-syntax) keyword.
 
-[glimmer-cw-cdatetime-nebula](https://rubygems.org/gems/glimmer-cw-cdatetime-nebula) 1.4.0.x.y gem versions map to Nebula CDateTime Widget version 1.4.0
+Now, also supports [Glimmer DSL for Opal](#glimmer-dsl-for-opal) Auto-Webifier of Desktop Apps via Rails/Opal.
+
+[glimmer-cw-cdatetime-nebula](https://rubygems.org/gems/glimmer-cw-cdatetime-nebula) 1.5.0.x.y gem versions map to Nebula CDateTime Widget version 1.5.0 (which comes with [Nebula 2.4.2](https://www.eclipse.org/nebula/releases/2.4.2/index.php))
 
 ## Table of contents
 
-- [Nebula CDateTime Widget 1.4.0.2.0](#nebula-cdatetime-widget-14020)
+- [Nebula CDateTime Widget 1.5.0.2.0](#nebula-cdatetime-widget-15020)
   - [Pre-requisites](#pre-requisites)
   - [Setup](#setup)
-    - [Glimmer Application](#glimmer-application)
-    - [Glimmer Custom Shell or Glimmer Custom Widget](#glimmer-custom-shell-or-glimmer-custom-widget)
-    - [Java Imports](#java-imports)
+    - [Glimmer DSL for SWT](#glimmer-dsl-for-swt)
+      - [Glimmer Application](#glimmer-application)
+      - [Glimmer Custom Shell or Glimmer Custom Widget](#glimmer-custom-shell-or-glimmer-custom-widget)
+      - [Java Imports](#java-imports)
+    - [Glimmer DSL for Opal](#glimmer-dsl-for-opal)
+      - [Setup](#setup)
   - [Instructions](#instructions)
     - [Sample](#sample)
-    - [Plain](#plain)
+      - [Glimmer DSL for SWT Sample](#glimmer-dsl-for-swt-sample)
+      - [Glimmer DSL for Opal Sample](#glimmer-dsl-for-opal-sample)
+    - [Simple Style](#simple-style)
       - [`c_date_time`](#cdatetime)
       - [`c_date`](#cdate)
       - [`c_time`](#ctime)
-    - [Drop Down](#drop-down)
+    - [Drop Down Style](#drop-down-style)
       - [`c_date_time_drop_down`](#cdatetimedropdown)
       - [`c_date_drop_down`](#cdatedropdown)
       - [`c_time_drop_down`](#ctimedropdown)
-    - [Spinner](#spinner)
+    - [Spinner Style](#spinner-style)
       - [`c_date_time_spinner`](#cdatetimespinner)
       - [`c_date_spinner`](#cdatespinner)
       - [`c_time_spinner`](#ctimespinner)
-    - [Compact](#compact)
+    - [Compact Style](#compact-style)
       - [`c_date_time_compact`](#cdatetimecompact)
       - [`c_date_compact`](#cdatecompact)
       - [`c_time_compact`](#ctimecompact)
-    - [Style](#style)
-      - [`cdt`](#cdt)
+    - [`CDT` Style Arguments](#cdt-style-arguments)
     - [Data-Binding and Observers:](#data-binding-and-observers)
-    - [Table Editing](#table-editing)
+    - [Table Editor](#table-editor)
   - [API](#api)
     - [Glimmer Custom API](#glimmer-custom-api)
       - [`toggle_open`](#toggleopen)
@@ -51,22 +57,29 @@ Packaged as a [Glimmer Custom Widget](https://github.com/AndyObtiva/glimmer#cust
 
 ## Pre-requisites
 
-- [Glimmer](https://github.com/AndyObtiva/glimmer) application, [Glimmer](https://github.com/AndyObtiva/glimmer) custom shell, or another [Glimmer](https://github.com/AndyObtiva/glimmer) custom widget
-- JRuby version required by Glimmer
-- Java version required by Glimmer
+- [Glimmer DSL for SWT](https://github.com/AndyObtiva/glimmer-dsl-swt) application, [Glimmer](https://github.com/AndyObtiva/glimmer-dsl-swt) custom shell, or another [Glimmer](https://github.com/AndyObtiva/glimmer-dsl-swt) custom widget
+- JRuby version required by [Glimmer DSL for SWT](https://github.com/AndyObtiva/glimmer-dsl-swt)
+- Java version required by [Glimmer DSL for SWT](https://github.com/AndyObtiva/glimmer-dsl-swt)
+
+For [Glimmer DSL for Opal](https://github.com/AndyObtiva/glimmer-dsl-opal) auto-webification, this is also required:
+
+- [Glimmer DSL for Opal](https://github.com/AndyObtiva/glimmer-dsl-opal) Rails application
+- [Clocklet](https://github.com/luncheon/clocklet) (included in gem)
 
 ## Setup
 
 Versions follow this convention:
-- First 3 digits map to the official Nebula CDateTime library version (e.g. 1.4.0)
-- Last 2 digits map to minor and patch versions for Glimmer Custom Widget wrapper
+- First 3 numbers map to the official Nebula CDateTime library version (e.g. 1.5.0)
+- Last 2 numbers map to minor and patch versions for Glimmer Custom Widget wrapper
+
+### Glimmer DSL for SWT
 
-### Glimmer Application
+#### Glimmer Application
 
-Add the following to a [Glimmer](https://github.com/AndyObtiva/glimmer) application `Gemfile`:
+Add the following to a [Glimmer](https://github.com/AndyObtiva/glimmer-dsl-swt) application `Gemfile`:
 
 ```ruby
-gem 'glimmer-cw-cdatetime-nebula', '1.4.0.2.0'
+gem 'glimmer-cw-cdatetime-nebula', '~> 1.5.0.2.0'
 ```
 
 Run:
@@ -77,9 +90,9 @@ jruby -S bundle
 
 (or just `bundle` if using [RVM)
 
-### Glimmer Custom Shell or Glimmer Custom Widget
+#### Glimmer Custom Shell or Glimmer Custom Widget
 
-When reusing in a [Glimmer](https://github.com/AndyObtiva/glimmer) custom shell or custom widget, you can follow the same steps for Glimmer application, and then add a require statement to your library file after `glimmer-dsl-swt` and before additional library require statements:
+When reusing in a [Glimmer](https://github.com/AndyObtiva/glimmer-dsl-swt) custom shell or custom widget, you can follow the same steps for Glimmer application, and then add a require statement to your library file after `glimmer-dsl-swt` and before additional library require statements:
 
 ```ruby
 require 'glimmer-dsl-swt'
@@ -87,17 +100,48 @@ require 'glimmer-cw-cdatetime-nebula'
 # ... more require statements follow
 ```
 
-### Java Imports
+#### Java Imports
 
-Requiring the gem automatically configures java imports in [Glimmer](https://github.com/AndyObtiva/glimmer) for auto import via [JRuby](https://www.jruby.org/) `include_package` on first use:
+Requiring the gem automatically configures java imports in [Glimmer](https://github.com/AndyObtiva/glimmer-dsl-swt) for auto import via [JRuby](https://www.jruby.org/) `include_package` on first use:
 - `org.eclipse.nebula.cwt`
 - `org.eclipse.nebula.widgets.cdatetime`
 
-## Usage Instructions
+### Glimmer DSL for Opal
+
+The [glimmer-cw-cdatetime-nebula](https://rubygems.org/gems/glimmer-cw-cdatetime-nebula) gem is a Rails Engine gem that includes assets and supports [Glimmer DSL for Opal](https://github.com/AndyObtiva/glimmer-dsl-opal).
+
+#### Setup
+
+Please follow the following steps to setup assuming you have a pre-setup [Glimmer DSL for Opal](https://github.com/AndyObtiva/glimmer-dsl-opal) Rails app.
+
+Add the following to `Gemfile` after `glimmer-dsl-opal` and other `glimer-dsl-*` gems:
+
+```ruby
+gem 'glimmer-cw-cdatetime-nebula', '~> 1.5.0.2.0'
+```
+
+Edit `app/views/layouts/application.html.erb` and add the following below other `stylesheet_link_tag` declarations:
+
+```erb
+<%= stylesheet_link_tag    'glimmer_cw_cdatetime_nebula/glimmer_cw_cdatetime_nebula', media: 'all', 'data-turbolinks-track': 'reload' %>
+```
+
+That's it! Now, you can use the following keywords:
+- `c_date`
+- `c_time`
+- `c_date_drop_down`
+- `c_time_drop_down`
+- `c_time_compact`
 
-This [glimmer-cw-cdatetime-nebula](https://rubygems.org/gems/glimmer-cw-cdatetime-nebula) gem adds the `c_date_time` keyword to the [Glimmer GUI DSL](https://github.com/AndyObtiva/glimmer#glimmer-dsl-syntax) as well as other alias keywords as explained below.
+Here is a sample Rails app that has everything configured (you just have to edit `app/assets/javascripts/application.rb` to enable the desired sample):
 
-The `c_date_time` keyword takes [`CDT`](#cdt) style bits as arguments.
+https://github.com/AndyObtiva/sample-glimmer-dsl-opal-rails5-app
+
+## Instructions
+
+This [glimmer-cw-cdatetime-nebula](https://rubygems.org/gems/glimmer-cw-cdatetime-nebula) gem adds the `c_date_time` keyword to the [Glimmer GUI DSL](https://github.com/AndyObtiva/glimmer-dsl-swt#glimmer-gui-dsl-syntax) as well as other alias keywords (e.g. drop down style, spinner style, and compact style) as explained below.
+
+The `c_date_time` keyword optionally takes [`CDT`](#cdt) style bits as arguments. When not specified, [smart defaults](https://github.com/AndyObtiva/glimmer-cw-cdatetime-nebula#cdt-style-arguments) are used instead.
 
 Example:
 
@@ -109,85 +153,264 @@ Further instructions may be found at the [Nebula CDateTime Widget homepage](http
 
 ### Sample
 
+#### Glimmer DSL for SWT Sample
+
 Please run the following command to launch the [Nebula CDateTime Glimmer Custom Widget Gallery](samples/nebula/c_date_time_gallery.rb) app:
 
 ```
 glimmer sample:run[c_date_time_gallery]
 ```
 
-### Plain
+Glimmer Code:
+
+```ruby
+require_relative '../../lib/glimmer-cw-cdatetime-nebula'
+
+class CDateTimeGallery
+  include Glimmer
+  
+  def open
+    shell {
+      grid_layout(4, false) {
+        vertical_spacing 20
+      }
+      text 'Nebula CDateTime Glimmer Custom Widget Gallery'
+      
+      label {
+        layout_data(:center, :center, true, false) {
+          horizontal_span 4
+        }
+        text 'Nebula CDateTime Glimmer Custom Widget Gallery'
+        font height: 24, style: :bold
+      }
+      
+      tab_folder {
+        tab_item {
+          grid_layout 2, false
+          text 'Simple'
+          
+          label {
+            text 'c_date_time'
+            font name: 'Consolas', height: 14
+          }
+          c_date_time
+          
+          label {
+            text 'c_date'
+            font name: 'Consolas', height: 14
+          }
+          c_date
+          
+          label {
+            text 'c_time'
+            font name: 'Consolas', height: 14
+          }
+          c_time
+        }
+         
+        tab_item {
+          grid_layout 2, false
+          text 'Drop Down'
+          
+          label {
+            text 'c_date_time_drop_down'
+            font name: 'Consolas', height: 14
+          }
+          c_date_time_drop_down {
+            layout_data(:fill, :center, true, true)
+          }
+           
+          label {
+            text 'c_date_drop_down'
+            font name: 'Consolas', height: 14
+          }
+          c_date_drop_down {
+            layout_data(:fill, :center, true, true)
+          }
+           
+          label {
+            text 'c_time_drop_down'
+            font name: 'Consolas', height: 14
+          }
+          c_time_drop_down {
+            layout_data(:fill, :center, true, true)
+          }
+        }
+         
+        tab_item {
+          grid_layout 2, false
+          text 'Spinner'
+          
+          label {
+            text 'c_date_time_spinner'
+            font name: 'Consolas', height: 14
+          }
+          c_date_time_spinner {
+            layout_data(:fill, :center, true, true)
+          }
+           
+          label {
+            text 'c_date_spinner'
+            font name: 'Consolas', height: 14
+          }
+          c_date_spinner {
+            layout_data(:fill, :center, true, true)
+          }
+           
+          label {
+            text 'c_time_spinner'
+            font name: 'Consolas', height: 14
+          }
+          c_time_spinner {
+            layout_data(:fill, :center, true, true)
+          }
+        }
+              
+        tab_item {
+          grid_layout 2, false
+          text 'Compact'
+          
+          label {
+            text 'c_date_time_compact'
+            font name: 'Consolas', height: 14
+          }
+          c_date_time_compact {
+            layout_data(:fill, :center, true, true)
+          }
+           
+          label {
+            text 'c_date_compact'
+            font name: 'Consolas', height: 14
+          }
+          c_date_compact {
+            layout_data(:fill, :center, true, true)
+          }
+           
+          label {
+            text 'c_time_compact'
+            font name: 'Consolas', height: 14
+          }
+          c_time_compact {
+            layout_data(:fill, :center, true, true)
+          }
+        }
+      }
+    }.open
+  end
+end
+
+CDateTimeGallery.new.open
+```
+
+#### Glimmer DSL for Opal Sample
+
+The same Glimmer DSL for SWT sample runs in Glimmer DSL for Opal unchanged, albeit with partial support at the moment.
+
+Open a `Document.ready?` block in `app/assets/javascripts/application.rb` and add inside it the Glimmer GUI DSL code above or a require statement as done below.
+
+```ruby
+require 'glimmer-dsl-opal'
+
+Document.ready? do
+  require 'samples/nebula/c_date_time_gallery.rb'
+end
+```
+
+Run:
+
+`rails s`
+
+Visit: 'http://localhost:3000'
+
+![simple screenshot](images/glimmer-cw-cdatetime-nebula-opal-simple.png)
 
-![plain screenshot](images/glimmer-cw-cdatetime-nebula-plain.png)
+### Simple Style
+
+Simple style is the default style when using `c_date_time`, `c_date`, and `c_time` keywords. It displays a graphical calendar/clock.
+
+`CDT::SIMPLE` style is applied by default but may be overriden by manually passing arguments to the keywords.
+
+![simple screenshot](images/glimmer-cw-cdatetime-nebula-simple.png)
 
 #### `c_date_time`
 
-Main keyword representing the Nebula CDateTime custom widget. Defaults to date/time pattern `'MM/dd/yyyy hh:mm a'` and plain style with a border
+Main keyword representing the Nebula CDateTime custom widget. Defaults to date/time [pattern](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html) `'MM/dd/yyyy hh:mm a'` and simple style with a border
 
 #### `c_date`
 
-Alias keyword that specifies date pattern `'MM/dd/yyyy'` and plain style with a border
+Alias keyword that specifies date [pattern](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html) `'MM/dd/yyyy'` and simple style with a border
 
 #### `c_time`
 
-Alias keyword that specifies time pattern `'hh:mm a'` and plain style with a border
+Alias keyword that specifies time [pattern](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html) `'hh:mm a'` and simple style with a border
+
+### Drop Down Style
 
-### Drop Down
+Drop down style is used with the `c_date_time_drop_down`, `c_date_drop_down`, and `c_time_drop_down` keywords to provide a text box for textual entry of date/time coupled with a drop down button for bringing up the calendar/clock to perform graphical selection.
 
-![plain screenshot](images/glimmer-cw-cdatetime-nebula-drop-down.png)
+`CDT::DROP_DOWN` style is applied by default but may be overriden by manually passing arguments to the keywords.
+
+![dropdown screenshot](images/glimmer-cw-cdatetime-nebula-drop-down.png)
 
 #### `c_date_time_drop_down`
 
-Alias keyword that specifies date/time pattern `'MM/dd/yyyy hh:mm a'` and drop down style with a border
+Alias keyword that specifies date/time [pattern](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html) `'MM/dd/yyyy hh:mm a'` and drop down style with a border
 
-![plain screenshot](images/glimmer-cw-cdatetime-nebula-drop-down-date-time.png)
+![date time dropdown screenshot](images/glimmer-cw-cdatetime-nebula-drop-down-date-time.png)
 
 #### `c_date_drop_down`
 
-Alias keyword that specifies date pattern `'MM/dd/yyyy'` and drop down style with a border
+Alias keyword that specifies date [pattern](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html) `'MM/dd/yyyy'` and drop down style with a border
 
-![plain screenshot](images/glimmer-cw-cdatetime-nebula-drop-down-date.png)
+![date dropdown screenshot](images/glimmer-cw-cdatetime-nebula-drop-down-date.png)
 
 #### `c_time_drop_down`
 
-Alias that specifies time pattern `'hh:mm a'` and drop down style with a border
+Alias that specifies time [pattern](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html) `'hh:mm a'` and drop down style with a border
+
+![time dropdown screenshot](images/glimmer-cw-cdatetime-nebula-drop-down-time.png)
+
+### Spinner Style
 
-![plain screenshot](images/glimmer-cw-cdatetime-nebula-drop-down-time.png)
+Spinner style is used with the `c_date_time_spinner`, `c_date_spinner`, and `c_time_spinner` keywords to provide a spinner for textual entry of date/time accompanied by up and down spinner buttons.
 
-### Spinner
+`CDT::SPINNER` style is applied by default but may be overriden by manually passing arguments to the keywords.
 
-![plain screenshot](images/glimmer-cw-cdatetime-nebula-spinner.png)
+![spinner screenshot](images/glimmer-cw-cdatetime-nebula-spinner.png)
 
 #### `c_date_time_spinner`
 
-Alias that specifies date/time pattern `'MM/dd/yyyy hh:mm a'` and spinner style with a border
+Alias that specifies date/time [pattern](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html) `'MM/dd/yyyy hh:mm a'` and spinner style with a border
 
 #### `c_date_spinner`
 
-Alias that specifies date pattern `'MM/dd/yyyy'` and spinner style with a border
+Alias that specifies date [pattern](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html) `'MM/dd/yyyy'` and spinner style with a border
 
 #### `c_time_spinner`
 
-Alias that specifies time pattern `'hh:mm a'` and spinner style with a border
+Alias that specifies time [pattern](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html) `'hh:mm a'` and spinner style with a border
 
-### Compact
+### Compact Style
 
-![plain screenshot](images/glimmer-cw-cdatetime-nebula-compact.png)
+Compact style is used with the `c_date_time_compact`, `c_date_compact`, and `c_time_compact` keywords to provide a compact text widget for date/time without any extra buttons.
+
+`CDT::COMPACT` style is applied by default but may be overriden by manually passing arguments to the keywords.
+
+![compact screenshot](images/glimmer-cw-cdatetime-nebula-compact.png)
 
 #### `c_date_time_compact`
 
-Alias that specifies date/time pattern `'MM/dd/yyyy hh:mm a'` and compact style (just a text field) with a border
+Alias that specifies date/time [pattern](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html) `'MM/dd/yyyy hh:mm a'` and compact style (just a text field) with a border
 
 #### `c_date_compact`
 
-Alias that specifies date pattern `'MM/dd/yyyy'` and compact style (just a text field) with a border
+Alias that specifies date [pattern](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html) `'MM/dd/yyyy'` and compact style (just a text field) with a border
 
 #### `c_time_compact`
 
-Alias that specifies time pattern `'hh:mm a'` and compact style (just a text field) with a border
+Alias that specifies time [pattern](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html) `'hh:mm a'` and compact style (just a text field) with a border
 
-### Style
-
-#### `cdt`
+### `CDT` Style Arguments
 
 [`CDT`](https://www.eclipse.org/nebula/releases/latest/javadoc/org/eclipse/nebula/widgets/cdatetime/CDT.html) styles are fully documented in the [Nebula `CDT` Javadoc](https://www.eclipse.org/nebula/releases/latest/javadoc/org/eclipse/nebula/widgets/cdatetime/CDT.html).
 
@@ -196,19 +419,19 @@ The `cdt` keyword builds a [`CDT`](https://www.eclipse.org/nebula/releases/lates
 For example, instead of passing style as bit-or'ed `CDT` Constant style bits:
 
 ```ruby
-c_date_time(CDT::BORDER | CDT::COMPACT | CDT::DROP_DOWN | CDT::DATE_LONG)
+c_date_time(CDT::BORDER | CDT::TAB_FIELDS | CDT::DROP_DOWN | CDT::DATE_LONG)
 ```
 
 You instead pass style as comma-separated symbols:
 
 ```ruby
-c_date_time(cdt(:border, :compact, :drop_down, :date_long))
+c_date_time(cdt(:border, :tab_fields, :drop_down, :date_long))
 ```
 
 However, `c_date_time` goes one step further and uses it internally automatically by all `c_date_time` keyword initializers, so you could ditch the `cdt` entirely when constructing a widget.
 
 ```ruby
-c_date_time(:border, :compact, :drop_down, :date_long)
+c_date_time(:border, :tab_fields, :drop_down, :date_long)
 ```
 
 Furthermore, `c_date_time` has pre-configured smart defaults for `CDT` styles:
@@ -235,7 +458,7 @@ The `selection` property provides access to the value selected by the user. It c
 Example:
 
 ```ruby
-# ... 
+# ...
   composite {
     # ...
     @start_at = c_date_time(:border, :drop_down, :date_long) {
@@ -251,9 +474,9 @@ Example:
 
 ![Nebula CDateTime Example](images/glimmer-cw-cdatetime-nebula-example.png)
 
-### Table Editing
+### Table Editor
 
-`c_date_time` can be used as a `table` / `table_column` editor.
+`c_date_time` (and any keyword aliases) can be used as a `table` / `table_column` editor by passing as symbol to `editor` property (optionally followed by args model editing property).
 
 Example:
 
@@ -269,7 +492,7 @@ Example:
     table_column {
       text 'End Date'
       width CONFIG[:table_column_width_hint]
-      editor :c_date_time, cdt(:border, :drop_down, :date_long), property: :end_at
+      editor :c_date_drop_down, property: :end_at
     }
     # ... other table_column declarations
     items bind(Task, :list), column_properties(:project_name, :task_type, :name, :start_date, :end_date, :duration, :priority)
@@ -284,6 +507,20 @@ Example:
 
 You may check out the Nebula CDateTime Widget [Javadoc API](https://www.eclipse.org/nebula/releases/latest/javadoc/org/eclipse/nebula/widgets/cdatetime/CDateTime.html).
 
+One noteworthy property is [pattern](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html), which can be customized according to the date/time pattern [SimpleDateFormat Javadoc](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html).
+
+Example:
+
+```ruby
+c_date_time(:border, :drop_down) {
+  pattern 'hh:mm a'
+}
+```
+
+This should customize `c_date_time` to function just like `c_time_drop_down`
+
+![time drop down screenshot](images/glimmer-cw-cdatetime-nebula-drop-down-time.png)
+
 ### Glimmer Custom API
 
 Glimmer adds a few extra API methods to CDateTime from Nebula.
@@ -302,13 +539,12 @@ Example:
 c_time { |proxy|
   proxy.text_widget_proxy.content {
     on_swt_mouseup { |event|
-    	 proxy.toggle_open
+      proxy.toggle_open
     }
   }
 }
 ```
 
-
 ## TODO
 
 [TODO.md](TODO.md)
@@ -335,4 +571,4 @@ Copyright (c) 2020 - 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) (Ruby Desktop Development GUI Library).
+[<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 DSL for SWT](https://github.com/AndyObtiva/glimmer-dsl-swt) (Ruby Desktop Development GUI Library).