# # $Date: 1997/07/10 08:17:56 $ # $Source: /usr/local/src/Xbae/README,v $ XbaeLin Library version 4.6.2.4 ------------------------------- This is a patched version of Xbae version 4.6.2 that provides support for cell widgets, for cursor positioning, and fixes a variety of bugs in the stock version Xbae 4.6.2. At some point, these patches will be picked up in the main Xbae distribution, and re-released as version 4.7 or 5.0 or some such. In the meanwhile, the patches contained here are large and significant, and, in order to avoid version numbering confusion, the name has been altered to "xbaelin". If/when these patches get merrged back into the main tree, this version will disappear. In the meanwhile, the latest & greatest version of xbaelin can always be found at http://linas.org/linux/xacc/ -- linas -- Linas Vepstas -- 10 April 1998 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
