cosmos 3.8.3 → 3.9.1

data/demo/config/tools/table_manager/MCConfigurationTable_fsw2_def.txt

@@ -1,25 +1,33 @@
-TABLE "MC Configuration" "Memory Control Configuration Table" ONE_DIMENSIONAL BIG_ENDIAN 9
-  PARAMETER "Scrub Region 1 Start Addr" "Scrub Region 1 Start Address" UINT 32 HEX 0 0x03FFFFFB 0 
-  PARAMETER "Scrub Region 1 End Addr" "Scrub Region 1 End Address" UINT 32 HEX 0 0x03FFFFFF 0x03FFFFFF 
-  PARAMETER "Scrub Region 1 Error Check Size" "Scrub Region 1 Error Check Size" UINT 32 HEX 0 0x03FFFFFB 0x10000 
-  PARAMETER "Scrub Region 1 Throttle Count" "Scrub Region 1 Throttle Count" UINT 32 DEC 0 0x03FFFFFF 6000 
-  PARAMETER "Scrub Region 1 Throttle Ticks" "Scrub Region 1 Throttle Ticks" UINT 32 DEC 0 0x0FFFFFFFF 2 
-  PARAMETER "Scrub Region 2 Start Addr" "Scrub Region 2 Start Address" UINT 32 HEX 0 0x03FFFFB 0 
-  PARAMETER "Scrub Region 2 End Addr" "Scrub Region 2 End Address" UINT 32 HEX 0 0x03FFFFF 0x03FFFFF 
-  PARAMETER "Scrub Region 2 Error Check Size" "Scrub Region 2 Error Check Size" UINT 32 HEX 0 0x03FFFFF 0x10000 
-  PARAMETER "Scrub Region 2 Throttle Count" "Scrub Region 2 Throttle Count" UINT 32 DEC 0 0x03FFFFF 6000 
-  PARAMETER "Scrub Region 2 Throttle Ticks" "Scrub Region 2 Throttle Ticks" UINT 32 DEC 0 0x0FFFFFFFF 2 
-  PARAMETER "Dump Packet Throttle (sec)" "Number of seconds to wait between dumping large (>65k) packets" UINT 32 DEC 0 0x0FFFFFFFF 2 
-  PARAMETER "Memory Scrubbing" "Memory Scrubbing" UINT 8     STATE 0 1 1 
+TABLE "MC Configuration" BIG_ENDIAN ONE_DIMENSIONAL "Memory Control Configuration Table"
+  APPEND_PARAMETER "Scrub Region 1 Start Addr" 32 UINT 0 0x03FFFFFB 0
+    FORMAT_STRING "0x%0X"
+  APPEND_PARAMETER "Scrub Region 1 End Addr" 32 UINT 0 0x03FFFFFF 0x03FFFFFF
+    FORMAT_STRING "0x%0X"
+  APPEND_PARAMETER "Scrub Region 1 Error Check Size" 32 UINT 0 0x03FFFFFB 0x10000
+    FORMAT_STRING "0x%0X"
+  APPEND_PARAMETER "Scrub Region 1 Throttle Count" 32 UINT 0 0x03FFFFFF 6000
+    FORMAT_STRING "0x%0X"
+  APPEND_PARAMETER "Scrub Region 1 Throttle Ticks" 32 UINT 0 0x0FFFFFFFF 2
+    FORMAT_STRING "0x%0X"
+  APPEND_PARAMETER "Scrub Region 2 Start Addr" 32 UINT 0 0x03FFFFB 0
+    FORMAT_STRING "0x%0X"
+  APPEND_PARAMETER "Scrub Region 2 End Addr" 32 UINT 0 0x03FFFFF 0x03FFFFF
+    FORMAT_STRING "0x%0X"
+  APPEND_PARAMETER "Scrub Region 2 Error Check Size" 32 UINT 0 0x03FFFFF 0x10000
+    FORMAT_STRING "0x%0X"
+  APPEND_PARAMETER "Scrub Region 2 Throttle Count" 32 UINT 0 0x03FFFFF 6000
+  APPEND_PARAMETER "Scrub Region 2 Throttle Ticks" 32 UINT 0 0x0FFFFFFFF 2
+  APPEND_PARAMETER "Dump Packet Throttle (sec)" 32 UINT 0 0x0FFFFFFFF 2 "Number of seconds to wait between dumping large packets"
+  APPEND_PARAMETER "Memory Scrubbing" 8 UINT 0 1 1
     STATE DISABLE 0 
     STATE ENABLE 1 
-  PARAMETER "SIOC Memory Config" "SIOC Memory Config" UINT 8 DEC 1 3 3 
-    CONSTRAINT_START
-      if packet.read("Memory Scrubbing") == 'DISABLE'
-        packet.get_item("SIOC Memory Config").range = (10..20)
-      else
-        packet.get_item("SIOC Memory Config").range = (1..3)
-      end
-    CONSTRAINT_END
-  PARAMETER "Pad" "Pad" UINT 16 HEX-U 0 0 0 
+  APPEND_PARAMETER "SIOC Memory Config" 8 UINT 1 3 3
+    #CONSTRAINT_START
+    #  if packet.read("Memory Scrubbing") == 'DISABLE'
+    #    packet.get_item("SIOC Memory Config").range = (10..20)
+    #  else
+    #    packet.get_item("SIOC Memory Config").range = (1..3)
+    #  end
+    #CONSTRAINT_END
+  APPEND_PARAMETER "Pad" 16 UINT 0 0 0 
 

data/demo/config/tools/table_manager/PPSSelectionTable_def.txt

@@ -1,8 +1,9 @@
-TABLE "PPS Selection" "Payload Clock Control Pulse Per Second Selection Table" ONE_DIMENSIONAL BIG_ENDIAN 10
-  PARAMETER "Primary PPS" "Primary PPS" UINT 8     STATE 0 1 1 
-    STATE DISABLE 0 
-    STATE ENABLE 1 
-  PARAMETER "Redundant PPS" "Redundant PPS" UINT 8     STATE 0 1 0 
-    STATE DISABLE 0 
-    STATE ENABLE 1 
+TABLE "PPS Selection" BIG_ENDIAN ONE_DIMENSIONAL "Payload Clock Control Pulse Per Second Selection Table"
+  APPEND_PARAMETER "Primary PPS" 8 UINT 0 1 1
+    STATE CHECKED 1
+    STATE UNCHECKED 0
+  APPEND_PARAMETER "Redundant PPS" 8 UINT 0 1 1
+    UNEDITABLE
+    STATE UNCHECKED 0
+    STATE CHECKED 1
 

data/demo/config/tools/table_manager/TLMMonitoringTable_def.txt

@@ -1,31 +1,31 @@
-TABLE "TLM Monitoring" "Telemetry Monitoring Table" TWO_DIMENSIONAL BIG_ENDIAN 4
-  PARAMETER "Threshold" "Telemetry item threshold at which point persistance is incremented" UINT 32 HEX 0 4294967295 0 
-  PARAMETER "Offset" "Offset into the telemetry packet to monitor" UINT 32 DEC 0 4294967295 0 
-  PARAMETER "Data Size" "Amount of data to monitor (bytes)" UINT 32 STATE 0 3 0 
+TABLE "TLM Monitoring" BIG_ENDIAN TWO_DIMENSIONAL 200 "Telemetry Monitoring Table" 
+  APPEND_PARAMETER "Threshold" 32 UINT MIN MAX 0 "Telemetry item threshold at which point persistance is incremented"
+  APPEND_PARAMETER "Offset" 32 UINT MIN MAX 0 "Offset into the telemetry packet to monitor"
+  APPEND_PARAMETER "Data Size" 32 UINT 0 3 0 "Amount of data to monitor (bytes)"
     STATE BITS 0 
     STATE BYTE 1 
     STATE WORD 2 
     STATE LONGWORD 3 
-  PARAMETER "Bit Mask" "Bit Mask to apply to the Data Size before the value is compared ot the Threshold" UINT 32 HEX 0 4294967295 0 
-  PARAMETER "Persistence" "Number of times the Threshold must be exceeded before Action is triggered" UINT 32 DEC 0 4294967295 0 
-  PARAMETER "Type" "How the Threshold is compared against" UINT 32 STATE 0 3 0 
+  APPEND_PARAMETER "Bit Mask" 32 UINT MIN MAX 0 "Bit Mask to apply to the Data Size before the value is compared ot the Threshold"
+  APPEND_PARAMETER "Persistence" 32 UINT MIN MAX 0 "Number of times the Threshold must be exceeded before Action is triggered"
+  APPEND_PARAMETER "Type" 32 UINT 0 3 0 "How the Threshold is compared against"
     STATE LESS_THAN 0 
     STATE GREATER_THAN 1 
     STATE EQUAL_TO 2 
     STATE NOT_EQUAL_TO 3 
-  PARAMETER "Action" "Action to take when Persistance is met" UINT 32 STATE 0 4 0 
+  APPEND_PARAMETER "Action" 32 UINT 0 4 0 "Action to take when Persistance is met"
     STATE NO_ACTION_REQUIRED 0 
     STATE INITIATE_RESET 1 
     STATE CHANGE_MODE_SAFE 2 
-  PARAMETER "Group" "Telemetry group this monitor item belongs to. Groups are automatically enabled due to payload events." UINT 32 STATE 1 4 1 
+  APPEND_PARAMETER "Group" 32 UINT 1 4 1 "Telemetry group this monitor item belongs to. Groups are automatically enabled due to payload events."
     STATE ALL_MODES 1 
     STATE SAFE_MODE 2
-  PARAMETER "Signed" "Whether to treat the Data Size data as signed or unsigned when comparing to the Threshold" UINT 8 STATE 0 2 0 
+  APPEND_PARAMETER "Signed" 8 UINT 0 2 0 "Whether to treat the Data Size data as signed or unsigned when comparing to the Threshold"
     STATE NOT_APPLICABLE 0 
     STATE UNSIGNED 1 
     STATE SIGNED 2 
 
-<% 200.times do %>
-  DEFAULT 0x0 0 BITS 0x0 0 LESS_THAN NO_ACTION_REQUIRED ALL_MODES UNSIGNED 
-<% end %>
+#<% 200.times do %>
+#  DEFAULT 0x0 0 BITS 0x0 0 LESS_THAN NO_ACTION_REQUIRED ALL_MODES UNSIGNED 
+#<% end %>
 

data/demo/lib/example_background_task.rb

@@ -13,25 +13,20 @@
 require 'cosmos/tools/cmd_tlm_server/background_task'
 
 module Cosmos
-
-  # ExampleBackgroundTask class
-  #
-  # This class is an example background task
-  #
+  # Starts by sleeping 5 seconds then sends up to three collect commands
   class ExampleBackgroundTask < BackgroundTask
-
     def initialize
       super()
       @name = 'Example Background Task'
-      @sleeper = Sleeper.new
     end
 
     def call
       sent_count = 0
+      @sleeper = Sleeper.new
       @status = "Sleeping for 5 seconds"
       return if @sleeper.sleep(5) # allow interfaces time to start
       loop do
-        #Make sure we start up with 3 collects
+        # Start up with at least 3 collects
         if (tlm('INST', 'HEALTH_STATUS', 'COLLECTS') < 3)
           begin
             cmd('INST', 'COLLECT', 'TYPE' => 'NORMAL', 'DURATION' => 1)
@@ -50,8 +45,7 @@ module Cosmos
 
     def stop
       @sleeper.cancel
+      @status = "Stopped at #{Time.now.formatted}"
     end
-
-  end # class ExampleBackgroundTask
-
-end # module Cosmos
+  end
+end

data/demo/procedures/example_test.rb

@@ -11,12 +11,14 @@ class ExampleTest < Cosmos::Test
 
   # Setup the test case by doing stuff
   def setup
+    status_bar("setup")
     puts "Running #{Cosmos::Test.current_test_suite}:#{Cosmos::Test.current_test}:#{Cosmos::Test.current_test_case}"
     wait(2)
   end
 
   # test_1 verifies requirement 1
   def test_case_with_long_name_1
+    status_bar("test_case_with_long_name_1")
     puts "Running #{Cosmos::Test.current_test_suite}:#{Cosmos::Test.current_test}:#{Cosmos::Test.current_test_case}"
     Cosmos::Test.puts "This test verifies requirement 1"
     wait(2)
@@ -24,6 +26,7 @@ class ExampleTest < Cosmos::Test
 
   # test_2 verifies requirement 2
   def test_2
+    status_bar("test_2")
     puts "Running #{Cosmos::Test.current_test_suite}:#{Cosmos::Test.current_test}:#{Cosmos::Test.current_test_case}"
     Cosmos::Test.puts "This test verifies requirement 2"
     if $manual
@@ -35,12 +38,14 @@ class ExampleTest < Cosmos::Test
   end
 
   def test_3xx
+    status_bar("test_3xx")
     puts "Running #{Cosmos::Test.current_test_suite}:#{Cosmos::Test.current_test}:#{Cosmos::Test.current_test_case}"
     wait 1
   end
 
   # Teardown the test case by doing other stuff
   def teardown
+    status_bar("teardown")
     puts "Running #{Cosmos::Test.current_test_suite}:#{Cosmos::Test.current_test}:#{Cosmos::Test.current_test_case}"
     wait(2)
   end

data/lib/cosmos/conversions/conversion.rb

@@ -9,10 +9,8 @@
 # attribution addendums as found in the LICENSE.txt
 
 module Cosmos
-
   # Performs a general conversion via the implementation of the call method
   class Conversion
-
     # @return [Symbol] The converted data type. Must be one of
     #   {Cosmos::StructureItem#data_type}
     attr_reader :converted_type
@@ -42,12 +40,10 @@ module Cosmos
       self.class.to_s.split('::')[-1]
     end
 
-    # @param (see Conversion#to_config)
+    # @param read_or_write [String] Either 'READ' or 'WRITE'
     # @return [String] Config fragment for this conversion
     def to_config(read_or_write)
       "    #{read_or_write}_CONVERSION #{self.class.name.class_name_to_filename}\n"
     end
-
-  end # class Conversion
-
-end # module Cosmos
+  end
+end

data/lib/cosmos/core_ext/class.rb

@@ -32,7 +32,7 @@ class Class
   #   MyClass.test # returns "Test"
   #
   # @param args [Array<Symbol>] Array of symbols which should be turned into
-  #   instance variables with class method accessors
+  #   instance variables with class method readers
   def instance_attr_reader(*args)
     args.each do |arg|
       self.class_eval("def #{arg};@#{arg};end")
@@ -40,6 +40,8 @@ class Class
     end
   end
 
+  # @param args [Array<Symbol>] Array of symbols which should be turned into
+  #   instance variables with class method accessors (read and write)
   def instance_attr_accessor(*args)
     args.each do |arg|
       self.class_eval("def #{arg};@#{arg};end")

data/lib/cosmos/core_ext/file.rb

@@ -12,6 +12,7 @@ require 'find'
 
 # COSMOS specific additions to the Ruby File class
 class File
+  # Non printable ASCII characters
   NON_ASCII_PRINTABLE = /[^\x21-\x7e\s]/
 
   # @return [Boolean] Whether the file only contains ASCII characters

data/lib/cosmos/core_ext/io.rb

@@ -13,9 +13,23 @@ require 'cosmos/core_ext/cosmos_io'
 class IO
   include CosmosIO
 
+  # Initial timeout to call IO.select with. Timeouts are increased by doubling
+  # this value until the SELET_MAX_TIMEOUT value is reached.
   SELECT_BASE_TIMEOUT = 0.0004
+  # The maximum timeout at which point we call IO.select with whatever
+  # remaining timeout is left.
   SELECT_MAX_TIMEOUT = 0.016
 
+  # The method is identical to IO.select but instead of calling IO.select with
+  # the full timeout, it calls IO.select with a small timeout and then
+  # doubles the timeout twice until eventually it calls IO.select with the
+  # remaining passed in timeout value.
+  # TODO: Ryan why was this originally done?
+  #
+  # @param read_sockets [Array<IO>] IO objects to wait to be ready to read
+  # @param write_sockets [Array<IO>] IO objects to wait to be ready to write
+  # @param error_array [Array<IO>] IO objects to wait for exceptions
+  # @param timeout [Numeric] Number of seconds to wait
   def self.fast_select(read_sockets = nil, write_sockets = nil, error_array = nil, timeout = nil)
     # Always try a zero timeout first
     current_timeout = SELECT_BASE_TIMEOUT
@@ -65,10 +79,14 @@ class IO
     end # while true
   end # fast_select
 
+  # @param read_sockets [Array<IO>] IO objects to wait to be ready to read
+  # @param timeout [Numeric] Number of seconds to wait
   def self.fast_read_select(read_sockets, timeout)
     return fast_select(read_sockets, nil, nil, timeout)
   end
 
+  # @param write_sockets [Array<IO>] IO objects to wait to be ready to write
+  # @param timeout [Numeric] Number of seconds to wait
   def self.fast_write_select(write_sockets, timeout)
     return fast_select(nil, write_sockets, nil, timeout)
   end

data/lib/cosmos/core_ext/range.rb

@@ -13,10 +13,6 @@ class Range
   # @return [Array<Float>] Array of each value within the Range converted to
   #   Float
   def to_a_to_f
-    array = []
-    self.each do |value|
-      array << value.to_f
-    end
-    array
+    collect {|value| value.to_f }
   end
 end

data/lib/cosmos/core_ext/time.rb

@@ -339,7 +339,7 @@ class Time
     (day + JULIAN_DATE_OF_CCSDS_EPOCH) + ((ms.to_f + (us / 1000.0)) / MSEC_PER_DAY_FLOAT)
   end
 
-  # @param [Float] julian date
+  # @param jdate [Float] julian date
   # @return [Array<day, ms, us>] Julian converted to CCSDS
   def self.julian2ccsds(jdate)
     day = jdate - JULIAN_DATE_OF_CCSDS_EPOCH
@@ -363,8 +363,8 @@ class Time
     (self.ccsds2julian(day, ms, us) - sec_epoch_jd) * SEC_PER_DAY_FLOAT
   end
 
-  # @param seconds [Float]
-  # @param sec_epoch_jd [Float] Epoch to of seconds value
+  # @param sec [Float] Number of seconds to convert
+  # @param sec_epoch_jd [Float] Epoch of seconds value
   # @return [Array<day, ms, us>] CCSDS date
   def self.sec2ccsds(sec, sec_epoch_jd = JULIAN_DATE_OF_CCSDS_EPOCH)
     self.julian2ccsds((sec / SEC_PER_DAY_FLOAT) + sec_epoch_jd)

data/lib/cosmos/gui/dialogs/about_dialog.rb

@@ -9,56 +9,77 @@
 # attribution addendums as found in the LICENSE.txt
 
 module Cosmos
-
+  # Help->About dialog which is part of all COSMOS tools. Displays the license,
+  # software versions, environment variables, and general COSMOS information.
+  # Also provides a backdoor to a PRY dialog to aid in debugging. See
+  # {PryDialog} for more details.
   class AboutDialog < Qt::Dialog
-    ABOUT_COSMOS = ''
-    ABOUT_COSMOS << "COSMOS application icons are courtesy of http://icons8.com.\n"
-    ABOUT_COSMOS << "COSMOS application sounds are courtesy of http://www.freesfx.co.uk.\n"
-    ABOUT_COSMOS << "\n"
-    ABOUT_COSMOS << "COSMOS utilizes the QtRuby (http://rubyforge.org/projects/korundum) library under "
-    ABOUT_COSMOS << "the GNU Lesser General Public License. QtRuby is a Ruby extension module that provides an "
-    ABOUT_COSMOS << "interface to the Qt Gui Toolkit (http://qt-project.org) by Digia "
-    ABOUT_COSMOS << "under the GNU Lesser General Public License.\n"
-    ABOUT_COSMOS << "\n"
-    ABOUT_COSMOS << "Ruby Version: ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE} patchlevel #{RUBY_PATCHLEVEL}) [#{RUBY_PLATFORM}]\n"
-    ABOUT_COSMOS << "Rubygems Version: #{Gem::VERSION}\n"
-    ABOUT_COSMOS << "Qt Version: #{Qt::qVersion}\n"
-    ABOUT_COSMOS << "Cosmos::PATH: #{Cosmos::PATH}\n"
-    ABOUT_COSMOS << "Cosmos::USERPATH: #{Cosmos::USERPATH}\n"
-    ABOUT_COSMOS << "\n"
-    ABOUT_COSMOS << "Environment Variables:\n"
-    ABOUT_COSMOS << "RUBYLIB: #{ENV['RUBYLIB']}\n"
-    ABOUT_COSMOS << "RUBYOPT: #{ENV['RUBYOPT']}\n"
-    ABOUT_COSMOS << "GEM_PATH: #{ENV['GEM_PATH']}\n"
-    ABOUT_COSMOS << "GEM_HOME: #{ENV['GEM_HOME']}\n"
-    ABOUT_COSMOS << "\n"
-    ABOUT_COSMOS << "Loaded Gems:\n"
+    # About text to display in the dialog
+    ABOUT_COSMOS = "COSMOS application icons are courtesy of http://icons8.com.\n"\
+      "COSMOS application sounds are courtesy of http://www.freesfx.co.uk.\n"\
+      "\n"\
+      "COSMOS utilizes the QtRuby (http://rubyforge.org/projects/korundum) "\
+      "library under the GNU Lesser General Public License. "\
+      "QtRuby is a Ruby extension module that provides an "\
+      "interface to the Qt Gui Toolkit (http://qt-project.org) by Digia "\
+      "under the GNU Lesser General Public License.\n\n"\
+      "Ruby Version: ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE} "\
+      "patchlevel #{RUBY_PATCHLEVEL}) [#{RUBY_PLATFORM}]\n"\
+      "Rubygems Version: #{Gem::VERSION}\n"\
+      "Qt Version: #{Qt::qVersion}\n"\
+      "Cosmos::PATH: #{Cosmos::PATH}\n"\
+      "Cosmos::USERPATH: #{Cosmos::USERPATH}\n\n"\
+      "Environment Variables:\n"\
+      "RUBYLIB: #{ENV['RUBYLIB']}\n"\
+      "RUBYOPT: #{ENV['RUBYOPT']}\n"\
+      "GEM_PATH: #{ENV['GEM_PATH']}\n"\
+      "GEM_HOME: #{ENV['GEM_HOME']}\n\n"\
+      "Loaded Gems:\n"
     Gem.loaded_specs.values.map {|x| ABOUT_COSMOS << "#{x.name} #{x.version} #{x.platform}\n"}
 
     @@pry_dialogs = []
 
-    def initialize (parent, about_string)
+    # @param parent [Qt::Widget] Part of the dialog (the application)
+    # @param about_string [String] Application specific informational text
+    def initialize(parent, about_string)
       super(parent, Qt::WindowTitleHint | Qt::WindowSystemMenuHint)
       @saved_text = ''
       setWindowTitle('About')
 
-      # Get Word Icon
       filename = File.join(::Cosmos::USERPATH, 'config', 'data', 'cosmos_word.gif')
       filename = File.join(::Cosmos::PATH, 'data', 'cosmos_word.gif') unless File.exist?(filename)
       word_icon = Qt::Label.new
       word_icon.setPixmap(Qt::Pixmap.new(filename))
 
-      copyright = Qt::Label.new("Copyright 2014 - Ball Aerospace & Technologies Corp.")
+      copyright = Qt::Label.new("Copyright 2017 - Ball Aerospace & Technologies Corp.")
+      copyright.setFont(Cosmos.getFont("Arial", 12))
       authors = Qt::Label.new("Created by Ryan Melton (ryanmelt) and Jason Thomas (jmthomas)")
-      ver = Qt::Label.new("Version: " + COSMOS_VERSION)
-      user_ver = nil
-      user_ver = Qt::Label.new("User Version: " + USER_VERSION) if defined? USER_VERSION and USER_VERSION != 'Unofficial'
+      authors.setFont(Cosmos.getFont("Arial", 12))
+
+      cosmos_layout = Qt::GridLayout.new
+      version = Qt::Label.new("Version: " + COSMOS_VERSION)
+      version.setFont(Cosmos.getFont("Arial", 14))
+      open_cosmos_code = Qt::PushButton.new("Open COSMOS Gem Code") do
+        connect(SIGNAL('clicked()')) { Cosmos.open_file_browser(Cosmos::PATH) }
+      end
+      cosmos_layout.addWidget(version, 0, 0)
+      cosmos_layout.addWidget(open_cosmos_code, 0, 1)
+
+      if USER_VERSION && USER_VERSION != 'Unofficial'
+        user_version = Qt::Label.new("Project Version: " + USER_VERSION)
+        user_version.setFont(Cosmos.getFont("Arial", 14))
+        cosmos_layout.addWidget(user_version, 1, 0)
+      end
+      open_user_code = Qt::PushButton.new("Open Project Code") do
+        connect(SIGNAL('clicked()')) { Cosmos.open_file_browser(Cosmos::USERPATH) }
+      end
+      cosmos_layout.addWidget(open_user_code, 1, 1)
+
       icon_layout = Qt::VBoxLayout.new do
         addWidget(word_icon)
         addWidget(copyright)
         addWidget(authors)
-        addWidget(ver)
-        addWidget(user_ver) if user_ver
+        addLayout(cosmos_layout)
         addStretch
       end
 
@@ -68,7 +89,9 @@ module Cosmos
       configurable_about_text = File.read(filename)
       configurable_about_text.gsub!("\r", '') unless Kernel.is_windows?
       if Kernel.is_windows?
-        configurable_about_text << "\n" + "Main Application x:#{parent.x} y:#{parent.y} width:#{parent.frameGeometry.width + 16} height:#{parent.frameGeometry.height + 38}\n\n" +  ABOUT_COSMOS
+        configurable_about_text << "\n" \
+          "Main Application x:#{parent.x} y:#{parent.y} width:#{parent.frameGeometry.width + 16} " \
+          "height:#{parent.frameGeometry.height + 38}\n\n" +  ABOUT_COSMOS
       else
         configurable_about_text << "\n" + "Main Application x:#{parent.x} y:#{parent.y} width:#{parent.frameGeometry.width} height:#{parent.frameGeometry.height}\n\n" +  ABOUT_COSMOS      end
 
@@ -104,11 +127,14 @@ module Cosmos
       end
 
       setMaximumWidth(800)
+      ok.setFocus
       self.raise()
       exec()
       dispose()
     end
 
+    # Register key press events to listen for 'p', 'r', 'y' and popup a {PryDialog}
+    # @param event [Qt::Event] The keypress event
     def keyPressEvent(event)
       @saved_text << event.text.to_s
       if @saved_text[0] == 'p'
@@ -131,7 +157,5 @@ module Cosmos
       end
       super(event)
     end
-
-  end # class AboutDialog
-
-end # module Cosmos
+  end
+end