FvwmConsoleC.pl(1)

💖 FvwmConsoleC.pl(1) 💖

okay bestie, this one lives in the Fvwm Modules crowd 🦋 and it's a command editor for the fvwm command input interface. literally the line-editing main character ✨

✨ NAME ✨

FvwmConsoleC.pl — the command editor for the fvwm command input interface 💅

🎀 SYNOPSIS 🎀

FvwmConsole -e /usr/X11/lib/fvwm/FvwmConsoleC.pl

that's the whole synopsis, no cap 🙈

🧾 COPYRIGHT 🧾

Copyright 1996, Toshi Isogai. Toshi isn't making any guarantees or warranties, so use this program at your own risk 💀. You're free to use it for any purpose, as long as the copyright stays intact 🫶.

🌸 DESCRIPTION 🌸

FvwmConsoleC.pl gives you editing powers while you're typing out a line 😭. By default the line editing commands are similar to emacs 🧚. It also does substitution, which swaps a pattern out for a string before the command gets sent off 🔥.

👑 FUNCTIONS 👑

Functions get bound to a key or key combo so you can invoke them. Here's the full list with their default key bindings, iconic 💖

• bind (Meta-k, Ctrl-x Ctrl-b) — lists up key bindings and substitutions 🗂️
• boh — moves you to the beginning of history ⏪
• boh_ign_mode (Esc-<) — moves you to the beginning of history. If you're in search mode, it keeps going 🔍
• bol (Home, Ctrl-a) — moves the cursor to the beginning of the line 🌅
• bs[(n)] (BackSpace, Ctrl-h) — backspaces n times. The default for n is 1 ⬅️
• cancel (Ctrl-x Ctrl-k) — cancels the current input 🙅
• del_back_line — deletes the line from the beginning to the cursor 🧹
• del_back_word (Ctrl-w) — deletes the word from the beginning to the cursor 💨
• del_char [(n)] (Delete, Ctrl-d) — deletes n characters from the cursor to the right. The default for n is 1 🗑️
• del_forw_line (Ctrl-k) — deletes the line from the cursor to the end 👋
• del_forw_word (Meta-d) — deletes the word from the cursor to the end ✂️
• del_line (Ctrl-u) — deletes the entire line 💥
• enter (Enter, Ctrl-j, Ctrl-m) — performs substitution if it applies and sends the line to fvwm 🚀
• enter_wo_subst (Meta-Enter) — sends the line to fvwm without any substitution 🫸
• eoh — moves you to the end of history ⏩
• eoh_ign_mode (Esc->) — moves you to the end of history. If you're in search mode, it keeps going 🔎
• eol (End, Ctrl-e) — moves the cursor to the end of the line 🌇
• ins_char (str) — inserts a string at the cursor 🧁
• ins_last_word (Esc-.) — inserts the last argument of the previous command at the cursor 🪄
• ins_nth_word (Meta-[1..9]) — inserts the n-th argument of the previous command at the cursor 🔢
• list_func (Meta-l) — lists up the available editing functions 📜
• next_char (Right, Ctrl-f) — moves the cursor to the next character ➡️
• next_line (Down, Ctrl-n) — moves to the next line in history ⬇️
• next_word (Meta-f) — moves the cursor to the next word 🦘
• prefix — waits for the next character you type for a multi-key binding ⏳
• prev_char (Left, Ctrl-b) — moves the cursor to the previous character ⬅️
• prev_line (Up, Ctrl-p) — moves to the previous line in history ⬆️
• prev_word (Meta-b) — moves the cursor to the previous word 🐾
• quote (Ctrl-q) — inserts the next character you type into the buffer literally 🎭
• search (Ctrl-s) — searches for a pattern in history 🕵️
• search_rev (Ctrl-r) — searches for a pattern in history in reverse order 🔙
• subst (Meta-s) — substitutes all patterns with strings and reprints the line 🌈. The substitutions aren't nested, and they're performed in the order they were defined.

🛠️ CONFIGURATION 🛠️

The key bindings can be overridden or defined in the fvwm module configuration 🎀

*FvwmConsole: Key \ck prev_line

Non-space character sequences don't need to be quoted. To undefine a binding, just omit the last argument:

*FvwmConsole: Key \ck

heads up: non-meta characters are case sensitive 👀. \c means control key, \e means escape, and \m is alt key.

FvwmConsole also takes Subst configuration. Y'all input long fvwm commands over and over, so Subst lets you swap a particular input sequence for a string you define 🫶. Like this:

*FvwmConsole: Subst '^bigx' 'Exec xterm -g 120x60+0+0 -fn 10x20 -fg black -bg lemonchiffon'

Typing bigx<return> in FvwmConsole will launch xterm 🚀. The ^ means beginning of line in a regular expression, so pl in the middle of a command won't get replaced 🙅. Even though the format looks different, it's a Perl regular expression. It just uses a single or double quote as the delimiter. Single and double quotes work the same, but they have to match, and the quote character can't appear inside the string itself 💅.

*FvwmConsole: Subst '^g\s*(\d+)' 'Desk 0 0\nGotoPage 0 $1\nFocus'

Entering g4 or g 4 will jump to desk 0 page 0 4 and focus 🧚✨

🎬 INVOCATION 🎬

FvwmConsoleC.pl should be invoked by FvwmConsole 💖

🔗 SEE ALSO 🔗

FvwmConsole(1x), perlre(1) 📚

💜 AUTHOR 💜

Toshi Isogai 🫶

---

And that's the whole page, bestie 💅 Source is 3rd Berkeley Distribution, version 2.7.0, dated 19 October 2022, for FvwmConsoleC.pl(1). Stay iconic 🌈💖