Package: wmii-doc
Version: 1:1-4
Severity: normal
Tags: patch
The command "wmiir read DIR/" does not print a directory listing
anymore. Instead, it produces garbage output. It should now be replaced
by "wmiir ls DIR/".
I corrected these commands in the beginner guide.
I also realised that the "bar/" wmii directory does no longer exist, and
is replaced by two ones: "lbar/" and "rbar/". As they are refered to in
the same paragraphs than some "wmiir read DIR/" commands, I corrected it
too.
-- System Information:
Debian Release: lenny/sid
APT prefers testing
APT policy: (990, 'testing'), (500, 'unstable'), (500, 'stable')
Architecture: i386 (i686)
Kernel: Linux 2.6.23.11
Locale: LANG=fr_FR.UTF-8, LC_CTYPE=fr_FR.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash
wmii-doc depends on no packages.
Versions of packages wmii-doc recommends:
ii wmii 3.6+debian-4 lightweight tabbed and tiled X11 w
-- no debconf information
--- orig/wmii-doc-1/beginnersguide-en/beginnersguide.tex 2006-06-18
14:14:49.000000000 +0200
+++ wmii-doc-1/beginnersguide-en/beginnersguide.tex 2008-01-11
11:44:16.000000000 +0100
@@ -533,7 +533,7 @@
manually with the \emph{-a address} command line option.
A sample invocation looks like:
\begin{verbatim}
- wmiir read /
+ wmiir ls /
\end{verbatim}
This command actually prints the contents of the root directory of the
virtual file-system of \wmii.
@@ -637,12 +637,12 @@
unobtrusively exported with the following \emph{environment variables}.
\begin{verbatim}
- WMII_SELCOLORS='#000000 #eaffff #8888cc'
+ WMII_FOCUSCOLORS='#000000 #eaffff #8888cc'
WMII_NORMCOLORS='#000000 #ffffea #bdb76b'
WMII_FONT=static
\end{verbatim}
- \verb+WMII_SELCOLORS+ defines the colours of the selected client's window
+ \verb+WMII_FOCUSCOLORS+ defines the colours of the selected client's window
title and border, whereas \verb+WMII_NORMCOLORS+ defines the colours of all
unselected clients. The numbers are hexadecimal rgb tuple-values, which you
might know from HTML. You can grab them with the Gimps colour-chooser for
instance.
@@ -658,43 +658,40 @@
\subsection{Filling the status-bar}
\label{subsec:status}
- The status bar of \wmii{} has its own \verb+/bar+ directory with
- a subdirectory for each of the labels created. So while editing
+ The status bar of \wmii{} has two directories: \verb+/lbar+ for its
+ left side, and \verb+/rbar+ for its rigth side. They contains
+ a file for each of the labels created. So while editing
this document my status-bar looked like:
\begin{verbatim}
- $ wmiir read /bar
- d-r-x------ salva salva 0 Mon Apr 17 14:19:51 2006 1
- d-r-x------ salva salva 0 Mon Apr 17 14:19:51 2006 2
- d-r-x------ salva salva 0 Mon Apr 17 14:19:51 2006 status
+ $ wmiir ls -l /lbar
+ --rw------- salva salva 0 Mon Apr 17 14:19:51 2006 1
+ --rw------- salva salva 0 Mon Apr 17 14:19:51 2006 2
+ $ wmiir ls -l /rbar
+ --rw------- salva salva 0 Mon Apr 17 14:19:51 2006 status
\end{verbatim}
- At the same time each of the subdirectories contains two files,
+ Colors (optional) and label texts are defined in these files:
\begin{verbatim}
- $ wmiir read /bar/status
- --rw------- salva salva 23 Mon Apr 17 14:22:14 2006 colors
- --rw------- salva salva 23 Mon Apr 17 14:22:14 2006 data
+ $ wmiir read /lbar/1
+ #000000 #eaffff #8888cc 1
\end{verbatim}
- The first file contains the colour definitions that control how the
- bar will be drawn, while the second contains the data
- which is displayed.
-
Now you can start your own experiments by creating a new label, and
exploring and modifying it by reading \& writing values to its
- \verb+colors+ \& \verb+data+ files. A nice feature of the bar
- (and clients) is that they generate events corresponding to mouse
- clicks on them. You can open a terminal and run
- \verb+wmiir read /event+ to see how the events are generated
- when you click onto the status-bar. This is a mechanism that allows
- controlling applications directly from the bar. If you've
- finished and you want to get rid of your label,
- a \verb+wmiir remove /bar/foo+ command.
+ file. A nice feature of the bar (and clients) is that they generate
+ events corresponding to mouse clicks on them. You can open a
+ terminal and run \verb+wmiir read /event+ to see how the events are
+ generated when you click onto the status-bar. This is a mechanism
+ that allows controlling applications directly from the bar. If
+ you've finished and you want to get rid of your label, just issue a
+ \verb+wmiir remove /{l|r}bar/foo+ command.
If you want to learn more, take a look at the status script and
- visit \hrefx{http://wmii.de} for good examples, like the following:
+ visit \hrefx{http://wmii.de}\footnote{That site seems dead, maybe it has
moved?}
+ for good examples, like the following:
\begin{itemize*}
\item \emph{status}: monitoring remaining battery, temperature, \dots on
laptops
