How to safely build GARNOME-2.10.x

["Joseph E. Sacco, PhD" <joseph_sacco comcast net>]

GARNOME is to be built and installed in a manner that does not corrupt
your existing installed software.

These instructions describe how to build and install GARNOME within a
separate directory tree structure, isolated from all other software
installed on the system.

PREPARATION
===========
As root:
* Create a new user account to build and administer the GARNOME software
For example:

	user  = garnome
	group = garnome

* create a work directory

For example,

	/usr/local/garnome-2.10.x

where x = the current version of the software 

* modify the ownership and permissions of this directory
	
	chown garnome.garnome /usr/local/garnome-2.10.x
	chmod 755 /usr/local/garnome-2.10.x


BUILD - INSTALL
===============
As garnome:

* cd  /usr/local/garome-2.10.x

* unpack the garball in this directory

	bunzip2 -dc garnome-2.10.x.tar.bz2 | tar xvf -

* cd garnome-2.10.x

* Read the README

* Read it again, carefully [:-)]

* modify the main_prefix in gar.conf.mk

	main_prefix ?= /usr/local/garnome-2.10.x

All GARNOME applications will be installed under 

	/usr/local/garnome-2.10.x

* Build the software
following the instructions in the README.


POST-INSTALL
============
As root:
* create an executable shell script

	/usr/local/bin/garome-session

to set up environment variables and run the GARNOME version of
gnome-session:

        #!/bin/sh
                                                                                     GARNOME=/usr/local/garnome-2.10.x
        GNOME2_PATH=$GARNOME
        PATH=$GARNOME/bin:$PATH
        LD_LIBRARY_PATH=$GARNOME/lib:$LD_LIBRARY_PATH
        PYTHONPATH=$GARNOME/lib/python2.3/site-packages:$GARNOME/lib/python2.3/site-packages/gtk-2.0
        PKG_CONFIG_PATH=$GARNOME/lib/pkgconfig:/usr/lib/pkgconfig
        XDG_DATA_DIRS=$GARNOME/share:/usr/share
        XDG_CONFIG_DIRS=$GARNOME/etc/xdg
        GDK_USE_XFT=1
        export GNOME2_PATH PATH LD_LIBRARY_PATH PYTHONPATH
        PKG_CONFIG_PATH GDK_USE_XFT XDG_DATA_DIRS XDG_CONFIG_DIRS
        exec $GARNOME/bin/gnome-session

If you are running PYTHON-2.4, edit the PYTHON-specific lines, replacing
	2.3 -> 2.4

* chmod +x /usr/local/bin/garnome-session



RUNNING GARNOME
===============

As a user with:

* command line log in 
  [log in / manually run startx]

- In your home directory, create a file named .xinitrc

        #!/bin/sh
                                                                                        
        PATH=/usr/local/garnome-2.10.x/bin:$PATH
                                                                                        
        /usr/local/bin/garnome-session

If you wish to start up a dbus session when GARNOME is launched,
change the last line to

	dbus-launch --sh-syntax --exit-with-session /usr/local/bin/garnome-session


You are now ready to run GARNOME
- log out completely
- log in
- startx


* XDM log in
[GUI based]

- In your home directory, create a file named .xsession with the same
contents as .xinitrc described above.


You are now ready to run GARNOME
- log out
- log in


-Joseph
        
-- 
jsacco [at] ydl [dot] net