                                BISS AWT INSTALLATION
                                =====================


This version includes the complete sources. The source package therefor comes
without precompiled class files or native libraries (the class files are
distributed separately with the package biss-awt-bin.tar.gz). You always have
to rebuild the (optional) native lib from the source package.


1. INSTALL PROCEDURE
--------------------

To build and install the class files, please perform the following steps:

  cd ~/
  tar xzvf biss-awt-src-X.XX.tar.gz
  cd biss-X.XX
  make
  make install                      ### copies package property files to ~/.java

Don't forget to add ~/biss/lib to your CLASSPATH environment variable.


This is what you have to do To build the kaffe native lib:

  cd ~/biss/src/biss/awt/kernel
  . set-env                         ### optional, skip if kaffe is already set up
  make
  su -c "make install"              ### copies libkaffe_bissawt to /usr/local/lib
  
The biss-awt native lib should be in the same directory like the other shared
libraries of kaffe (/usr/local/lib). If you changed the default kaffe configuration,
please make sure you have the LD_LIBRARY_PATH environment variable set to include
this directory.


2. PACKAGE PROPERTY FILES
-------------------------

Within the ~/.java directory there now will be five configuration files

 .java

    biss
             package properties of package biss. There should be no need
             to change the default settings (language etc.)

    biss.awt
             package properties to adjust biss.awt to a particular display
             (specify different Fonts, colors and sizes if defaults do not
             fit your environment, see ~/biss/src/biss/awt/Awt.java for
             available settings).

          !! Depending on your X server configuration, you may have to
          !! set "biss.awt.GlobalKeyMod=8" in order to enable global
          !! hotkeys (Alt+<key>)

          !! Most probably, you will have to set "SysFont", "StaticFont",
          !! "FixedFont", "ButtonFont" and "MenuFont" according to your
          !! X server, font and display configuration. Please mail your
          !! configuration and settings to  <pm@biss-net.com> in case you
          !! don't like the default values.

          !! There are two new properties you may want to try (both are
          !! set to true by default): "SoftScroll" and "FilterPaints". The
          !! first one enables vertical soft scrolling in Lists and TextAreas
          !! (via the Scrollbar buttons), the last one filters out superfluous
          !! repaints for partially obscured windows (see CHANGES for details)

    biss.awt.kernel
             package properties to set certain parameters for biss.awt.kernel
             (Java fontname to X fontname mapping, usage of grabs for
             popup / transient windows etc.). If you like the popup menus to
             behave more like fvwm, set "biss.awt.kernel.HasNativePopUps=true".
             The display name can be set via "biss.awt.kernel.Display"
             (otherwise the environment variable or a system property "display"
             is used to get this name). If you experience problems with loading
             standard fonts, you probably have to set "biss.awt.kernel.Courier"
             , "...Helvetica", "..TimesRoman", "..Dialog" or "..Symbol" to
             "-<fndry>-<fmly-" names of fonts installed on your X server.

          !! The boolean property "UseBackingStore" controls if the native layer
          !! should direct the X server to use backing store for mapped Java
          !! windows (which is the default behavior). If this is switched off,
          !! the native layer will at least try to open transient windows with
          !! the "SaveUnder" attribute.

          !! The native layer now shrinks Frame sizes by (guessed) window manager
          !! decoration extends (which can be controlled by setting the properties
          !! "TitleInset" and "BorderInset"). If you do not want this (JDK like)
          !! feature, switch it off by setting "ShrinkFrame=false".

    biss.jde
             package properties for the Java development environment. Should
             contain at least the lines:
             ...
             biss.jde.SrcRoots=~/biss/src
             biss.jde.ClassRoot=~/biss/lib
             ...
             The first line lists the directories where biss.jde is looking
             (recursively) for source files, the second one specifies where
             class files should be created by the compiler.
             See ~/biss/src/biss/jde/Jde.java for other variables that can
             be set.

    biss.calendar
             package properties for the biss.calendar example application.
             Should contain the path settings for GIF and data files:
             ...
             biss.calendar.GifPaths=~/biss/src/biss/apps/calendar
             biss.calendar.EnvPaths=~/biss/src/biss/apps/calendar
             ...
             

3. CHECK INSTALLATION
---------------------

Start the LibBrower (main window for biss.jde application) with

> java biss.jde.LibBrowser

When all classes/directories have been parsed, double click on
one of the classes i its lower List pane to launch a CUBrowser window
(Java class browser).

If some of the screen fonts do not fit your display, please modify
the package property files (~/.java/biss.awt and/or ~/.java/biss.jde)
and restart.

If you did not explicitly configure kaffe to use biss-awt, call kaffe with
"-Dawt.toolkit=biss.awt.kernel.Toolkit" to specify the toolkit to use
for java.awt

For your convenience, there is a small script 'set-env' to perform
these tasks:

> cd ~/biss/src/biss/awt/kernel
> . set-env


Now you should be able to start the LibBrowser with:

> k biss.jde.LibBrowser



