/usr/share/doc/alt-key/help.html is in alt-key 2.2.5-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 | <html>
<title>Alt_Key Help</title>
<body>
<p>
The <font color="#808000"><b>Alt_Key</b></font> program is used to
show where keyboard accelerators (<i>mnemonics</i> in Gtk-speak)
should go in menu option texts and dialog labels. The program produces
optimal results on the basis that the best accelerator is the first
character, the second best is the first character of a word, the third
best is any character, the worst is no accelerator at all, and no
accelerator should be used more than once. (When there are choices the
algorithm favours an uppercase letter at the start of a word over a
lowercase one, and favours words nearer the beginning.)
<p>
Enter a list of strings (such as menu option texts or dialog labels),
one per line, in the left hand text edit. You can use the standard
keyboard shortcuts (e.g., <b>Ctrl+A</b> to select all, <b>Ctrl+C</b> to
copy, <b>Ctrl+X</b> to cut, <b>Ctrl+V</b> to paste, <b>Ctrl+Z</b> to
undo), when editing the text. You can save your strings by clicking
<b>Save</b> (or by pressing <b>Ctrl+S</b>). Once you have entered your
strings, click <b>Calculate</b> and the right hand (read-only, but
selectable with <b>Ctrl+A</b>) text edit will show the same list
of strings but with accelerators added. You can copy the accelerated
strings to the clipboard by clicking the <b>Copy to Clipboard</b>
button.
<p>
If you want to force a particular accelerator to be used (for example,
Cu<u>t</u> in an Edit menu), precede the character to be accelerated
with an ampersand (e.g., Cu&t). If you want a literal &, use
&&. Lines can be turned into comments by starting them with #.
If you want to ensure consistency you can set some global predefined
accelerators in the <b>Options</b> dialog, for example, Cu&t and
&Copy.
<p>
If you want to have more than one list of strings (two or more lists of
menu option texts or two or more sets of dialog labels, perhaps from
different tabs), simply separate each list with a single (uncommented)
blank line—then, when you click <b>Calculate</b> each list will be
calculated individually.
<p>
A summary of the results are output in the log area at the bottom of the
main window.
<p>
The quality is a measure against the optimal results criteria—in
most cases it is impossible to get a quality of 100% (since this means
that the first character of every string is used as an accelerator, and
quite often two or more strings begin with the same character), but
providing there are fewer strings than the alphabet being used (normally
< 36), then a quality of > 50% should be routinely achieved.
<p>
Several example files are supplied; they all have <tt>.acc</tt>
extensions. Now that the Kuhn-Munkres algorithm is used calculations are
always "instantaneous".
</body>
</html>
|