wm: doc

ref: cc3064e5052e35f8acf7525c31c382fa743c493e
dir: /drawterm-p9.ms/

View raw version
.TL
Drawterm for Plan 9
.SH
Installation
.SM
.SH
Linux
.LP
.SH
Using Debian Repos
.P1
$ sudo apt-get install drawterm
.SH
Building from source on Debian
.P1
$ sudo apt install libx11-dev libxt-dev
$ git clone https://github.com/9fans/drawterm 
$ cd drawterm
$ CONF=unix make
.P2
.SH
Usage
.LP
.P1
$ USER=username; drawterm -u $USER -c example.com -a example.com
.P2  

Replace
.CW username
with your actual username.

If you are using drawterm-9front, you may see strange characters appear when typing
ctrl, alt, and shift keys. You may want to try building it from source to see if
the problem goes away. Or, you might experiment with the -B flag to disable kbdfs.
.SH
Using keyboard keys instead of mouse buttons
.LP
*Warning: Note that this disables numpad, and makes usage of old keys impossible without a X server restart* 
To use keyboard keys instead of a 3 button mouse (on X11), first enable mousekeys
.P1
    $ xkbset m # enables mousekeys
.P2
Open
.CW xev, press on keys you would like to use as mouse keys:
.P1
$ xev -event keyboard
.P2
If you choose keys F1, F2, and F3, the key codes are 67, 68 and 69: 
.P1
$ xmodmap -e "keycode 67 = Pointer_Button1"
$ xmodmap -e "keycode 68 = Pointer_Button2"
$ xmodmap -e "keycode 69 = Pointer_Button3"
.P2

You might also add a few more keybindings for PgUp, PgDn, the Windows key
(Kmod4 for riow), and Delete.

.P1
$ xmodmap -e "keycode 70 = Prior"
$ xmodmap -e "keycode 71 = Next"
$ xmodmap -e "keycode 72 = Super_L"
$ xmodmap -e "keycode 76 = Delete"
.P2



You might consider putting these in ~/.profile.