GNUstep Installation 2008-07-13 The packages in this directory were created using SuSe-Linux 10.3. You can install them safely on SuSe Linux >= 10.3, and probably on other Linux distributions using RPM packages like Red Hat. All packages will be installed in /usr/GNUstep. 1. System requirements 2. Essential packages from the distribution 3. GNUstep installation 4. GNUstep configuration 5. GNUstep configuration for each user 6. Window Manager 7. Quick entry to GNUstep 8. Trouble Shooting 1. System Requirements ======================================================================= These GNUstep RPM packages from vhf have been compiled with SuSe 10.3, and not tested with other distributions. It is very likely that the packages will run with other Linux distributions based on RPM packages, as well as with future releases of SuSe-Linux. GNUstep should run with any window manager. We have used WindowMaker, so far. Especially KDE and Gnome are often used together with GNUstep. 2. Additional packages from the distribution ======================================================================= The following packages must be installed from the distribution CD (most of them are installed anyway). - libxml2 Package: libxml2 - libxslt Package: libxslt - openssl Package: openssl, libopenssl - tiff Package: libtiff jpeg Package: libjpeg png Package: libpng gif Package: giflib - aspell Package: aspell - cups Package: cups - audiofile Package: audiofile portaudio Package: portaudio - libobjc Package: libobjc - libavcall libcallback Package: ffcall - libart_lgpl Package: libart_lgpl - freetype2 Package: freetype2 You may need to install other libraries, which usually are all available on any distribution. So, if the installation of the RPM packages request some other libraries, you can install them from your distribution. 3. GNUstep Installation (as user root) ======================================================================= mount /cdrom cd /media/cdrom/Cenon/Linux/i586/GNUstep If you do an update to a newer version of packages, make sure to uninstall the gnustep-RPMs before installing the new version. You can do this in yast. The following GNUstep packages need to be installed as user root in the given order (you can copy the lines into your terminal shell). These 5 packages are the GNUstep base and are the important ones. rpm -Uhv gnustep-make*.rpm rpm -Uhv gnustep-base*.rpm rpm -Uhv gnustep-gui*.rpm rpm -Uhv gnustep-back*.rpm # Art backend for GNUstep rpm -Uhv gnustep-fonts*.rpm # some basic fonts for the Art backend In the folder Apps you find some applications for GNUstep. You don't need them to run Cenon, but they fit in the user experience. rpm -Uhv GWorkspace.app-x.x.x-x.i586.rpm # File-Manager (important!) rpm -Uhv Preferences.app-x.x.x-x.i586.rpm # Preferences for GNUstep rpm -Uhv SystemPreferences.app-x.x.x-x.i586.rpm # Preferences for GNUstep rpm -Uhv GNUMail.app-x.x.x-x.i586.rpm # very good mail client rpm -Uhv Ink.app-x.x.x-x.i586.rpm # RTF-Editor rpm -Uhv Terminal.app-x.x.x-x.i586.rpm # Terminal program Tip: If the installation brings up an error message, then usually a library is not installed on your system. You can simply install the library from your distribution. The following commands are of general help in using RPMs: rpm -qpR PACKAGENAME.rpm # list package dependencies rpm -qpi PACKAGENAME.rpm # list package information rpm -qpl PACKAGENAME.rpm # list package contents rpm -e PACKAGENAME # uninstall package 4. GNUstep Configuration (as user root) ======================================================================= The following lines need to be added to a boot script. For the most linux distributions this is /etc/init.d/boot.local # start GNUstep services if [ -f /usr/GNUstep/System/Library/Makefiles/GNUstep.sh ]; then source /usr/GNUstep/System/Library/Makefiles/GNUstep.sh opentool gdomap opentool gnustep_sndd # if available fi 5. GNUstep Configuration for all Users (login as user) ======================================================================= For these configurations you have to be logged in as the user. Copy the following lines into the .xinitrc file before the window manager is started (here wmaker). The file .xinitrc is located in your home directory. If the file is missing create one. # set GNUstep environment, start pasteboard server . /usr/GNUstep/System/Library/Makefiles/GNUstep.sh gdnc # GNUstep notification center gpbs # GNUstep pasteboard server # start Window Maker wmaker You can set the time zone, system font and modifier keys with the Preferences.app or SystemPreferences.app. 6. Window Managers ======================================================================= - WindowMaker Keyboard commands To have the keyboard commands for Alt-1, Alt-2, ... available in GNUstep, you should disable them in WindowMaker. To do this goto the preferences of WindowMaker. 7. Quick entry to GNUstep ======================================================================= GNUstep applications are located in the following paths: /usr/GNUstep/Local/Applications /usr/GNUstep/System/Applications The following are examples of applications available for GNUstep. Documentation to these programs can be found on their home pages: GWorkspace.app The File Manager. Internet: http://www.gnustep.it/enrico/gworkspace/ GNUMail.app The Mail Client Internet: http://www.collaboration-world.com/gnumail/ Preferences.app Preferences for GNUstep. After the first start, you may have to set all the switches of the first module. After a restart the modules for keymapping appear. Here you can set the modifier keys, time zone, system font, etc. Ink.app Text editor und Rich Text editor (RTF editor) You can start applications from GWorkspace. You can also start programs from a terminal shell (to have this work you need to source the GNUstep.sh script as described before!): openapp GWorkspace.app 8. Trouble Shooting ======================================================================= RPM doesn't install the package. Instead I get messages of missing library dependencies. Cause: Some libraries, which are needed are not installed Solution: Install the missing libraries from your distribution. You can use the search function to find the related package. The libraries are installed. Still the dependencies are not sattified. Cause: The library is only provided in a different version. Solution: You can try to install by ignoring the dependencies using the parameter --nodeps It may also help to create a link to an existing library version. I get a message that 'openapp' can't be found. Cause: You haven't issued the GNUstep.sh script Solution: You have to add the call of the script into your .xinitrc file for every user (see above). The Gnustep paths (echo $PATH) are set to linux-gnuolsld instead of linux-gnu. Rien ne va plus. Cause: The tool ld isn't installed Solution: Install the package binutils from the distribution