(post
 :title "StumpWM on Debian Wheezy"
 :date (make-date* 2013 07 20)
 :tags '("stumpwm" "common lisp" "debian" "wheezy" "wsu")
 :summary "First steps with StumpWM on Debian Wheezy"

 (p [Everyone that's ever talked to me about software development
knows that I am in love with Emacs.  Emacs has a wonderful keyboard
driven interface and is almost infinitely customizable via Emacs Lisp.
I've done a lot of programming in Emacs from my not-so-great laptop
lately.  My laptop has a rather poor 1280x800 resolution and low
performing integrated graphics chip.  Until today, I was running the
GNOME 3 desktop environment on it.  Unlike most people (or perhaps
just a loud minority), I like GNOME 3.  However, I wanted something
that was both less graphics intensive and more keyboard driven than
GNOME Shell and Mutter.])

 (p [Someone on IRC told me about
,(anchor [StumpWM] "http://www.nongnu.org/stumpwm/"),
a window manager written entirely in Common Lisp. I had heard of
StumpWM before, but back then I wasn't an Emacs user and I've never
really stuck with any tiling window manager that I've tried (DWM,
Awesome). Now that I know the power of a fully programmable
environment thanks to Emacs, I decided to give StumpWM a try. After
some initial pains trying to get it to run, I am now using it very
happily.])

 (p [Here is what I had to do to get StumpWM running on Debian Wheezy.])

 (ol
  (li [Install StumpWM] (source-code "sudo apt-get install stumpwm"))

  (li [Create an ,(code [.xinitrc]) file in my home directory with the
following text]
      (source-code "exec stumpwm"))

  (li (p [Workaround clisp "component not found" errors])
      (p [I could not get StumpWM to start until I created the
following symbolic links:])
      (source-code
       "ln -s /usr/share/common-lisp/source/stumpwm/stumpwm.asd \\
      /usr/share/common-lisp/systems/stumpwm.asd
ln -s /usr/share/common-lisp/source/cl-ppcre/cl-ppcre.asd \\
      /usr/share/common-lisp/systems/cl-ppcre.asd"))

  (li (p [Start the X server])
      (source-code "startx")
      (p [I use the GNOME Desktop Manager, so I also created a session
file for StumpWM in ,(code [/usr/share/xsessions/stumpwm.desktop.])])
      (source-code
       "[Desktop Entry]
Encoding=UTF-8
Name=StumpWM
Comment=This session logs you into StumpWM
Exec=stumpwm
TryExec=stumpwm
Icon=
Type=Application")))

 (p [I hope this brief installation guide can be of use to one of you
out there in Internet land.  Perhaps in the future I will write an
article about customizing StumpWM with Common Lisp.]))