rtml 1.2.2

data/app_generators/rtml/templates/rtml/reporting/110409

@@ -0,0 +1,227 @@
+  1	=> ./rules/varns/oebr/cache.rb
+  1	=> ./uninstall.rb
+  2	=> ./app/helpers/rtml/oe/btmlpa_helper.rb
+  2	=> ./generators/rtml_controller/templates/helper.rb
+  2	=> ./generators/rtml_document/templates/helper.rb
+  3	=> ./generators/rtml_controller/templates/controller.rb
+  3	=> ./lib/rtml/debug/unit_test.rb
+  4	=> ./rules/varns/oebr/backlight.rb
+  5	=> ./rules/varns/oebr/connect.rb
+  5	=> ./rules/varns/oebr/connection.rb
+  5	=> ./rules/varns/oebr/offline.rb
+  6	=> ./lib/rtml/helpers/test_helpers.rb
+  6	=> ./rules/varns/card/pin.rb
+  7	=> ./generators/rtml_document/templates/controller.rb
+  7	=> ./lib/rtml/debug/rtml_controller_test_case.rb
+  7	=> ./lib/rtml/version.rb
+  7	=> ./rules/varns/card/parser.rb
+  7	=> ./rules/varns/oebr/3rdparty.rb
+  8	=> ./app/models/rtml/terminal.rb
+  8	=> ./lib/rtml/delegation.rb
+  8	=> ./rules/varns/card/mag.rb
+  8	=> ./rules/varns/gprs.rb
+  8	=> ./rules/varns/imager.rb
+  9	=> ./app/helpers/rtml/rtml_app_tml_helpers/common.rb
+  9	=> ./db/migrate/20090915030044_add_batch_to_rtml_transactions.rb
+  9	=> ./db/migrate/20090915031155_add_additional_data_to_rtml_transactions.rb
+  9	=> ./db/migrate/20090915031156_add_hidden_data_to_rtml_transactions.rb
+  9	=> ./lib/extensions/array.rb
+  9	=> ./lib/rtml/errors/widget_accessor_failure.rb
+  9	=> ./rules/varns/com.rb
+  9	=> ./test/functional/rtml_app_controller_test.rb
+  9	=> ./test/validation/predefined_variable_rule_parser_test.rb
+  10	=> ./generators/rtml_document/templates/functional_test.rb
+  10	=> ./lib/extensions/attr_boolean.rb
+  10	=> ./lib/rtml/events/processors.rb
+  10	=> ./lib/rtml/helpers/test_helpers/tml_validation_assertions.rb
+  11	=> ./app/helpers/rtml/oe/btmlpa_tml_helpers/dynamic.rb
+  11	=> ./generators/rtml_controller/templates/functional_test.rb
+  11	=> ./lib/rtml/widgets/property.rb
+  11	=> ./rules/varns/ppp.rb
+  12	=> ./app/models/rtml/state.rb
+  12	=> ./lib/rtml/beryl/constants.rb
+  12	=> ./lib/rtml/doc.rb
+  12	=> ./rules/varns/oegw.rb
+  13	=> ./db/migrate/20090826103509_create_reference_codes.rb
+  13	=> ./lib/extensions/active_record.rb
+  13	=> ./lib/rtml/common/renderable.rb
+  13	=> ./rules/varns/gma/event.rb
+  13	=> ./test/functional/beryl_controller_test.rb
+  13	=> ./test/functional/btmlpa_controller_test.rb
+  14	=> ./app/models/rtml/card_avs.rb
+  14	=> ./app/models/rtml/card_cvv.rb
+  14	=> ./db/migrate/20090825132217_create_rtml_states.rb
+  14	=> ./lib/rtml/proxying/method_missing_methods.rb
+  14	=> ./rules/varns/err.rb
+  15	=> ./db/migrate/20090825132401_create_rtml_terminals.rb
+  15	=> ./db/migrate/20091016133313_create_rtml_card_avs.rb
+  15	=> ./db/migrate/20091016135800_create_rtml_card_cvvs.rb
+  15	=> ./lib/rtml/core/screen/iterators.rb
+  15	=> ./rules/varns/cfgm.rb
+  15	=> ./rules/varns/ip.rb
+  15	=> ./test/core/element_test.rb
+  16	=> ./app/helpers/beryl_helper.rb
+  16	=> ./db/migrate/20090825134629_create_rtml_mag_card_data.rb
+  16	=> ./generators/rtml_controller/templates/tml_helper.rb
+  16	=> ./lib/extensions/regexp.rb
+  16	=> ./lib/rtml/validation/tml_validator.rb
+  17	=> ./lib/rtml/features/array_of_feature_instances.rb
+  17	=> ./lib/rtml/helpers/proxy_helpers/feature_helpers.rb
+  17	=> ./rules/varns/card.rb
+  18	=> ./db/migrate/20090825135838_create_rtml_card_parsers.rb
+  18	=> ./lib/rtml/events/processors/defaults_processor.rb
+  18	=> ./lib/rtml/features.rb
+  18	=> ./lib/rtml/proxying/sandbox.rb
+  19	=> ./app/helpers/beryl_tml_helpers/common.rb
+  19	=> ./db/migrate/20090825134622_create_rtml_emv_card_data.rb
+  19	=> ./lib/extensions/rake.rb
+  19	=> ./test/functional/rtml_routing_test.rb
+  20	=> ./generators/rtml_controller/templates/common_tml_helper.rb
+  20	=> ./lib/extensions/nil_class.rb
+  21	=> ./app/models/rtml/card_parser.rb
+  21	=> ./app/models/rtml/mag_card_data.rb
+  21	=> ./init.rb
+  21	=> ./lib/rtml/events/processors/key_processor.rb
+  21	=> ./lib/rtml/helpers.rb
+  21	=> ./lib/rtml/helpers/terminal_helpers.rb
+  21	=> ./rules/varns/payment.rb
+  22	=> ./db/migrate/20090825134118_create_rtml_cards.rb
+  23	=> ./app/helpers/rtml/oe/btmlpa_tml_helpers/auth_result.rb
+  23	=> ./app/helpers/rtml/oe/btmlpa_tml_helpers/common.rb
+  23	=> ./components/rtml/features/return.rb
+  23	=> ./db/migrate/20090825132530_create_rtml_transactions.rb
+  23	=> ./lib/other_plugins.rb
+  23	=> ./lib/rtml/helpers/core_helpers/action_view_wrapper.rb
+  24	=> ./lib/extensions/action_view/partial_template.rb
+  24	=> ./lib/other_plugins/before_render/test/test_helper.rb
+  25	=> ./app/models/rtml/emv_card_data.rb
+  25	=> ./install.rb
+  25	=> ./lib/extensions/active_support/dependencies.rb
+  25	=> ./lib/other_plugins/before_render/init.rb
+  26	=> ./app/models/rtml/reference_code.rb
+  26	=> ./lib/other_plugins/before_render/lib/filter_has_before_render.rb
+  26	=> ./lib/rtml/migrator.rb
+  27	=> ./generators/rtml_widget/templates/basic_widget_no_help.rb
+  27	=> ./lib/rtml/helpers/test_helpers/variable_assertions.rb
+  28	=> ./lib/extensions/hash.rb
+  28	=> ./lib/rtml/helpers/core_helpers/event_helpers.rb
+  28	=> ./lib/rtml/helpers/core_helpers/widget_support/class_methods.rb
+  29	=> ./lib/other_plugins/before_render/test/before_render_test.rb
+  29	=> ./rules/varns/terminal.rb
+  30	=> ./components/rtml/features/void.rb
+  30	=> ./lib/other_plugins/before_render/lib/action_controller/filters/before_render_filter.rb
+  30	=> ./lib/rtml/core/include.rb
+  30	=> ./lib/rtml/features/controller_class_methods.rb
+  30	=> ./rules/varns/audio.rb
+  31	=> ./rules/varns/card/emv.rb
+  32	=> ./lib/rtml/feature.rb
+  33	=> ./components/rtml/widgets/get_transaction_variables_widget.rb
+  33	=> ./lib/rtml/helpers/core_helpers/yield_helpers.rb
+  33	=> ./lib/rtml/proxying/rtml_interface.rb
+  34	=> ./lib/extensions/action_controller/routing/route_set.rb
+  35	=> ./lib/rtml/features/controller_instance_methods.rb
+  37	=> ./lib/extensions/string.rb
+  38	=> ./test/rtml_test_helper.rb
+  39	=> ./components/rtml/widgets/get_variable_widget.rb
+  39	=> ./reporting/linecount.rb
+  42	=> ./rules/varns/oebr.rb
+  43	=> ./app/helpers/rtml/tml_app_helper.rb
+  43	=> ./lib/other_plugins/before_render/lib/before_render.rb
+  45	=> ./generators/rtml_document/rtml_document_generator.rb
+  45	=> ./lib/other_plugins/before_render/lib/before_render_instance.rb
+  47	=> ./lib/rtml/helpers/core_helpers/layout_helpers.rb
+  48	=> ./components/rtml/features/force.rb
+  48	=> ./lib/rtml/oe/btmlpa_constants.rb
+  49	=> ./components/rtml/features/sale.rb
+  49	=> ./components/rtml/widgets/screen_builder_widget.rb
+  49	=> ./generators/rtml_controller/rtml_controller_generator.rb
+  49	=> ./lib/rtml/core/tml_document/screen_methods.rb
+  51	=> ./lib/rtml/text_utils.rb
+  52	=> ./lib/rtml/validation/dom_tag.rb
+  54	=> ./app/helpers/beryl_tml_helpers/auth_result.rb
+  55	=> ./lib/rtml/core/support/importer.rb
+  55	=> ./template.rb
+  57	=> ./generators/rtml_widget/templates/basic_widget.rb
+  57	=> ./lib/environment.rb
+  58	=> ./app/helpers/beryl_tml_helpers/index.rb
+  59	=> ./components/rtml/widgets/form_submit_widget.rb
+  59	=> ./lib/rtml/core/layout.rb
+  59	=> ./lib/rtml/debug/browser_emulator.rb
+  59	=> ./lib/rtml/helpers/controller_helpers.rb
+  59	=> ./lib/rtml/widgets/property_accessors.rb
+  61	=> ./lib/rtml/validation/dom_rule_parser.rb
+  63	=> ./rules/predefined_tml_variables.rb
+  63	=> ./test/core/tml_document_test.rb
+  66	=> ./app/controllers/beryl_controller.rb
+  66	=> ./components/rtml/widgets/display_widget.rb
+  66	=> ./components/rtml/widgets/receipt_widget.rb
+  66	=> ./generators/rtml_widget/rtml_widget_generator.rb
+  68	=> ./app/models/rtml/transaction.rb
+  70	=> ./lib/rtml/core/screen/next_screen_methods.rb
+  70	=> ./lib/rtml/element.rb
+  70	=> ./lib/rtml/helpers/view_helpers/form_helpers.rb
+  71	=> ./app/models/rtml/card.rb
+  71	=> ./lib/rtml/helpers/render_helper.rb
+  73	=> ./lib/rtml/core/screen/variable_methods.rb
+  74	=> ./app/helpers/rtml/rtml_app_helper.rb
+  74	=> ./lib/extensions/action_view/base.rb
+  77	=> ./lib/rtml.rb
+  79	=> ./lib/rtml/events/event_handler.rb
+  83	=> ./lib/rtml/core/tml_document/variable_methods.rb
+  84	=> ./rules/tml_document_structure.rb
+  87	=> ./lib/other_plugins/before_render/lib/filter_chain_has_many_types_of_filters.rb
+  90	=> ./components/rtml/widgets/card_parser_widget.rb
+  91	=> ./lib/rtml/core/screen.rb
+  97	=> ./lib/rtml/validation/predefined_variable_rule_parser.rb
+  106	=> ./lib/rtml/events/event_processor.rb
+  121	=> ./components/rtml/widgets/element_builder_widget.rb
+  123	=> ./lib/rtml/core/variable.rb
+  152	=> ./app/helpers/rtml/oe/btmlpa_tml_helpers/receipt.rb
+  158	=> ./app/controllers/rtml/oe/btmlpa_controller.rb
+  166	=> ./lib/rtml/helpers/view_helpers/rtml_form_builder.rb
+  170	=> ./lib/rtml/helpers/core_helpers/widget_support.rb
+  186	=> ./lib/rtml/core/next.rb
+  191	=> ./app/helpers/rtml/oe/btmlpa_tml_helpers/index.rb
+  193	=> ./lib/rtml/helpers/controller_helpers/menu_helpers.rb
+  195	=> ./lib/rtml/feature_config.rb
+  213	=> ./lib/rtml/widgets/widget_class_methods.rb
+  236	=> ./app/controllers/rtml/rtml_app_controller.rb
+  251	=> ./lib/rtml/widgets/widget.rb
+  292	=> ./components/rtml/features/common.rb
+  312	=> ./lib/rtml/core/tml_document.rb
+  365	=> ./components/rtml/widgets/emv_support_widget.rb
+  384	=> ./app/helpers/rtml/oe/btmlpa_tml_helpers/icc.rb
+  470	=> ./app/controllers/rtml/tml_app_controller.rb
+Total: 9523
+
+Margin: +/- 4
+
+lns  pcnt 
+  0 ( 4%) ........
+  9 (21%) ..........................................
+ 18 (19%) ......................................
+ 27 (14%) ............................
+ 36 ( 5%) ..........
+ 45 ( 6%) ............
+ 54 ( 4%) ........
+ 63 ( 6%) ............
+ 72 ( 4%) .........
+ 81 ( 2%) ....
+ 90 ( 1%) ...
+ 99 ( 0%) .
+108 ( 0%) .
+117 ( 0%) .
+126 ( 0%) .
+153 ( 0%) .
+162 ( 1%) ..
+171 ( 0%) .
+189 ( 1%) ...
+198 ( 0%) .
+216 ( 0%) .
+234 ( 0%) .
+252 ( 0%) .
+288 ( 0%) .
+315 ( 0%) .
+369 ( 0%) .
+387 ( 0%) .
+468 ( 0%) .

data/app_generators/rtml/templates/rtml/reporting/linecount.rb

@@ -0,0 +1,42 @@
+# This is here for my own curiosity and enjoyment, because I like to watch numbers change.
+# Usage: from target directory, 'ruby reporting/linecount.rb [anything else to sort the results]'
+
+count = 0
+max = 0
+buffer = []
+Dir.glob("./**/*.rb").each do |fi|
+	content = File.read(fi)
+	numln = content.to_a.length
+	buffer << [fi, numln]
+	count += numln
+  max = numln if numln > max
+end
+
+buffer.sort! { |a,b| (((a[1] <=> b[1]) == 0) ? (a[0] <=> b[0]) : (a[1] <=> b[1])) } if ARGV[0]
+buffer.each { |a| puts "  #{a[1]}\t=> #{a[0]}" }
+
+# now a pretty graph
+max_lines = 100
+margin = (max / max_lines)
+puts "Total: #{count}"
+puts
+puts "Margin: +/- #{margin}"
+buffer.sort! { |a,b| a[1] <=> b[1] }
+matches = []
+m = 0
+buffer.collect { |a| a[1] }.uniq.sort.each do |num|
+  m = num if num > m+margin
+  c = buffer.collect { |a| a[1] }.select { |a| a >= m-margin && a <= m+margin }.length
+  matches << [m, c]
+  m += ((margin*2)+1)
+end
+
+digits = max.to_s.length
+puts
+puts 'lns  pcnt '
+matches.each do |a|
+  num, c = a
+  pcnt = ((c.to_f / buffer.collect { |a| a[1]}.length.to_f) * 100).to_i
+  puts "#{num.to_s.rjust(digits)} (#{pcnt.to_s.rjust(2)}%) #{"."*c}" if c > 0
+end
+

data/app_generators/rtml/templates/rtml/rules/predefined_tml_variables.rb

@@ -0,0 +1,63 @@
+=begin
+ This file describes the built-in TML variables and is used to assert that, when the user
+ assigns them values, the assignments are valid and to check whether undeclared variables
+ are being used by the application.
+
+ "Inheritable" below means that if an option is specified at the namespace level, it will
+ be used as the default for all variables and namespaces beneath it.
+
+ #namespace_path specifies a search path, relative to the current file, to use when loading
+ namespaces.
+
+ #namespace specifies a namespace to create or add to. If a file called "#{namespace}.rb"
+ is found in the search path, it will be loaded immediately. After this is attempted, any
+ attached blocks will be evaluated.
+
+ #ns is an alias for #namespace. 
+
+ #type specifies the variable type (:integer, :string, :opaque, :date). Inheritable.
+
+ #perms specifies the access permissions for this variable. Inheritable.
+
+ #values specifies the valid values that may be assigned to this variable; if omitted, then any
+ legal value can be assigned. Inheritable.
+
+ #default specifies the default value for this variable. Inheritable.
+
+ #desc specifies the description for this namespace or variable, if any.
+
+ Any of these options can be specified more than once, and will only affect variables defined
+ after the option is set. For example:
+
+   type :integer # all variables defined after this point are integers by default
+   age
+   customer_number
+
+   type :string # all variables defined after this point are strings by default
+   first_name
+   last_name
+   current_time, :type => :date # this one is a date
+   country
+=end
+
+search_path 'varns'
+
+namespace :audio
+namespace :card
+namespace :cfgm
+namespace :com
+namespace :err
+namespace :gprs
+namespace :ip
+namespace :oebr
+namespace :gma do
+  namespace :event
+end
+namespace :oegw
+namespace :payment
+namespace :ppp
+namespace :terminal
+namespace :imager
+
+passwd 'The variable that stores intermediate results of working with the Supervisor Password parameter.', :type => :string, :perms => 'rw---'
+screen_after_call 'The variable that stores the URI of the screen that should be processed after the call of a function such as Clear HTTP Cache, Disconnect from OEGW, and so on.', :type => :string, :perms => 'rw---'

data/app_generators/rtml/templates/rtml/rules/tml_document_structure.rb

@@ -0,0 +1,84 @@
+# This rule set defines which TML tags are valid tags, which tags may be enclosed by each tag,
+# and the order children may appear in. This mirrors the Incendo tag definitions so that functional
+# tests may be used to ensure well formed TML. A functional test can do this by first requesting
+# the TML document from the controller, and then calling assert_valid_tml
+
+# defines all available TML tags.
+define_tags %W{
+	a baddata base br call_func card col colgroup dd defaults display div dl dt
+	econn error form getvar h1 h2 h3 h4 h5 h6 head hr img input layout li link log
+	logdcl logrec next ol p pinentry postvar pre print prompt screen setvar
+	span strtemplate submit submit_log table tbody td textarea tfoot tform th
+	thead tml tmlpost tr ul vardcl variant
+}
+
+# defines the topmost element. There can only be 1.
+root :tml
+
+# constrains the order in which tags may appear within certain elements
+order do
+	head :base, :link, :defaults, :error
+	logdcl :vardcl, :layout
+	screen :setvar, :strtemplate, :logrec, :next, :error, :call_func, :display, :print, :submit, :tform
+	submit :econn, :getvar, :submit_log
+	table :col, :colgroup, :thead, :tfoot, :tbody, :tr
+	tform :baddata, :card, :prompt, :pinentry
+	tml :head, :vardcl, :logdcl, :screen
+end
+
+# lists which children are allowed to appear in certain elements, with optional :minimum and :maximum constraints
+# default constraints are :minimum => 0, no maximum
+children do
+	a :img
+	baddata %W{a br div dl h1 h2 h3 h4 h5 h6 hr img getvar ol p pre span table ul}
+  colgroup :col
+	dd %W{a br span getvar input textarea div dl h1 h2 h3 h4 h5 h6 hr img ol p pre table ul form}
+	display %W{a br div dl form getvar h1 h2 h3 h4 h5 h6 hr img input log ol p pre span table textarea ul}
+	div %W{a br div dl form getvar h1 h2 h3 h4 h5 h6 hr img input ol p pre span table textarea ul}
+	dl %W{dt dd}, :minimum => 1 #dt+ dd+
+	dt %W{a br div dl form getvar h1 h2 h3 h4 h5 h6 hr img input ol p pre span table textarea ul}
+	econn :variant #variant*
+	error :variant #variant*
+	form %W{div dl h1 h2 h3 h4 h5 h6 hr img ol p pre table ul input textarea}
+	h1 %W{a br getvar input span textarea}
+	h2 %W{a br getvar input span textarea}
+	h3 %W{a br getvar input span textarea}
+	h4 %W{a br getvar input span textarea}
+	h5 %W{a br getvar input span textarea}
+	h6 %W{a br getvar input span textarea}
+	head %W{base defaults error}, :minimum => 0, :maximum => 1 #base?, defaults?, error?
+	head :link # link*
+	input :baddata, :minimum => 0, :maximum => 1
+	layout all_elements - [:form]
+	li %W{a br span getvar input textarea div dl h1 h2 h3 h4 h5 h6 hr img ol p pre table ul form}
+	log %W{vardcl layout}
+	send :next, %W{variant}
+	ol :li
+	send :p, %W{a br getvar input span textarea}
+	pre %W{a br getvar input span textarea}
+	send :print, %W{div dl h1 h2 h3 h4 h5 h6 hr img log ol p pre table ul form}
+	prompt %W{div dl h1 h2 h3 h4 h5 h6 hr img ol p pre table ul}
+	screen %W{setvar strtemplate logrec}
+	screen %W{next error call_func display print submit tform}, :maximum => 1
+	span %W{a br span getvar input textarea}
+	strtemplate :getvar, :minimum => 0, :maximum => 9
+	submit :econn, :maximum => 1
+	submit %W{getvar submit_log}
+	table %W{col colgroup tbody tr}
+	table %W{thead tfoot}, :maximum => 1
+	tbody :tr
+	td %W{a br span getvar input textarea div dl h1 h2 h3 h4 h5 h6 hr img ol p pre table ul form dd display li print td th}
+	textarea :baddata, :maximum => 1
+	tfoot :tr
+	tform %W{baddata prompt}, :maximum => 1
+	tform :card
+	tform :pinentry, :maximum => 1
+	th %W{a br span getvar input textarea div dl h1 h2 h3 h4 h5 h6 hr img ol p pre table ul form dd display li print td th}
+	thead :tr
+	tml :head, :maximum => 1
+	tml %W{vardcl logdcl screen}
+	tmlpost :postvar
+	tr [:th, :td]
+	ul :li
+	variant :li
+end

data/app_generators/rtml/templates/rtml/rules/varns/audio.rb

@@ -0,0 +1,30 @@
+type :string
+perms 'rwxr-'
+values [ 'sound_click_low', 'sound_click_midtone', 'sound_click_high',
+         'sound_short_low', 'sound_short_midtone', 'sound_short_high',
+         'sound_long_low',  'sound_long_midtone',  'sound_long_high' ]
+default 'sound_click_midtone'
+desc 'This section describes predefined TML variables related to various audio options. Most of the variables in this group are used to assign different kinds of sounds to different events, such as a press of a key on the terminal keypad, swiping of a magnetic card, insertion of a smart card, and so on.'
+
+any_key 'The sound that the terminal produces when an alphanumeric, the DOWN, the UP, or the navigation key on the terminal keypad is pressed.'
+app_error 'The sound that the terminal produces when MicroBrowser encounters an error.'
+app_start 'The sound that the terminal produces when MicroBrowser is started.'
+app_stop 'The sound that the terminal produces when MicroBrowser is stopped.'
+barcode_failed 'The sound that the terminal produces when the bar code scanner fails to read a bar code.', :default => 'sound_short_low'
+barcode_read 'The sound that the terminal produces when the bar code scanner has successfully read the bar code.', :default => 'sound_short_high'
+cancel_key 'The sound that the terminal produces when the CANCEL (red) key on the terminal keypad is pressed.'
+clear_key 'The sound that the terminal produces when the C (yellow) key on the terminal keypad is pressed.'
+connection_close 'The sound that is produced when the terminal disconnects from the Gateway.'
+connection_open 'The sound that is produced when the terminal connects to the Gateway.'
+emv_insert 'The sound that the terminal produces when a smart card is inserted into the card reader.'
+emv_remove 'The sound that the terminal produces when a smart card is removed from the card reader.'
+enter_key 'The sound that the terminal produces when the OK (green) button is pressed.'
+focus_get 'The sound that the terminal produces when an element on the terminal screen, such as a data field, is brought into focus.'
+mute 'The variable whose value defines whether the mute option is on or off. This variable is used to turn the sounds for all events on or off.', :values => [ "on", "off"], :default => 'off'
+next_ref 'The sound that the terminal produces when the next link on the terminal screen is brought into focus.'
+next_url 'The sound that the terminal produces when the link which is in focus is selected.'
+paper_feed_key 'The sound that the terminal produces when the paper feed key (the one with the arrow pointing up) on the terminal keypad is pressed.'
+swipe 'The sound that the terminal produces when a magnetic card is swiped through the card reader.'
+swipe_failed 'The sound that is produced when the terminal fails to read the card data from the magnetic card.', :default => 'sound_click_low'
+tml_key_press 'The sound that the terminal produces when "a TML key," -- that is, a button shown on the terminal screen -- is selected.'
+volume 'The variable whose value defines the volume (loudness) of sounds for all events. When set to 0, the sounds are off. The maximum possible value is 100.', :default => 100, :values => (0..100).to_a