Files
w3m/doc/README.menu
Trafficone 57dfbe309c Minor Fixes of English Docs (#1)
* Translating Documentation

* Create README.SSL from doc-jp

* Clarified wording on some functions

* Clarified English in README.img

* Created README.keymap

* Translated README.menu

* Minor grammar changes
2022-11-29 00:07:55 +09:00

106 lines
3.3 KiB
Plaintext

w3m menu options
(2002/11/27) H. Sakamoto
hsaka@mth.biglobe.ne.jp
[1] Hotkeys
* General Purpose
HELP, INS key : open menu
HELP, INS key, C-c, : close menu
RET(C-m, C-j), SPC, right-key : select
BS(C-h), DEL(C-?), left-key : go back
C-n, j, down-key : go to lower selection
C-p, k, up-key : go to upper selection
J : scroll down
K : scroll up
C-a : previous heading
C-e : next heading
C-f, C-v : next page
C-b, M-v : last page
C-s, / : search down
C-r, ? : search up
n : search for next
N : search for previous
C-z : suspend
# INS is normally ^[[2~ but is bound to ^[[L(console), ^[[E(PocketBSD).
MenuKeymap, MenuEscKeymap, MenuEscBKeymap, MenuEscDKeymap are defined
in (menu.c)
* Special Case
MenuItem structure (menu.h) is set as (possibly multiple)
char * keys
from the keys listed above.
[2] Mouse
Button 3: open menu
After opening the menu
button 1/3 (heading) : select
button 1/3 (frame, MENU_NOP) : nothing
button 1/3 (outside menu) : go back (close menu)
button 1/3 ( : ) : next page or prev page heading
(in case of long menu)
button 1/3 (drag) : scroll
[3] menu customization
menu is defined in ~/.w3m/menu
menu is
menu MENU_ID
heading
:
end
For settings, every heading is
func LABEL FUNCTION KEYS [DATA] //command execution
popup LABEL MENU_ID KEYS //open sub-menu
nop LABEL //no action (separator or title)
are possible settings.
Look at menu.defualt and menu.submenu for examples.
Look at README.func for setting commands (FUNCTION).
For MENU_ID "Main" is the main menu, "Select" is buffer
choice menu, "SelectTab" is the tab selection menu.
For KEYS, the key to be bound to the menu.
For DATA, set the command (FUNCTION) arguments.
[4] Development
See Below to understand menu routines such as mainMenu(),
optionMenu() etc.
The MenuItem routine structure is defined below, almost
all menus are constructed like this.
MenuItem 構造体 (menu.h)
struct {
int type; /* type */
char *label; /* label */
int *variable; /* VALUE_MENU variable settings */
int value; /* VALUE_MENU variable value */
void (*func)(); /* function choice */
struct _Menu *popup; /* submenu */
char *keys; /* bound keys */
} MenuItem;
Type "type" used below.
MENU_NOP (1) : No action, no setting.
(title and separator)
MENU_FUNC (2) : function execution
MENU_VALUE (4) : (*variable) and (value) setting
MENU_POPUP (8) : submenu to open
MENU_FUNC and MENU_VALUE are (MENU_FUNC | MENU_VALUE) and
need to be set together。(variable needs to be set)
Example of MainMenuItem and new_option_menu() can be seen in (menu.c).