1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154
|
$Id: INSTALL.Geomview,v 1.17 2007/04/24 11:11:17 rotdrop Exp $
Instructions for using Geomview's `configure' script
Geomview uses the GNU autoconf configuration system. The way to
configure and compile Geomview is the same as with any piece of
GNU-style software:
./configure
make
make install
Once `make' completes you can run Geomview without doing `make install'
by running the script `geomview' in the top-level directory. In
order for this to work you'll need to be in that directory.
The `reconf' script in the top-level directory will regenerate the
`configure' script, using autoreconf, part of the autoconf system.
This is useful if no useful `configure' script is already present,
which is normal only for copies of Geomview that have been taken
directly from developer CVS. See the `README.cvs' textfile for hints
on building Geomview from developer CVS.
The default installation prefix for Geomview is no longer
`/usr/local/Geomview/', but just `/usr/local/'. The directory layout
below the prefix follows the conventions of any other GNU package:
binaries below `PREFIX/bin/', data below `PREFIX/share/geomview/',
executable code below `PREFIX/libexec/geomview/' (here live the
modules). The documentation is installed below
`PREFIX/share/doc/geomview-VERSION/'. See the file `INSTALL' for
generic installation instructions.
Geomview requires Motif and benefits from OpenGL; you need to make
sure Motif is installed on your system before you can compile (or run)
Geomview. Both of these are commercial software packages but Geomview
will also work with their free counterparts Lesstif or OpenMotif
(www.lesstif.org or www.openmotif.org) and Mesa (www.mesa3d.org) [But
Linux users see the comments in the 'Linux' section below about
Lesstif/OpenMotif.] If either of these is installed on your system in
a directory that your compiler doesn't look in by default, you can use
the following options to Geomview's configure script to tell Geomview
where to find them:
--with-opengl=DIR
You can use this option if the OpenGL header files and
libraries on your system are installed in some place that
your compiler doesn't recognize by default. This option
specifies that OpenGL (or Mesa) is installed on your
system in the directory DIR. DIR should have a
subdirectory called `include' which has the GL header
files, and a subdirectory called `lib' which has the
library files in it. You don't need this option if your
compiler can find the OpenGL header files and libraries in
the standard places that it looks. If you're not sure
about this option, try configuring without it.
'configure' will abort with an error if your compiler
can't find the appropriate header files and libraries.
You can use `--without-opengl' or `--with-opengl=no' to
disable the use of OpenGL.
--with-motif=DIR
You can use this option if the Motif header files and
libraries on your system are installed in some place that
your compiler doesn't recognize by default. This option
specifies that Motif is installed on your system in the
directory DIR. DIR should have a subdirectory called
`include' which has the Motif header files, and a
subdirectory called `lib' which has the library files in
it. You don't need this option if your compiler can find
the Motif header files and libraries in the standard
places that it looks. If you're not sure about this
option, try configuring without it. 'configure' will
abort with an error if your compiler can't find the
appropriate header files and libraries.
You can use evironment variables to override various default settings
in 'configure' (such as which compiler to use and which options to
pass to it). There are many such variables that are generic to all
GNU autoconf 'configure' scripts; see the file INSTALL for details on
this. In addition to these generic settings, the following
variables are specific to Geomview:
MOTIFLIBS
'-l' options to pass to the linker for linking with the
Motif libaraies. Defaults to "-lXm", but some versions of
Motif apparently need additional libararies, such as
'-lXp'. To specify this, do
MOTIFLIBS='-lXm -lXp' ./configure
Note that MOTIFLIBS should NOT include any -L options to
specify the location of the libraries; use the
--with-motif configure argument for that. The MOTIFLIBS
variable is just for specifying the list of libraries
themselves.
========================================================================
PLATFORM SPECIFIC NOTES:
LinuxPPC
--------
On at least one LinuxPPC system with MetroX it was necessary to
specify -lXp when linking with the Motif libraries
("MOTIFLIBS='-lXm -lXp' ./configure").
Solaris
-------
On the Solaris 2.6 system that I tested, the 'example' external module
in 'src/bin/example' failed to link because of an error of the form
ld: warning: relocation error: R_SPARC_32: file main.o: symbol .LLC1:
external symbolic relocation against non-allocatable section .stab;
cannot be processed at runtime: relocation ignored
Undefined first referenced
symbol in file
.LLC1 main.o
This was when using GNU gcc to compile and Sun's ld to link, and I
believe this error may be due to an incompatibility between these two
programs, or at least the versions that were on this system. If
this happens to you, you can build with "make -k" to force "make" to
continue building the rest of the distribution in spite of this error.
The only thing you'll be missing is this one external module, which
isn't necessary for Geomview itself. If you find a way to fix this
problem, let me [mbp@geomtech.com] know.
IRIX
----
Older IRIX systems may require compiling with -XSVR4. This flag
had disappeared by IRIX 5.3, so you're unlikely to run into this.
On the IRIX 6.3 system that I tested (using CC=cc), the linker crashed
when trying to link several of the external modules. I suspect it may
be due to a broken compiler installation on that particular machine,
but I'm not sure. I'll try to get access to a more recent IRIX
installation soon and will check it out more. In the meantime, if you
compile Geomview on IRIX and run into any problems, please let me
[mbp@geomtech.com] know.
Cygwin and various older Unix-like system
-----------------------------------------
Nowadays Xorg installs itself using the usual directory layout below a
PREFIX path, just like many other GNU packages. Former version
installed themselves below PFX/X11R<VERSION> (e.g. /usr/X11R6). In
this case, the following switches are needed:
./configure --with-motif=/usr/X11R6 --with-opengl=/usr/X11R6 OTHERSWICHES
|