Back to files

MENU2WM README

1 Introduction

This document outlines how to build and install menu2wm on your system. No instructions about how it works are given here.

menu2wm is an utility that takes an XML document describing the structure of a menu and converts it to the format expected by the most common window managers.

You may want to check the following URL to see any recent news related to this program:

http://menu2wm.sourceforge.net/

2 License

See the COPYING file included in the distribution file for more information about the BSD license.

3 Building

menu2wm uses Buildtool for its build process. You should read the README.bt file for more information. For convenience, here is a list of the basic steps you will need to issue:

1. Download and install Buildtool. You may use a binary package if there is one available for your system, or download and compile the sources from (this site also contains binary packages):

http://buildtool.sourceforge.net/

2. Configure the sources. Issue the following for a standard setup:

$ buildtool config

Everything should be detected automatically. To change the installation prefix, use the "-p" modifier, like in:

$ buildtool config -p /opt/menu2wm

Note that you must have libxml2 and pkg-config installed in order to get a successful build.

3. Once configured, build the program with:

$ buildtool build

4. And install it:

$ buildtool install

Note: These are very quick instructions. Please take some time to read Buildtool's manual to learn more about it.

4 More information

For more information, read the menu2wm(1) manpage after installing the program.

For a list of authors, read the PEOPLE file.

For a list of changes, read the CHANGES file.

5 Feedback

Comments, criticisms, oppinions, suggestions... everything should be directed to: Julio M. Merino Vidal <jmmv@users.sourceforge.net>.

Thanks for using this program.

---

$Id: README,v 1.1 2003/09/04 21:22:54 jmmv Exp $