                                   X-USER
                              Quick Installation
                                   Hints


    X_USER USES THE SHADOW-PASSWORD SYSTEM.
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    Don't use it if you don't have shadow-passwording active on your system.

    
    INSTALLATION:
    ~~~~~~~~~~~~~
    In order to install the xuser program, do as follows:

    1.  Be(come) root

    2.  Go to the xuser-directory, created by unpacking xuser-X.YY.tar.gz

    3.  install -m 700 xuser /sbin

    4.  install -m 644 usr/X11/lib/X11/app-defaults/XUser
                                                /usr/X11/lib/X11/app-defaults

    5.  read the /usr/X11/lib/X11/app-defaults/XUser application file,
        optionally modify the defaults provided in the distribution

    6.  Read the CHANGELOG file AND MAKE SURE YOU UNDERSTAND WHAT'S WRITTEN
        THERE !!

    7.  rehash

    8.  start xuser as follows:
                xuser -options                  -- to see the active options
                xuser <some username>           -- to start up with the 
                                                   information about the
                                                   mentioned user
                xuser -options <username>       -- options and a username

------------------------------------------------------------------------------

    If you want to compile xuser yourself, you need the xforms package,
    libshadow.a, shadow.h and (preferably) icmake, version 6.11 or later.

    X_USER USES THE SHADOW-PASSWORD SYSTEM.
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    Don't compile xuser if you don't have shadow-passwording active on your
    system.

    X_USER USES THE XFORMS GUI-SYSTEM.
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    The library and header file which were used for compiling xuser are found
    in the archive ftp://ftp.icce.rug.nl/pub/unix/xforms-extra-bin.tar.gz
    Retrieve and unpack this archive if you don't want to install the xforms
    software from its official distribution. See the xuser.txt.gz or
    xuser.ps.gz for information about where to find the most recent version of
    xforms.

    THE X_USER 'BUILD' SCRIPT ASSUMES THAT ICMAKE IS AVAILABLE.
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    Icmake's binaries are found in the archive
    ftp://ftp.icce.rug.nl/pub/unix/xforms-extra-bin.tar.gz Retrieve and unpack
    this archive if you don't want to install icmake from scratch, by
    retrieving icmake from ftp://ftp.icce.rug.nl/pub/unix.


    * Prerequisites:
    ~~~~~~~~~~~~~~~~
        -> shadow-passowrding must be in use on your system.

        -> make sure libforms.a is in /usr/lib,
                     forms.h    is in /usr/include

        -> make sure icmake is available in /usr/local/bin
           (or do all the compilations 'by hand').
        
    * In order to compile xuser, do as follows:
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

        1.  Go to the xuser-directory, created by unpacking xuser-X.YY.tar.gz

        2.  Give the command (don't forget to 'rehash' if you installed
            icmake):

                build

        3.  When the compilation is completed, the program 'xuser' is
            available in the directory where the build-script was found.

        4   Install xuser by following the installation instructions provided
            at the top of this file.

-------------------------------------------------------------------------------

    Questions, remarks, wishes ?    e-mail to:

        frank@suffix.icce.rug.nl

    I hope you enjoy xuser.
    Cheers,

        Frank.

