File	Date	Author	Commit
build	2016-02-04	Mark Millard	[56111b] Initial commit.
cfg	2016-02-04	Mark Millard	[56111b] Initial commit.
data	2016-02-04	Mark Millard	[56111b] Initial commit.
docs	2016-02-04	Mark Millard	[56111b] Initial commit.
html	2016-02-04	Mark Millard	[56111b] Initial commit.
man	2016-02-04	Mark Millard	[56111b] Initial commit.
src	2016-02-04	Mark Millard	[56111b] Initial commit.
test-code	2016-02-04	Mark Millard	[56111b] Initial commit.
.hg_archival.txt	2016-02-04	Mark Millard	[56111b] Initial commit.
.hgsub	2016-02-04	Mark Millard	[56111b] Initial commit.
.hgsubstate	2016-02-04	Mark Millard	[56111b] Initial commit.
.hgtags	2016-02-04	Mark Millard	[56111b] Initial commit.
AUTHORS	2016-02-04	Mark Millard	[56111b] Initial commit.
BUGS.txt	2016-02-04	Mark Millard	[56111b] Initial commit.
COPYING	2016-02-04	Mark Millard	[56111b] Initial commit.
ChangeLog	2016-02-04	Mark Millard	[56111b] Initial commit.
HACKING	2016-02-04	Mark Millard	[56111b] Initial commit.
INSTALL	2016-02-04	Mark Millard	[56111b] Initial commit.
LICENSE.GPL	2016-02-04	Mark Millard	[56111b] Initial commit.
Makefile.am	2016-02-04	Mark Millard	[56111b] Initial commit.
Makefile.in	2016-02-04	Mark Millard	[56111b] Initial commit.
NEWS	2016-02-04	Mark Millard	[56111b] Initial commit.
README	2016-02-04	Mark Millard	[56111b] Initial commit.
SoXt.pc.in	2016-02-04	Mark Millard	[56111b] Initial commit.
TODO	2016-02-04	Mark Millard	[56111b] Initial commit.
aclocal.m4	2016-02-04	Mark Millard	[56111b] Initial commit.
configure	2016-02-04	Mark Millard	[56111b] Initial commit.
configure.ac	2016-02-04	Mark Millard	[56111b] Initial commit.
stamp-h.in	2016-02-04	Mark Millard	[56111b] Initial commit.
tags	2016-02-04	Mark Millard	[56111b] Initial commit.

Read Me

README
======

SoXt is an alternative to SGIs InventorXt library, which is a GUI binding
for using Open Inventor with Xt/Motif.  While SoXt has been developed for
use with Coin, it is also possible to compile it against Open Inventor
from SGI or TGS.  A goal is to eventually become 100% source code
compatible with the InventorXt library, which is still way off, especially
when it comes to creating derived classes.  


INSTALLATION
============

Installing SoXt is a matter of running the configure script with the right
options, getting it to pass all its tests, and run "make install" afterwards.
These two phases has each a set of common problems which will be gathered
and described below.


The Configure Phase (running SoXt/configure)
--------------------------------------------

The file INSTALL contains generic information about running the configure
script.  It's a good idea to have read that file one time or another, but
it's the same file as in every other autoconf-based project and this one
contains no extra information.  Anyways, here are some common problems:

* configure immediately tells you it can't find the source files

  My guess is that you are trying to run configure from a separate build
  directory, and you have started SoXt/configure with a relative pathname
  that traverses some symbolic link.  Configure doesn't handle that, so
  you can either cd into your build directory using the hard path, or you
  can use the absolute pathname for SoXt/configure

* configure doesn't find Coin (or coin-config)

  To detect Coin, configure looks for the script called coin-config, which
  is installed in bin/ where you installed Coin.  You do probably not have
  that bin-directory in your PATH variable, so configure won't find where
  it is.  The solution is to either add {Coin-prefix}/bin to $PATH, or you
  can run SoXt/configure with the "--with-coin={Coin-prefix}" option.