From: Dana Jansens Date: Fri, 16 Aug 2002 19:31:54 +0000 (+0000) Subject: add a manpage for epistrc. Update the epist mapage a bit. X-Git-Url: https://git.brokenzipper.com/gitweb?a=commitdiff_plain;h=7c841bbfccbdfce041a6b57dbb562e5e0d59d307;p=chaz%2Fopenbox add a manpage for epistrc. Update the epist mapage a bit. --- diff --git a/util/epist/Makefile.am b/util/epist/Makefile.am index 61d2f658..87ae049e 100644 --- a/util/epist/Makefile.am +++ b/util/epist/Makefile.am @@ -2,14 +2,14 @@ DEFAULT_RC=$(pkgdatadir)/epistrc -CLEANFILES = epist.1 +CLEANFILES = epist.1 epistrc.5 CPPFLAGS= @CPPFLAGS@ @DEBUG@ -DDEFAULTRC=\"$(DEFAULT_RC)\" #EXTRA_PROGRAMS = epist bin_PROGRAMS = epist -man_MANS = epist.1 +man_MANS = epist.1 epistrc.5 epist_SOURCES = epist.cc window.cc screen.cc main.cc actions.cc yacc_parser.cc parser.cc keytree.cc lex.yy.c epist_LDADD = ../../src/XAtom.o ../../src/BaseDisplay.o \ @@ -27,6 +27,10 @@ epist.1: epist.1.in @regex_cmd@ -e "s,@pkgdatadir@,$(pkgdatadir)," \ epist.1.in > epist.1 +epistrc.5: epistrc.5.in + @regex_cmd@ -e "s,@pkgdatadir@,$(pkgdatadir)," \ + epistrc.5.in > epistrc.5 + install-data-local: epistrc test -f $(DESTDIR)$(pkgdatadir)/epistrc || \ $(INSTALL_DATA) epistrc $(DESTDIR)$(pkgdatadir) diff --git a/util/epist/epist.1.in b/util/epist/epist.1.in index 12be7110..d73beb60 100644 --- a/util/epist/epist.1.in +++ b/util/epist/epist.1.in @@ -1,4 +1,4 @@ -.TH epist 1 "August 2002" "epist" "v0.0" +.TH epist 1 "August 2002" "epist" "v1.0" .SH NAME epist - NetWM keybindings grabber .SH SYNOPSIS @@ -18,9 +18,9 @@ rather than the mouse. .SH CONFIGURATION \fBepist\fR will read its configuration from \fI~/.openbox/epistrc\fR otherwise a default configuration, installed in \fI@pkgdatadir@/epistrc\fR -will be used. +will be used. See \fIepistrc\fR(5) for more details on the format of the file. .SH AUTHOR The authors of epist are Scott Moynes , Marius Nita , and Ben Jansens . .SH SEE ALSO -\fIopenbox\fR(1) +\fIopenbox\fR(1) \fIepistrc\fR(5) diff --git a/util/epist/epistrc.5.in b/util/epist/epistrc.5.in new file mode 100644 index 00000000..3ebdde4f --- /dev/null +++ b/util/epist/epistrc.5.in @@ -0,0 +1,147 @@ +.TH epistrc 4 "August 16, 2002" +.SH NAME +epistrc \- Configuration file for Epist +.SH SYNOPSIS +.B $HOME/.openbox/epistrc +.B @pkgdatadir@/epistrc +.SH DESCRIPTION +\fIepist\fR(1) grabs its configuration and bindings from the epistrc file. +.SH SYNTAX +The epistrc file contains 2 sections: +.SS options +All of the options for epist are contained inside an options {} clause, such as +this: +options { +blef 5; +} +.SS bindings +Bindings are specified in this format: +.br + ; +.PP +Bindings with chains are specified in this format: +.br + { +.br + ; +.br +} +.PP +The is made up of a list of modifiers and a single key. The possible modifiers are: \fIControl\fR, \fIShift\fR, \fRMod1\fI (usually the Alt key), \fRMod2\fI, \fRMod3\fI, \fRMod4\fI (usually the "windows" key), and \fRMod5\fI. You may also specify a without any modifiers. +.PP +You may also nest as many chains as you want. Some examples of bindings are: +.br +Mod1-Tab nextWindow; +.br +Mod1-Shift-Tab prevWindow; +.br +Mod1-F1 changeWorkspace 1; +.br +Mod1-F2 changeWorkspace 2; +.br +Control-F1 execute "xterm"; +.br +Control-Mod1-x { +.br + i iconify; +.br + r raise; +.br + l lower; +.br +} +.SH COMMANDS +.SS execute +Runs a shell command. Takes a single string argument, in ""s. +.SS iconify +Iconifies the currently focused window. +.SS raise +Raises the currently focused window to the top of the stacking order. +.SS lower +Lowers the currently focused window to the bottom of the stacking order. +.SS close +Closes the currently focused window. +.SS toggleshade +Shades and Unshades the currently focused window. +.SS toggleomnipresent +Sends the window to all workspaces, or moves it from all workspaces to the +current one. +.SS moveWindowUp +Move the window up. Takes a single numerical parameter, which is the amount to +move the window. +.SS moveWindowDown +Move the window down. Takes a single numerical parameter, which is the amount to +move the window. +.SS moveWindowLeft +Move the window left. Takes a single numerical parameter, which is the amount to +move the window. +.SS moveWindowRight +Move the window right. Takes a single numerical parameter, which is the amount +to move the window. +.SS resizeWindowWidth +Resizes the window's width. Takes a single numerical parameter, which is the +amount to resize the window by. A positive number enlarges the window, a +negative value shrinks the window. +.SS resizeWindowHeight +Resizes the window's height. Takes a single numerical parameter, which is the +amount to resize the window by. A positive number enlarges the window, a +negative value shrinks the window. +.SS toggleMaximizeFull +Maximizes and Unmaxizes the currently focused window. +.SS toggleMaximizeVertical +Maximizes and Unmaxizes the currently focused window vertically. +.SS toggleMaximizeHorizontal +Maximizes and Unmaxizes the currently focused window horizontally. +.SS sendToWorkspace +Sends the currently focused window to another workspace. This takes a single +numberical parameter, which is the workspace to send the window to. Workspace +numbers begin at 1. +.SS nextWindow +Cycles focus to the next window on the workspace. +.SS prevWindow +Cycles focus to the previous window on the workspace. +.SS nextWindowOnAllWorkspaces +Cycles focus to the next window on all workspaces, switching between workspaces +as neccessary. +.SS prevWindowOnAllWorkspaces +Cycles focus to the previous window on all workspaces, switching between +workspaces as neccessary. +.SS nextWindowOnAllScreens +Cycles focus to the next window on all screens (in a multi-head setup). +.SS prevWindowOnAllScreens +Cycles focus to the previous window on all screens (in a multi-head setup). +.SS nextWindowOfClass +Cycles focus to the next window of a certain class on the current workspace. +This can take a single string parameter, in ""s, specifying the class of the +window to cycle to. If the parameter is omitted, the class of the currently +focused window is used. +.SS prevWindowOfClass +Cycles focus to the previous window of a certain class on the current workspace. +This can take a single string parameter, in ""s, specifying the class of the +window to cycle to. If the parameter is omitted, the class of the currently +focused window is used. +.SS nextWindowOfClassOnAllWorkspaces +Cycles focus to the next window of a certain class on all workspaces. This can +take a single string parameter, in ""s, specifying the class of the window to +cycle to. If the parameter is omitted, the class of the currently focused +window is used. +.SS prevWindowOfClassOnAllWorkspaces +Cycles focus to the previous window of a certain class on all workspaces. This +can take a single string parameter, in ""s, specifying the class of the window +to cycle to. If the parameter is omitted, the class of the currently focused +window is used. +.SS changeWorkspace +Changes to a specific workspace. This takes a single numerical paramter, +specifying the number of the workspace to switch to. Workspace numbers begin at +1. +.SS nextWorkspace +Switches to the next workspace. +.SS prevWorkspace +Switches to the previous workspace. +.SS nextScreen +Cycles focus to the next screen (in a multi-head setup). +.SS prevScreen +Cycles focus to the previous screen (in a multi-head setup). + +.SH SEE ALSO +\fIepist\fR(1) \fIopenbox\fR(1)