Building and installing the user interface

Unix/Linux version

Qt4 library and tools

If you don't already have the Qt4 library for Unix/X11, get it from Trolltech if you plan to build it yourself, or as pre-compiled packages from your vendor or GNU/Linux distribution.

When using a packaged version of Qt4 provided by a vendor or a distribution, more than just the development version of the library may be needed, since Qt is typically split into several packages. For example under Debian GNU/Linux (etch), the following packages are necessary:

manitou

In the manitou source directory, run ./configure.

If the configure script can't find Qt or the postgres client headers and library, it might be necessary to specify their locations using the following options:

Once the configuration step is successful, type 'make' followed by 'make install'

Windows version

Starting from the 0.9.8 release, the Windows version is to be built with MingW and MSYS, by running configure and make, Unix-like.

One caveat is that the directory containing the Qt program files (such as qmake) should be in $PATH. It may be necessary to add it manually before running configure.

Once built, the manitou.exe binary will need dynamic link libraries to run: libpq.dll, the Qt DLLs, and MingW DLL. They can live in the directory where manitou.exe resides, or in a system directory, or in the system path.

The installation layout differs from the Unix version. Under Windows, all files are expected under a dedicated application directory (such as \Program Files\Manitou-Mail). A typical layout (as used by the provided installer is: 

Manitou-Mail\
  Qt3Support4.dll
  QtAssistantClient4.dll
  QtCore4.dll
  QtGui4.dll
  QtNetwork4.dll
  QtSql4.dll
  QtXml4.dll
  Uninstall.exe
  libpq.dll
  manitou.exe
  mingwm10.dll
  help\
    en\
      manitou.adp *.html *.css
      img\
        *.png
    fr\
      manitou.adp *.html *.css
      img\
        *.png
  translations\
    *.qm
  xpm\
    *.png *.xpm
make install under Windows is not the recommended method to install, since we don't want a unix-like layout for the end user machine. After recompilation, the current way to install a new version is to manually copy the manitou.exe binary from the source directory into an already-installed application directory, as well as the support files if modified (translation, help, and icon files).

Running

When started, the UI should display a dialog box with database connection parameters to fill in. See the User Interface documentation for more.