minor edit to force reload
[rrq/newlisp/pinwin.git] / README.md
1 pinwin - making the side monitor sticky
2 =======================================
3
4 This newlisp script acts as an X event daemon that recognizes window
5 movements and "pins" windows when moved to the side monitor, whereas
6 windows moved to the main monitor are un-pinned.
7
8 A pinned window shows up on all workspaces whereas an unpinned one
9 stays on a single workspace.
10
11 ( I think some window managers might support the "pin windows on side
12 monitor" function already, but I couldn't find this for my xfce4)
13
14 Note that the newlisp script `pinwin.lsp` implements the assumption
15 that the side monitor is to the right of the main monitor. Any other
16 set up will require an appropriate adjustment.
17
18 BUILD
19 =====
20
21 Note that daemonizing shell script `pinwin.sh` expects the embedded
22 binary, `pinwin`, which is made using the `-x` argument to newlisp. For
23 example:
24
25     $ newlisp -x pinwin.lsp pinwin
26     $ chmod a+x pinwin
27
28 RUN
29 ===
30
31 The daemon is run as a detached process. For example:
32
33     $ ( ./pinwin.sh & )