1FvwmConsoleC.pl(1)               Fvwm Modules               FvwmConsoleC.pl(1)
2
3
4

NAME

6       FvwmConsoleC.pl - Command editor for fvwm command input interface
7

SYNOPSIS

9       FvwmConsole -e /usr/X11/lib/fvwm/FvwmConsoleC.pl
10
11
13       Copyright 1996, Toshi Isogai. No guarantees or warranties are provided.
14       Use this program at your own risk. Permission to use this  program  for
15       any purpose is given, as long as the copyright is kept intact.
16
17
18

DESCRIPTION

20       FvwmConsoleC.pl  offers  editing  capabilities   while   the   user  is
21       entering  the line.  By default, the line editing commands are  similar
22       to  those of emacs. It also offers substitution , which replaces a pat‐
23       tern to a string before it sends the command.
24
25

FUNCTIONS

27       Functions are bound to a key or key combination to be invoked. The fol‐
28       lowings are functions available and their default key bindings.
29
30              bind   Meta-k, Ctrl-x Ctrl-b
31                     List up key bindings and substitutions.
32
33              boh
34                     Move to the beginning of history.
35
36              boh_ign_mode  Esc-<
37                     Move  to  the  beginning  of  history. If it is in search
38                     mode, continue.
39
40              bol    Home, Ctrl-a
41                     Move cursor to the beginning of the line.
42
43              bs[(n)] BackSpace, Ctrl-h
44                     Backspace n times. default of n is 1.
45
46              cancel Ctrl-x Ctrl-k
47                     Cancel the current input.
48
49              del_back_line
50                     Delete the line from the beginning to the cursor.
51
52              del_back_word Ctrl-w
53                     Delete the word from the beginning to the cursor.
54
55              del_char [(n)] Delete, Ctrl-d
56                     Delete n characters from the cursor to the right. Default
57                     of n is 1.
58
59              del_forw_line Ctrl-k
60                     Delete the line from the cursor to the end.
61
62              del_forw_word Meta-d
63                     Delete the word from the cursor to the end.
64
65              del_line Ctrl-u
66                     Delete the entire line.
67
68              enter  Enter, Ctrl-j, Ctrl-m
69                     Perform  substitution  if applicable and send the line to
70                     fvwm.
71
72              enter_wo_subst Meta-Enter
73                     Send the line to fvwm without any substitution.
74
75              eoh
76                     Move to the end of history.
77
78              eoh_ign_mode Esc->
79                     Move to the end of history. If it is in search mode, con‐
80                     tinue.
81
82              eol    End, Ctrl-e
83                     Move the cursor to the end of line.
84
85              ins_char (str)
86                     Insert string at the cursor.
87
88              ins_last_word Esc-.
89                     Insert  the  last argument of the previous command at the
90                     cursor.
91
92              ins_nth_word Meta-[1..9]
93                     Insert the n-th argument of the previous command  at  the
94                     cursor.
95
96              list_func Meta-l
97                     List up available editing functions.
98
99              next_char Right, Ctrl-f
100                     Move the cursor to the next character.
101
102              next_line Down, Ctrl-n
103                     Move to the next line in history.
104
105              next_word Meta-f
106                     Move the cursor to the next word.
107
108              prefix
109                     Wait for the next character typed in  for multi-key bind‐
110                     ing.
111
112              prev_char Left, Ctrl-b
113                     Move the cursor to the previous character.
114
115              prev_line Up, Ctrl-p
116                     Move to the previous line in history.
117
118              prev_word Meta-b
119                     Move the cursor to the previous word.
120
121              quote  Ctrl-q
122                     Insert the next character  typed  into  the  buffer  lit‐
123                     erally.
124
125              search Ctrl-s
126                     Search pattern in history.
127
128              search_rev Ctrl-r
129                     Search pattern in history in reverse order.
130
131              subst  Meta-s
132                     Substitute  all patterns to strings and reprint the line.
133                     The substitutions are not nested  and  performed  in  the
134                     order that they are defined.
135
136

CONFIGURATION

138       The  key binding can be overridden or defined in fvwm module configura‐
139       tion.
140
141              *FvwmConsole: Key \ck prev_line
142
143       Non-space character sequence need not be quoted.  In order to undefine,
144       omit the last argument.
145
146              *FvwmConsole: Key \ck
147
148       Note  that non-meta character is case sensitive.  \c means control key,
149       \e means escape, and \m is alt key.
150       It also accepts Subst configuration. Users often input long  fvwm  com‐
151       mand  repeatedly.  Subst will replace particular input sequence to user
152       defined string. Example:
153
154              *FvwmConsole: Subst '^bigx' 'Exec xterm -g 120x60+0+0 -fn  10x20
155              -fg black -bg lemonchiffon'
156
157       Typing 'bigx<return>' in FvwmConsole will launch xterm. '^' denotes the
158       beginning of line in regular expression.  ´pl´ in  the  middle  of  the
159       command  will  not be replaced. Although the format looks different, it
160       takes Perl regular expression.  It just uses single or double quote  as
161       the  delimiter.   Single  or double quotes have no difference, although
162       they have to match, and cannot include itself in the string.
163
164              *FvwmConsole: Subst '^g\s*(\d+)' 'Desk 0 0\nGotoPage  0  $1\nFo‐
165              cus'
166
167       Entering 'g4' or 'g  4' will jump to desk 0 page 0 4 and focus.
168
169

INVOCATION

171       FvwmConsoleC.pl should be invoked by FvwmConsole.
172
173

SEE ALSO

175       FvwmConsole(1x), perlre(1)
176
177

AUTHOR

179       Toshi Isogai
180
181
182
1833rd Berkeley Distribution  05 September 2019 (2.6.9)        FvwmConsoleC.pl(1)
Impressum