
  INSTALL
  gPS - Graphical Process Statistics
  version 1.0.1

  Be sure to have read the README file before coming into this file.
  IMPORTANT: FreeBSD users must use GNU make instead of the system's
  native make.

  INSTALLING

   1. FROM A RPM PACKAGE

    If you got a nifty .rpm package and have a rpm-enabled system, you
    may type

      rpm -i gps-0.x.y-blahblah-nonono.rpm

    to install gPS in your system. See the rpm man page for more info.


   2. FROM TAR.GZ SOURCES

     2.1 COMPILE
        
        cd to the gps-0.x.y directory and type

        ./configure
        make

     Notice: These commands will compile gPS with prefix /usr/local.
       On the installation step gPS files will be installed in
       /usr/local/bin, /usr/local/man, /usr/local/doc and so on.
       If you wish to change it, run
  
         ./configure --prefix=/usr
         make

       for example (instead of /usr put the prefix you would like)
     

     2.2 INSTALL

        After compiling you'll see a help message onscreen telling
        which install options are available. These are:

        COMMAND                       WHAT IT DOES

        make install               -  installs everything that was
                                      successfully compiled and all
                                      documentation. It is safe to
                                      use this target if you don't
                                      know what the other targets do.

        make install_gps           -  installs gPS main program
                                      and its documentation

        make install_net_all       -  installs all rgpsp programs
                                      that compiled. These are
                                      needed to watch networked
                                      computers. It also installs
                                      the rgpsp man page.

        make install_net_best      -  installs the rgpsp program
                                      that best fits your system and
                                      the rgpsp man page.

        make ginstall              -  runs a graphical installer. You
                                      must have Tcl/Tk installed to
                                      be able to run it. This is
                                      adviseable for novices.

        You must be superuser (root) to run any installation or
        uninstallation target. If you are logged as a normal user
        and uses the "su" command to run the installation,
        remember to do a "xhost +" as normal user if you are
        willing to run the graphic installer as root.

        You may wish to add gPS to an application laucher like
        WindowMaker's Dock/Clip or AfterStep's Wharf. To do so,
        consult your environment's documentation. A suggested icon
        is installed as /usr/local/share/icons/xray-tux.xpm

        (if you chose other prefix than /usr/local, it'll be
        on prefix/share/icons)

     2.3 UNINSTALLING

        The install step places the following files in your system:
        (the /usr/local prefix may be changed as discussed above)

          /usr/local/bin/gps
     (*)  /usr/local/bin/rgpsp
     (*)  /usr/local/bin/rgpsp_linux
          /usr/local/doc/gps-x.y.z/README
          /usr/local/doc/gps-x.y.z/README.NetWatch
          /usr/local/doc/gps-x.y.z/INSTALL
          /usr/local/doc/gps-x.y.z/CHANGELOG
          /usr/local/doc/gps-x.y.z/TODO
          /usr/local/doc/gps-x.y.z/COPYING
          /usr/local/man/man1/gps.1x
          /usr/local/man/man1/rgpsp.1
          /usr/local/share/icons/xray-tux.xpm

        (where gps-x.y.z is gps- followed by the version number, and
        the files marked with an asterisk (*) may not have been installed,
        depending on your system configuration)

        So, if you ever want to uninstall gPS, just remove these files.
        You may type

          make uninstall

        from the gps-x.y.z directory (created from a .tar.gz file) to
        remove those files, but it will work only if the installed
        version was installed with the same prefix given in the
        ./configure step.


   3 RANDOM NOTICES

              If you have a previous version of gPS installed, it is
              safer to do a

                make uninstall

              before the "make install" step. If the previous
              version was installed from a RPM package, uninstall
              it with "rpm -e".

---
bergo@seul.org

