libhelp sources are written in ansi-c. you will need a working ansi-c compiler (e. g. gcc) to compile libhelp. libhelp requires x11 and osf/motif(tm). we use x11r5 and motif-1.2. we don't know, if it compiles with x11r4 and motif-1.1, but there will be a great chance that it will.
in order to compile libhelp you will need a working imake. the
global Imakefile defines the variable LIBDIRS
to
'libhelp libButtFace libhtmlw'
. if you don't have the xpm
library (version 3.4) you will need to add libXpm
to
LIBDIRS
to use the xpm library that is shipped with
libhelp.
to build libhelp type:
xmkmf make Makefiles make
in the compilation step.make CC=<compiler>
you can add additional include dirs in INCS
,
optimisation flags in COPT
, additional libraries for
your host in LIBS
and other makefile definitions in
DEFS
. For example
make CC=cc LIBS='-lbsd -lregexp' INCS='-I/usr/bsdinclude' \ COPT='-g' DEFS='-DDEBUG -Wall'
HELP_PATH
. per default, it is set to
"/usr/local/help:../help:help:../images:images:."
but you can compile in your local help directories, for example
make DEFS='-DHELP_PATH=\"/usr/help:/usr/images\"'
if you want `/usr/help'
and
`/usr/images'
be searched for help
files. at runtime, you can add entries to the help path with the
environment variable LIBHELPPATH
.
supposed there are no compilation errors this results in the
library files libhelp/libhelp.a, libButtFace/libButtFace.a and if
choosen libXpm/libXpm.a (i forgot to say that normally there is a
standalone help browser xmhelp
as well).
libhelp/libhelp.a libButtFace/libButtFace.a libhtmlw/libhtmlw.a
and if compiled
libXpm/libXpm.a
to a directory of your LIBPATH.
copy libhelp/help.h
(and if you want to use the
other libraries, libButtface/pushbuttons.h
libhtmlw/HTML.h
and (if compiled)
libXpm/xpm.h
) to a directory where you find include
files.
If you have compiled xmhelp
, copy it to a directory in
your PATH.
-lhelp -lButtface -lXpm -lXm -lXmu -lXt -lX11 ...
where <version> denotes the version number.ftp.informatik.uni-stuttgart.de: /pub/libhelp/libhelp-<version>.tar.gz
note: libhelp will be officially released in august 95. If
there is nothing on ftp.informatik.uni-stuttgart.de
mail me for a copy.
hp (hp/ux 7.x, 8.x, 9.x). ibm (aix 3.2.5 with ibm x11r5 and motif-1.2). pc (linux 1.x with x11r5 and motif-1.2). sgi (irix 5.1.x). sun4 (sunos 4.1.x with x11r5 and motif 1.2). sun5 (solaris 1.2 with x11r5 and motif 1.2).