Here is a short guide on how to build and install xsession.

CONFIGURATION

  First, take a quick look at the file XSession.ad.  The lines belonging to
  the groups "Window managers menu items" and "Applications menu items"
  should be customized for your site.

  You will probably have to remove some window managers from the "wmNames"
  list (those that are not installed on your system).  If you don't
  understand the resources structure, you can read the manual page for more
  information.  You can read the manual page on-line before installing it
  with the following command: nroff -man xsession.man | col | more

  This step is not absolutely necessary, but if you leave all window
  managers in the menu, the users will get errors when they try to run a
  window manager that is not available.


COMPILING AND INSTALLING XSESSION

  If you have `imake' and `xmkmf', you only need to customize the Imakefile
  for your site (see comments inside), then type
          xmkmf -a
          make
  to compile xsession, and type
          make install
          make install.man
  to install xsession, its application-defaults and its manual page.
  Note: some versions of "xmkmf" do not understand the "-a" option.  You
  can safely ignore it if you type "make depend" after "xmkmf".

  If you don't have `imake' or `xmkmf', then you will need to customize a
  Makefile for your site.  The one provided, which is named Makefile.noimake,
  is documented and is as simple as possible.  You first have to change its
  name to Makefile, customize it, then type
	make
  to compile xsession, and type
	make install
	make install.man
  to install xsession, its application-defaults and its manual page.


TESTING XSESSION

  If you cannot install the application-defaults file in the right place
  (i.e. the /usr/lib/X11/app-defaults directory) and you want to test
  xsession, you can use one of the following alternatives to make these
  defaults known to X Window (and so, to xsession):

  o Write a small shell script which sets the environment variable
    XENVIRONMENT to [...]/XSession.ad (where [...] is the right access path
    to the file) and then executes xsession itself.  Use this shell script
    to actually start xsession.  You can do it by hand, too.

  o If you have your own application-defaults directory, for example,
    ~/app-defaults, copy the XSession.ad file to this directory, with the
    name XSession, and write a small shell script which sets the
    environment variable XAPPLRESDIR to ~/app-defaults and then executes
    xsession itself.  Use this shell script to actually start xsession.
    You can do it by hand, too.

  o Add the following line to your .xinitrc or .xsession script
	xrdb -merge [...]/XSession.ad
    where [...] is the right access path to the file.


BUG REPORTS

  Please send any problems/questions/bug-reports/enhancements to the
  authors:

          Raphael Quinet <quinet@montefiore.ulg.ac.be>
                         <quinet@server.montefiore.ulg.ac.be>

          Alain Nissen   <nissen@montefiore.ulg.ac.be>
                         <nissen@server.montefiore.ulg.ac.be>


COPYRIGHT

  Copyright (C) 1993, 1994, Alain Nissen & Raphael Quinet, University of Liege,
                                                                       Belgium.

  XSession is free software; you can redistribute it and/or modify it under the
  terms of the GNU General Public License as published by the Free Software
  Foundation; either version 2, or (at your option) any later version.

  XSession is distributed in the hope that it will be useful, but WITHOUT ANY
  WARRANTY, either from the authors or from the University of Liege; without
  even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  PURPOSE.  See the GNU General Public License for more details.

  You should have received a copy of the GNU General Public License along with
  xsession; see the file COPYING.  If not, write to the Free Software
  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
