mirror of https://github.com/0intro/wmii
43 lines
1.2 KiB
TeX
43 lines
1.2 KiB
TeX
\begin{Name}{1}{wmiiloop}{Kris Maglione}{}{wmiir}
|
|
\Prog{wmiiloop}-VERSION
|
|
\end{Name}
|
|
|
|
\section{Synopsis}
|
|
\Prog{eval} "\$(\Prog{wmiiloop} <\File{events})"
|
|
|
|
\section{Description}
|
|
|
|
\Prog{wmiiloop} is an awk and sh script which preprocesses \Cmd{sh}{1} syntax
|
|
to simplify writing a wmii event loop.
|
|
|
|
\Prog{wmiiloop} associates lines begining with \emph{Event}, \emph{Action}, or
|
|
\emph{Key} (henceforth known as \textbf{\$keyword}), followed by arbitrary
|
|
text (henceforth known as \textbf{\$args}), with functions which call any
|
|
indented lines which follow. In the function names, all non-alphanumeric
|
|
characters in \textbf{\$args} are replaced with underscores (\_). The
|
|
functions are named \textbf{\$keyword}'_'\textbf{\$args}.
|
|
|
|
Any variables in the unintented lines are interpolated by the shell.
|
|
|
|
Additionally, each declaration's \textbf{\$args} are assigned to a variable
|
|
named \textbf{\$keyword}'s'. In this case, no transliteration occurs. For
|
|
instance, the following declaration:
|
|
|
|
\begin{verbatim}
|
|
Key $MODKEY-j
|
|
echo Got $@
|
|
\end{verbatim}
|
|
yields (assuming \emph{\$MODKEY} is set to \emph{Mod1}):
|
|
|
|
\begin{verbatim}
|
|
Keys=" $Keys Mod1-j"
|
|
Mod1_j() {
|
|
echo Got $@
|
|
}
|
|
\end{verbatim}
|
|
|
|
\section{SEE ALSO}
|
|
\Cmd{wmii}{1}, \Cmd{wmii}{1}. \Cmd{wmiir}{1},
|
|
\File{PREFX/etc/wmiirc}
|
|
|