WorkMan requires XView version 3 or higher. This is supplied by default on Sun systems (though you may have to select the "OpenWindows Developers" category from your SunOS or Solaris CD to get the necessary files for compiling) and is available as part of the "contrib" distribution in X11R5 and X11R6 for other systems. Some X11 distributions part libraries from the "development" files. The latter are required for compiling WorkMan.
Some of the Makefiles assume that OPENWINHOME is set to the Sun OpenWindows 3.x home directory. Some tweaking will probably be required if you're not using OpenWindows; OPENWINHOME is used to locate the XView include files and libraries. If you are searching for your OPENWINHOME path, try to find the subdirectories include/xview. On my Linux box it's /usr/openwin/include/xview. In this case, OPENWINHOME must be /usr/openwin.
NOTE: If you are reading this document, you are trying to get WorkMan 1.3b-BETA running. If not, that means for any earlier version of Workman (up to 1.3a), this document is too new. Please read the documentation enclosed in your package.
How you build WorkMan depends on which platform you're trying to build it on. Please review the file config.h for compile time options like default CD-ROM device or Soundcard mixer support. config.h has several sections, for each platform one section. The first section to be found is "general options". In this section you can configure compile-time options that take effect on every supported platform (hopefully).
On most platforms, you can configure WorkMan to use a database library from 4.4BSD to look CDs up very quickly. More details on that below.
I'm unsure about the functionality of the Imakefile. Please use this with caution. Any hints regarding the Imakefile are welcome.
Now following are the configuration/installation hints for WorkMan 1.3a. These may be out of date. If the above method doesn't work, please have a look at these older hints and tell me how you succeeded.
WorkMan can optionally make use of the 4.4BSD "libdb" package to speed up database lookups tremendously. Here's how to use it.
cd db.1.85/PORT
make
cd ../../..
).
make
(with appropriate arguments, e.g.
-f Makefile.linux
, for your system.)
If you have an old WorkMan database sitting around, you should build an index
file for it; WorkMan itself only writes to the index file when you save or
update a CD. There's a program called "buildindex" to build index files.
Type "make buildindex
" (specifying an alternate Makefile as
appropriate) after you've built WorkMan. To run buildindex, just give it the
path to your database file as an argument, e.g. "buildindex
$HOME/.workmandb
".
One thing to be careful of is using libdb on a database you're sharing via NFS on a system without working file locking. If you run WorkMan with the "-n" option to bypass the file locking code, you risk corrupting the index file if two people save CDs at once. If you're the only one using a CD database, or the only one with write access to it, you can safely use -n in conjunction with libdb; it's only when two or more entries are saved simultaneously that problems can occur. In that case the best solution is to bug your sysadmin, or your UNIX vendor, to give you working file locking.
Once the executable is built, install it in your favorite directory for such things. The file "workman.info" should be placed in the XView help directory, usually $OPENWINHOME/lib/help. If you put it somewhere else, be sure to set your HELPPATH environment variable to point to that directory. This is necessary if you want to use the Help key to see the controls' descriptions. Run "make install" to install everything under $OPENWINHOME. You will probably need to be root to do this.
Once all that's done, you're ready to rock and roll (or jazz, or...)