X-Git-Url: https://git.carlh.net/gitweb/?a=blobdiff_plain;f=tools%2Ffmt-bindings;h=aa76afe72f370d2f6873084ab812ed89032357b7;hb=c625d7a6373fa1889c9632fbcd423cccfd0e4bd1;hp=246e451aa6b179dcf8f066d10d739c97242bbcbb;hpb=2a0460b150056a2431ada79244e26fd17958c6ab;p=ardour.git diff --git a/tools/fmt-bindings b/tools/fmt-bindings index 246e451aa6..aa76afe72f 100755 --- a/tools/fmt-bindings +++ b/tools/fmt-bindings @@ -18,31 +18,49 @@ $group_number = 0; %merge_bindings; $platform = linux; -$winkey = 'Mod4\>\ \$platform, "winkey=s" => \$winkey, "cheatsheet" => \$make_cheatsheet, "accelmap" => \$make_accelmap, - "merge=s" => \$merge_from); + "merge=s" => \$merge_from, + "html" => \$html); -if ($platform eq "osx") { +# +# The use of a separate @WINDOW@ meta-modifier was a mistake and needs to be removed from the bindings.in file. +# There is no separate key/modifier we can use for this, so inevitably it will be the same modifier as one of +# the other meta-modifiers. This means, for example, that @WINDOW@-b could be same as @SECONDARY@-b with no +# warnings given. One of the bindings will work, one won't. +# - $gtk_modifier_map{'PRIMARY'} = 'Primary'; +if ($platform eq "darwin") { + + $gtk_modifier_map{'PRIMARY'} = 'Primary'; # GTK supports Primary to allow platform-independent binding to the "primary" modifier, which on OS X is Command $gtk_modifier_map{'SECONDARY'} = 'Control'; $gtk_modifier_map{'TERTIARY'} = 'Shift'; - $gtk_modifier_map{'LEVEL4'} = 'Mod1'; + $gtk_modifier_map{'LEVEL4'} = 'Mod1'; $gtk_modifier_map{'WINDOW'} = 'Control'; + # cs_modifier_map == "Cheat Sheet Modifier Map" + # Used to control what gets shown in the + # cheat sheet for a given (meta)-modifier + $cs_modifier_map{'PRIMARY'} = 'Cmd'; $cs_modifier_map{'SECONDARY'} = 'Control'; $cs_modifier_map{'TERTIARY'} = 'Shift'; - $cs_modifier_map{'LEVEL4'} = 'Mod1'; + $cs_modifier_map{'LEVEL4'} = 'Opt'; $cs_modifier_map{'WINDOW'} = 'Control'; + # used to display what gets shown in the + # cheat sheet for mouse bindings. Differs + # from cs_modifier map in using shorter + # abbreviations. + $mouse_modifier_map{'PRIMARY'} = 'Cmd'; $mouse_modifier_map{'SECONDARY'} = 'Ctrl'; $mouse_modifier_map{'TERTIARY'} = 'Shift'; @@ -54,56 +72,103 @@ if ($platform eq "osx") { $gtk_modifier_map{'PRIMARY'} = 'Control'; $gtk_modifier_map{'SECONDARY'} = 'Alt'; $gtk_modifier_map{'TERTIARY'} = 'Shift'; - $gtk_modifier_map{'LEVEL4'} = $winkey; + $gtk_modifier_map{'LEVEL4'} = $winkey; # something like "Mod4> 'Win'; + + # cs_modifier_map == "Cheat Sheet Modifier Map" + # Used to control what gets shown in the + # cheat sheet for a given (meta)-modifier $cs_modifier_map{'PRIMARY'} = 'Control'; $cs_modifier_map{'SECONDARY'} = 'Alt'; $cs_modifier_map{'TERTIARY'} = 'Shift'; $cs_modifier_map{'LEVEL4'} = 'Win'; $cs_modifier_map{'WINDOW'} = 'Alt'; - $cs_modifier_map{$winkey} => 'Win'; + + # used to display what gets shown in the + # cheat sheet for mouse bindings. Differs + # from cs_modifier map in using shorter + # abbreviations. $mouse_modifier_map{'PRIMARY'} = 'Ctl'; $mouse_modifier_map{'SECONDARY'} = 'Alt'; $mouse_modifier_map{'TERTIARY'} = 'Shift'; $mouse_modifier_map{'LEVEL4'} = 'Win'; $mouse_modifier_map{'WINDOW'} = 'Alt'; - $mouse_modifier_map{$winkey} => 'Win'; } -%keycodes = ( - 'asciicircum' => '\\verb=^=', - 'apostrophe' => '\'', - 'bracketleft' => '[', - 'bracketright' => ']', - 'braceleft' => '\\{', - 'braceright' => '\\}', - 'backslash' => '$\\backslash$', - 'slash' => '/', - 'rightanglebracket' => '>', - 'leftanglebracket' => '<', - 'ampersand' => '\\&', - 'comma' => ',', - 'period' => '.', - 'semicolon' => ';', - 'colon' => ':', - 'equal' => '=', - 'minus' => '-', - 'plus' => '+', - 'grave' => '`', - 'rightarrow' => '$\rightarrow$', - 'leftarrow' => '$\\leftarrow$', - 'uparrow' => '$\\uparrow$', - 'downarrow' => '$\\downarrow$', - 'Page_Down' => 'Page Down', - 'Page_Up' => 'Page Up', - 'space' => 'space', - 'KP_' => 'KP$\_$', - 'greater' => '>', - 'less' => '<', +%keycodes = (); + +if ($html) { + %keycodes = ( + 'asciicircum' => '^', + 'apostrophe' => '\'', + 'bracketleft' => '[', + 'bracketright' => ']', + 'braceleft' => '{', + 'braceright' => '}', + 'backslash' => '\\', + 'slash' => '/', + 'rightanglebracket' => '>', + 'leftanglebracket' => '<', + 'ampersand' => '&', + 'comma' => ',', + 'period' => '.', + 'semicolon' => ';', + 'colon' => ':', + 'equal' => '=', + 'minus' => '-', + 'plus' => '+', + 'grave' => '`', + 'rightarrow' => '→', + 'leftarrow' => '←', + 'uparrow' => '↑', + 'downarrow' => '↓', + 'Page_Down' => 'PageDown', + 'Page_Up' => 'PageUp', + 'space' => 'space', + 'KP_Right' => 'KP-→', + 'KP_Left' => 'KP-←', + 'KP_Up' => 'KP-↑', + 'KP_Down' => 'KP-↓', + 'KP_0' => 'KP-0;', + 'greater' => '>', + 'less' => '<', + ); +} else { + + %keycodes = ( + 'asciicircum' => '\\verb=^=', + 'apostrophe' => '\'', + 'bracketleft' => '[', + 'bracketright' => ']', + 'braceleft' => '\\{', + 'braceright' => '\\}', + 'backslash' => '$\\backslash$', + 'slash' => '/', + 'rightanglebracket' => '>', + 'leftanglebracket' => '<', + 'ampersand' => '\\&', + 'comma' => ',', + 'period' => '.', + 'semicolon' => ';', + 'colon' => ':', + 'equal' => '=', + 'minus' => '-', + 'plus' => '+', + 'grave' => '`', + 'rightarrow' => '$\rightarrow$', + 'leftarrow' => '$\\leftarrow$', + 'uparrow' => '$\\uparrow$', + 'downarrow' => '$\\downarrow$', + 'Page_Down' => 'Page Down', + 'Page_Up' => 'Page Up', + 'space' => 'space', + 'KP_' => 'KP$\_$', + 'greater' => '>', + 'less' => '<', ); +} if ($merge_from) { open (BINDINGS, $merge_from) || die ("merge from bindings: file not readable"); @@ -226,10 +291,108 @@ if ($make_accelmap || !$make_cheatsheet) { exit 0; } +if ($html) { + + @groups_sorted_by_number = sort { $group_numbering{$a} <=> $group_numbering{$b} } keys %group_numbering; + + foreach $gk (@groups_sorted_by_number) { + + if ($gk =~ /^m/) { + # mouse stuff - ignore + next; + } + + # $bref is a reference to the array of arrays for this group + $bref = $group_bindings{$gk}; + + if (scalar @$bref > 1) { + + $name = $group_names{$gk}; + $name =~ s/\\linebreak.*//; + $name =~ s/\\&/&/; + $name =~ s/\$\\_\$/-/g; + $name =~ s/\\[a-z]+ //g; + $name =~ s/[{}]//g; + $name =~ s/\\par//g; + + print "

$name

\n"; + + $gtext = $group_text{$gk}; + $gtext =~ s/\\linebreak.*//; + $gtext =~ s/\\&/&/; + $gtext =~ s/\$\\_\$/-/g; + $gtext =~ s/\\[a-z]+ //g; + $gtext =~ s/[{}]//g; + $gtext =~ s/\\par//g; + + if (!($gtext eq "")) { + print "$gtext\n\n"; + } + + # ignore the first entry, which was empty + + shift (@$bref); + + # set up the list + + print "
\n"; + + # sort the array of arrays by the descriptive text for nicer appearance, + # and print them + + for $bbref (sort { @$a[1] cmp @$b[1] } @$bref) { + # $bbref is a reference to an array + + $binding = @$bbref[0]; + $text = @$bbref[1]; + + if ($binding =~ /:/) { # mouse binding with "where" clause + ($binding,$where) = split (/:/, $binding, 2); + } + + foreach $k (keys %cs_modifier_map) { + $binding =~ s/\@$k\@/$cs_modifier_map{$k}/; + } + + # remove braces for HTML + + $binding =~ s/>/\+/; + + # substitute keycode names for something printable + + $re = qr/${ \(join'|', map quotemeta, keys %keycodes)}/; + $binding =~ s/($re)/$keycodes{$1}/g; + + # tidy up description + + $descr = @$bbref[1]; + $descr =~ s/\\linebreak.*//; + $descr =~ s/\\&/&/; + $descr =~ s/\$\\_\$/-/g; + $descr =~ s/\\[a-z]+ //g; + $descr =~ s/[{}]//g; + $descr =~ s/\\par//g; + + print "
$descr
$binding
\n"; + } + + print "
\n"; + + } + } + print "  \n"; + exit 0; +} + + # Now print the cheatsheet $boilerplate_header = <