================================================= iWear Core Library - Short Installation Guide ================================================= 1. Quick Shot Simply do a ./configure --prefix= make then do these (if you want to) make trans # To make use of the iWear translations for the core library make install # To install the files make link # To just link the files, where they otherwise would be # installed (very useful if you plan to develop) Thats it. 2. Longer Version If you have problems with this guide, please refer to the website (http://www.projectiwear.org) for more information. 2.1 Requirements The iWear Core library configuration and build needs the following tools, at least in the specified version, of course newest version is recommended. Tool/Library Version Comment bash 3.0 lower version often work too sed 4.1.x Must support -i option mktemp 1.5 Must support -d option GNU Make 3.78 Must have the eval patch applied pkg-config 0.19 Tool is recommended but not needed boost 1.31.0 If your distro has seperated the boost filesystem library, you need to install that too. OpenSSL 0.9.7a Newer version recommended (security problems) doxygen 1.4.2 Only when you plan to generate API docs 2.2 Needed directories If you plan to use the link feature of the library, you also need certain directories. For various reasons they are not created when doing the make link. The directories are $PREFIX/etc $PREFIX/bin $PREFIX/lib $PREFIX/share $PREFIX/include and possibly other subdirectories, depending on what other iWear libraries you use. 2.3 Configuration At the simplest, just do a ./configure. You can ask for the actual supported parameters with --help. Usually you only need the --prefix parameter if you plan to install/link into some other directory than /usr. If you dont want /etc to be compiled in as the system config directory, you also need to specify the --sysconfdir. So a common configuration could look like: ./configure --prefix=$HOME --sysconfdir=$HOME/etc We have a configure parameter cache (in the file config.cache) so you wont need to type this in when you reconfigure. After doing that a make clean is recommended. 2.4 Building the stuff Well a simple make should do it. If you also want the translations to be build, you need to do a make trans to create the .mo files. 2.5 Using the library There are two options. Either you just want to install the library, or you want to develop on it an just use it in-place. 2.5.1 Installing Doing a make install will install the library and translations as well as the needed headers into the directory specified with $PREFIX. When now linking to the libraries, make sure that they are in the linkers search path. 2.5.2 Sym-Linking This is a good option if you plan to develop in-place, or also when you dont have enough space in your home directory (e.g. university quota restricted environment). Do a make link so all the files that would otherwise get installed will now be linked. But make sure that you didnt made a install before, otherwise the links might fail or go to a wrong place. When you did that, you can just rebuild the library, and it will be automatically available for linking. 3 Troubleshooting If you have problems installing, please search our website. If you dont find the information there, go to the forum or mailing list. Since the library is relatively new, there might still be some issues with the installation system.