Gecko [ lorencats.com ]

Name	Size	Permission
xbm	[ DIR ]	drwxr-xr-x
AUTHORS	617 B	-rw-r--r--
COMPLIANCE	2.43 KB	-rw-r--r--
NEWS.Debian.gz	1.29 KB	-rw-r--r--
README	802 B	-rw-r--r--
build.html	3.72 KB	-rw-r--r--
changelog.Debian.gz	13.31 KB	-rw-r--r--
changelog.gz	23.17 KB	-rw-r--r--
config.html	6.38 KB	-rw-r--r--
copyright	4.14 KB	-rw-r--r--
details.html	29.78 KB	-rw-r--r--
menu.xsd.gz	1.79 KB	-rw-r--r--
rc-mouse-focus.xml.gz	3.56 KB	-rw-r--r--
rc.xsd.gz	3.62 KB	-rw-r--r--
toc.html	1.27 KB	-rw-r--r--

Code Editor : build.html

<a href="toc.html">Table of Contents</a>

<h1>Building Openbox</h1>

<h2><a name="compile"></a>Compiling</h2>

The following is what you will need to compile Openbox:

<ul>
 <li>C compiler (such as <a href="http://gcc.gnu.org">GCC</a>).</li>
 <li>Xlib headers and libraries (development package), distributed with
 <a href="http://xfree86.org">XFree86</a>.</li>
 <li><a href="http://fontconfig.org">Fontconfig</a> headers and libraries
 (development package).</li>
 <li><a href="http://www.gtk.org">Glib 2</a> headers and libraries
 (development package)</li>
 <li>Optional: The FreeDesktop.org
 <a href="http://www.freedesktop.org/software/startup-notification/">
 Startup-Notification</a> library.</li>
 </ul>

Once you have the above dependancies installed, you are ready to build
Openbox. Untar the Openbox archive and from inside the source tree, run:

<blockquote>
 % ./configure 
 &nbsp;&nbsp;...configure detects the build evironment... 
 % make 
 &nbsp;&nbsp;...openbox builds... 
 % make install 
 &nbsp;&nbsp;...openbox installs... 
</blockquote>

If the configure command fails and the reason is not obvious, you should
look in the config.log file to discover the cause of the problem.

<h2><a name="install"></a>Installing</h2>

You can install Openbox by <a href="#compile">compiling from source</a> or via
binary packages. It is recommended that you get a package from your
distribution if possible.

Once you have Openbox on your system, you will need to set things up to use it.
What to set up depends on how you run X.

<h3><a name="install-gnome"></a>
 If you run the GNOME desktop environment:</h3>

The default window manager for the GNOME environment is metacity. To
switch from metacity to Openbox, do the following:

<blockquote>
% openbox --replace
</blockquote>

Choose to save your session the next time you log out so that Openbox will be
started for you when you log in again.

Note: As of GNOME 2.4, gnome-panel no longer manages its own key bindings, and requires that the window manager provide its own key bindings for showing the Main Menu and Run dialog. Openbox does this through the bundled gnome-panel-control tool, which can be used in keybindings to access the gnome-panel. Use the --main-menu option to display gnome-panel's menu, and the --run-dialog to display its Run dialog.

<h3><a name="install-kde"></a>
 If you run the K desktop environment:</h3>

The default window manager for the KDE environment is kwin. To switch
from kwin to Openbox, set the following environment variable in your startup
scripts:

<blockquote>
% export KDEWM=openbox
</blockquote>

When the KDEWM environment variable is set, Openbox will be used in
place of kwin.

<h3><a name="install-startx"></a>
 If you run X via the startx command:</h3>

You need to edit your $HOME/.xinitrc file. This file is simply
a shell script, so to lauch Openbox just make a file something like this:

<blockquote>
 # Startup stuff for X 
 
 exec openbox 
</blockquote>

<h3><a name="install-xdm"></a>
 If you run X via a display manager (xdm, gdm, kdm, ...):</h3>

You may consult the documentation for your specific display manager regarding
adding entries to it. Alternately, you can edit a $HOME/.xsession file.
The file is a shell script and can be made identical to the .xinitrc
example above. With this method, you would choose default as the login
target in your display manager.

<a href="toc.html">Table of Contents</a>

${this.title}

Code Editor : build.html