CHANGED: bindings format

Preparing for automated binding reference generation

Author: nkh

documentation/mdbook_asciio/src/Bindings_reference.md

@@ -15,5 +15,3 @@ Although work can mostly be done using the keyboard, the mouse is still useful a
 ## popup menus
 
 My least favorite way of using Asciio, it's slow and cumbersome for most actions. I try to limit the amount of menu and sub menus.
-
-

documentation/mdbook_asciio/src/Interface.md

@@ -8,15 +8,16 @@ These files are valid Perl scripts, you can defined code to bind to in the files
 
 Use the following commands to define commands:
 
-| Subroutine Name                        | Purpose                                                             | Data Format Expected          |
-| ---                                    | ---                                                                 | ---                           |
-| register_action_handlers               | Defines actions, and multi-level action groups.                     |                               |
-| register_action_handlers_with_override | As above but also **deletes** old shortcuts                         | list of key-value pairs       |
-| TOP_LEVEL_GROUP                        | Defines the content of the top-level grouping used for menu display | shortcut and a list of action |
-| GROUP                                  | Used to declare a nested, ordered, action group.                    |                               |
-| USE_GROUP                              | binds a shortcut with a group                                       |                               |
-| CONTEXT_MENU                           | Defines actions that are only accessible via a context menu         |                               |
-| MACRO                                  | associate a action to set of commands                               |                               |
+| Subroutine Name                        | Purpose                                                             | Data Format Expected              |
+| ---                                    | ---                                                                 | ---                               |
+| register_action_handlers               | Defines actions, and multi-level action groups.                     |                                   |
+| register_action_handlers_with_override | As above but also **deletes** old shortcuts                         | list of key-value pairs           |
+| PROXY_GROUP                            | Defines the content of the top-level grouping used for menu display | shortcut and a list of action     |
+| ROOT_GROUP                             | Defines actions that are registered in the default group            | information and a list of actions |
+| GROUP                                  | Used to declare a nested, ordered, action group.                    |                                   |
+| USE_GROUP                              | binds a shortcut with a group                                       |                                   |
+| CONTEXT_MENU                           | Defines actions that are only accessible via a context menu         |                                   |
+| MACRO                                  | associate a action to set of commands                               |                                   |
 
 ## Action Definition Formats
 

documentation/mdbook_asciio/src/config/binding_format.md

@@ -29,7 +29,7 @@ my ($self, $keep_visible) = @_ ;
 
 if($self->{USE_BINDINGS_COMPLETION} && ! $self->{CURRENT_ACTIONS}{HIDE})
 	{
-	my %reserved = map { $_ => 1 } qw(HIDE IS_GROUP ENTER_GROUP ESCAPE_KEYS ESCAPE_GROUP NAME SHORTCUTS ORIGIN CODE OPTIONS) ;
+	my %reserved = map { $_ => 1 } qw(HIDE IS_GROUP DESCRIPTION ENTER_GROUP ESCAPE_KEYS ESCAPE_GROUP NAME SHORTCUTS ORIGIN CODE OPTIONS) ;
 
 	my $binding_max_length =
 		max map { length }
@@ -68,6 +68,7 @@ if($self->{USE_BINDINGS_COMPLETION} && ! $self->{CURRENT_ACTIONS}{HIDE})
 				} @actions
 			] ;
 
+
 	$self->{BINDINGS_COMPLETION_LENGTH} = $max_length ;
 	$self->update_display() ;
 	}