# 
# $Date: 1997/07/10 08:17:56 $
# $Source: /usr/local/src/Xbae/README,v $

Xbae Library version 4.6.2
--------------------------

See the INSTALL file for installation procedure.

Comments, questions, bugs & postcards can be directed to Andrew Lister
(lister@syd.net.au).

Postcards will earn you a spot in the manual page and can be sent to

	Andrew Lister
	6/17 Selwyn Street
	Wollstonecraft
	Sydney NSW 2065
	Australia

Please email me first - to make sure I'm still there!

For those of you not already on the mailing list and would like to subscribe,
send mail to

        xbae-request@emjay.apana.org.au

with "subscribe" in the Subject: field.

Also, take a look at the web page:

	http://www.xbae.syd.net.au


Documentation
-------------

Documentation is provided in the doc/ subdirectory.  Please read the
Xbae-FAQ before contacting the maintainer or mailing list unless you
are willing to receive some nasty replies!  I will be ignoring any
questions that are in the FAQ so if you don't receive a reply within
a few days, you'll know where to look.

The online manual pages (src/XbaeMatrix.man & src/XbaeCaption.man) are
also provided in PostScript format in doc/matrix.ps and doc/caption.ps
which I urge you to print out and keep handy as most questions can be
answered from these.

The online XbaeMatrix(3) man page suffers from a very large table,
spread over a few pages which causes problems with most versions of
nroff, groff, etc.  If this is the case for you, you will need to use
the PostScript version for the resource table.  If you can help out in
formatting the table so it works in the online manual page, please
contact me.


What the widgets do:
--------------------

XbaeMatrix:

XbaeMatrix is a Motif widget which presents an editable array of
string data to the user in a scrollable table similar to a
spreadsheet. The rows and columns of the Matrix may optionally be
labeled. Also, a number of "fixed" and "trailing fixed" rows or
columns may be specified - these behave similarly to the labels. While
XbaeMatrix looks and acts like a grid oF XmTextField widgets, it
actually contains only one XmTextField.  This means that XbaeMatrix
widgets with hundreds or thousands of rows have much less overhead
than they would if they used an XmTextField for each cell. XbaeMatrix
has callbacks for doing field validation and customizing traversal. It
allows cells to be assigned independent colors.  It allows rows,
columns and regions of cells to be selected or highlighted.  The
matrix can be dynamically grown or shrunk by adding and deleting rows
and columns at any position.  The widget has many resources to allow
individual customisation and can be made to look and behave like an
extended list widget with added functionality.  Pixmaps (both colour
xpm and standard bitmaps) can be displayed in individual cells with
the callbacks available in the widget.
   

XbaeCaption:

XbaeCaption is a simple Motif manager widget used to associate an
XmLabel (caption) with it's single child. The label may be either an
XmString or Pixmap and can be displayed in any one of twelve positions
around the perimeter of the child. XbaeCaption's geometry management
technique is to simply "shrink wrap" it's child and display the
caption alongside it.  By using XbaeCaption with an XmFrame child,
groups of related widgets can be labeled similarly to the IBM CUA
"Group Box", but with more flexibility.  XbaeCaption is also useful
for associating labels with individual XmTextField widgets.


Changes in 4.6.2
----------------

* Heinz Nagel (heinznagel@lucent.com) discovered an uninitialised
  variable in Methods.c

* Tim Bomgardner (Tim.Bomgardner@mci.com) found a clipping problem
  when a horizontal scrollbar and row labels are present.  The
  row labels were being drawn to the left of the horizontal SB.

* Whilst fixing Tim's problem, I also found several other small
  scrolling problems that were rectified