# =========================================================================
# Copyright 2004 Josh Glover <unix@jmglov.net>
#
# LICENCE:
#
#   This work is licensed under the Creative Commons Attribution-ShareAlike
#   License. To view a copy of this license, visit:
#
#   http://creativecommons.org/licenses/by-sa/2.0/
#
#   or send a letter to:
#
#   Creative Commons
#   559 Nathan Abbott Way
#   Stanford, California 94305, USA.
#
# blackbox-to-fluxbox.txt
#
# DESCRIPTION:
#
#   Captain's Log for migrating from the Blackbox window manager to the
#   FluxBox window manager on a Gentoo Linux system.
#
# USAGE:
#
#   Read the Captain's Log, pasting bits into your terminal once you
#   have verified that all paths, settings and so on are right for your
#   environment, *OR*, copy the Captain's Log somewhere on your box,
#   edit it to fit your environment, and run it (possibly as root):
#
#   bash blackbox-to-fluxbox.txt
#
# MODIFICATIONS:
#
#   Josh Glover <unix@jmglov.net> (2004/07/02): Initial revision
# =========================================================================

# 1. Install FluxBox package
sudo emerge fluxbox

# 2. Create FluxBox configuration directory
mkdir ~/.fluxbox

# 3. Convert menu(s)
cp ~/.blackbox/menu ~/.fluxbox/
sed -i.blackbox \
  -e '/bbkeys/d' \
  -e 's|^\[begin\] (Blackbox)$|[begin] (Fluxbox)|' \
  -e 's|^\( \+\)\(\[stylesdir\].\+\)$|\1\2\
\1[stylesdir] (/usr/share/fluxbox/styles)|' \
  ~/.fluxbox/menu

# 4. Convert .bbkeysrc to FluxBox keys-file
cd /tmp
wget http://fluxbox.sourceforge.net/download/convertkeys
bash ./convertkeys -k ~/.bbkeysrc >~/.fluxbox/keys
# You will now need to edit the ~/.fluxbox/keys file by hand, using
# the FluxBox manual for reference:
#
# http://www.fluxbox.org/docbook/en/html/c287.html
#
# Not sure why the conversion script makes such a mess of things, but
# it will at least give you a starting point. You can also use my
# ~/.fluxbox/keys for reference:
#
# http://www.jmglov.net/unix/dotfiles/.fluxbox/keys

# 5. Replace Blackbox with FluxBox in .xinitrc (gdm / kdm / xdm users
#    can safely skip this step)
sed -i.bak -e 's/^blackbox$/fluxbox/' -e 's/^\(bbkeys.\+\)$/#\1/g' \
  ~/.xinitrc

# 6. Restart X