GNUMail.app User's Guide

by Martin Brecher <martin@mb-itconsulting.com>


Contents

Setting up Pantomime
Installation of Pantomime
Download
Build
Installation

Developers only: Installing Pantomime Testing Tools


Setting up Pantomime [top of page]

Installation of Pantomime

First we have to download and install Pantomime which is required by GNUMail.app since version 0.7.0pre2

Download [top of page]

Homepage: http://www.collaboration-world.com/pantomime/
Download: Pantomime-0.9.0.tar.gz
Version: 0.9.0

Build [top of page]

tar xvfz Pantomime-0.9.0.tar.gz
cd Pantomime
make

That will compile the Pantomime sources.

Installation [top of page]

You can simply install Pantomime now by doing a
make install
That will install the library files to GNUstep's Local/Libraries folder (e.g. /opt/GNUstep/Local/Libraries - depending on where you have installed GNUstep) and the Header files to GNUstep's Local/Headers folder (e.g. /opt/GNUstep/Local/Headers/Pantomime/). This is actually the preferred way.

For the last step you have to be root. Alternatively you can install Pantomime into the following places:

make install GNUSTEP_INSTALLATION_DIR=${GNUSTEP_SYSTEM_ROOT}
This will install the library files to the System/Libraries directory and the header files to the System/Headers directory where only preinstalled stuff should be in place. Usually you have to be root to write to those directories.
make install GNUSTEP_INSTALLATION_DIR=${GNUSTEP_NETWORK_ROOT}
This will install the library and header files to the Network/Libraries and Network/Headers directories where only files which are shared with the local network should be in place. You have to be root to write to those directories, too.
make install GNUSTEP_INSTALLATION_DIR=${GNUSTEP_USER_ROOT}
This will install Pantomime to your personal GNUstep/Libraries and GNUstep/Headers directory which is located within your home directory (e.g. /home/username/GNUstep/Libraries). Use this if:
  • you are the only one to use Pantomime
  • you don't have permissions to write to the system wide GNUstep folders (Local, Network and System).
NOTE: You should check the other locations for already installed versions of Pantomime to prevent a duplicate installation and versioning conflicts!



Developers only: Installing Pantomime Testing Tools [top of page]

Pantomime has a small commandline application for testing purposes which you can simply compile and install:

cd Pantomime/Testing
make
make install

Perform a simple openapp Pantomime.app to learn how to use this tool.

Additionally you might want to copy the documenation (README, LICENSE, TODO files and the rfcs folder) which is included in the Pantomime distribution to the GNUstep/Local/Documentation/Developer/Pantomime directory.