From 092f3bbd038d3d342fd73604b33c9979450cd973 Mon Sep 17 00:00:00 2001 From: seanpringle Date: Sat, 30 Jun 2012 03:29:23 +1000 Subject: [PATCH] docs, pkgbuild --- PKGBUILD | 43 +++++++++++++++++ simpleswitcher.1 | 121 +++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 164 insertions(+) create mode 100644 PKGBUILD create mode 100644 simpleswitcher.1 diff --git a/PKGBUILD b/PKGBUILD new file mode 100644 index 00000000..1690179a --- /dev/null +++ b/PKGBUILD @@ -0,0 +1,43 @@ +# Contributor: Sean Pringle + +pkgname=simpleswitcher-git +pkgver=20120625 +pkgrel=1 +pkgdesc="simple EWMH window switcher" +arch=('i686' 'x86_64') +url="http://github.com/seanpringle/simpleswitcher" +license=('MIT') +depends=('libx11' 'libxft' 'freetype2') +makedepends=('git') +provides=('simpleswitcher') + +_gitroot="git://github.com/seanpringle/simpleswitcher.git" +_gitname="simpleswitcher" + +build() { + cd "$srcdir" + msg "Connecting to GIT server...." + + if [ -d $_gitname ] ; then + cd $_gitname && git pull origin + msg "The local files are updated." + else + git clone $_gitroot --depth=1 + fi + + msg "GIT checkout done or server timeout" + msg "Starting make..." + + rm -rf "$srcdir/$_gitname-build" + cp -r "$srcdir/$_gitname" "$srcdir/$_gitname-build" + cd "$srcdir/$_gitname-build" + + make +} + +package() { + cd "$srcdir/$_gitname-build" + install -Dm 755 $_gitname "$pkgdir/usr/bin/simpleswitcher" + gzip -c "$_gitname.1" > "$_gitname.1.gz" + install -Dm644 "$_gitname.1.gz" "$pkgdir/usr/share/man/man1/$_gitname.1.gz" +} \ No newline at end of file diff --git a/simpleswitcher.1 b/simpleswitcher.1 new file mode 100644 index 00000000..160ac7b9 --- /dev/null +++ b/simpleswitcher.1 @@ -0,0 +1,121 @@ +.TH SIMPLESWITCHER 1 simpleswitcher +.SH NAME +simpleswitcher \- a simple EWMH window switcher +.SH SYNOPSIS +.B simpleswitcher +.RB [ \-width +.IR pct_scr ] +.RB [ \-lines +.IR lines ] +.RB [ \-font +.IR xftfont ] +.RB [ \-fg +.IR color ] +.RB [ \-bg +.IR color ] +.RB [ \-hlfg +.IR color ] +.RB [ \-hlbg +.IR color ] +.RB [ \-key +.IR combo ] +.RB [ \-dkey +.IR comdo ] +.RB [ \-now ] +.RB [ \-dnow ] + +.SH DESCRIPTION +.I simpleswitcher +is an X11 popup window switcher. A list is displayed center-screen showing open window titles, WM_CLASS, and desktop number. The user may filter the list by typing, navigate with Up/Down or Tab keys, and select a window with Return (Enter). Escape cancels. +.P +License: MIT/X11 +.SH USAGE +See options below for custom key combinations. These are the defaults. +.TP +.B F12 +Show all windows on all desktops. +.TP +.B F11 +Show windows from the current desktop. +.SH OPTIONS +.TP +.B -key +Change the key combination to display all windows (default: F12). +.P +.RS +simpleswitcher -key F12 +.br +simpleswitcher -key control+shift+s +.br +simpleswitcher -key mod1+tab +.RE +.TP +.B -dkey +Change the key combination to display window on the current desktop (default: F11). +.P +.RS +simpleswitcher -key F11 +.br +simpleswitcher -key control+shift+d +.br +simpleswitcher -key mod1+grave (grave=backtick) +.RE +.TP +.B -now +Run simpleswitcher in all-windows mode once then exit. Does not bind any keys. +.TP +.B -dnow +Run simpleswitcher in current-desktop-windows mode once then exit. Does not bind any keys. +.TP +.B -bg +Set the background text color (X11 named color or hex #rrggbb) for the menu (default: #222222). +.P +.RS +simpleswitcher -fg "#222222" +.RE +.TP +.B -fg +Set the foreground text color (X11 named color or hex #rrggbb) for the menu (default: #cccccc). +.P +.RS +simpleswitcher -fg "#cccccc" +.RE +.TP +.B -font +Xft font name for use by the menu (default: mono-14). +.P +.RS +simpleswitcher -font monospace-14:medium +.RE +.TP +.B -hlbg +Set the background text color (X11 named color or hex #rrggbb) for the highlighted item in the menu (default: #005577). +.P +.RS +simpleswitcher -fg "#005577" +.RE +.TP +.B -hlfg +Set the foreground text color (X11 named color or hex #rrggbb) for the highlighted item in the menu (default: #ffffff). +.P +.RS +simpleswitcher -fg "#ffffff" +.RE +.TP +.B -lines +Maximum number of entries the menu may show before scrolling (default: 25). +.P +.RS +simpleswitcher -lines 25 +.RE +.TP +.B -width +Set the width of the menu as a percentage of the screen width (default: 60). +.P +.RS +simpleswitcher -width 60 +.RE +.SH SEE ALSO +.BR simpleswitcher (1) +.SH AUTHOR +Sean Pringle