Makefile.confassume a GNU make tool, and
Makefile.confworks out of the box in the linux/gcc environment only. For the Windows/cygwin environment, it should suffice to set
os = linuxin
goshshell tool. This requires that Tcl/Tk header files can be located by the compiler.
Binaries are not distributed regularly. An MS Windows setup will be provided for every major build (2.7, 2.8, ...), roughly once every year. The latter is a condensed cygwin runtime environment including several packages required for GUI output to bitmap and vectorial file formats. The Windows setup is intended for non-experienced end users and for quick validation. To advanced end users and developers, a regular cygwin installation is recommended, since the cygwin condensation step does not take care of package management.
goblin.2.8.tgzarchive by typing
tar xfz goblin.2.8.tgz
This will extract to a
goblin.2.8 directory right below the current working directory. If you also want to install the test code package (say
goblin.2.8.test.tgz, do it from the same working directory.
goblin.2.8root directory. If necessary, edit the
Makefile.conffile (and changes are indeed necessary for platforms other than linux/gcc). Build the binaries by typing
This results in several libraries (copied to the the
lib subfolder) and in the shell tool
gosh (copied to the the
You may test your personal installation by starting the
./goblet graph browser from the
Makefile directory, and loading one of the test problems in the
samples folder. If you have installed the test code, an automated test can be started from the GUI. This might turn out one of the known runtime problems.
In the testing environment, the GUI can only be started from the setup root directory!
If you get stuck with the shell tool build, but you only want to use the C++ API, type
If you want to use a solver executable rather than the API, say the matching solver, then
make exe pr=optmatch
creates the executable
optmatch. The complete list of executable solvers can be found in the folder
includedirectories and edit the
configuration.hto get ridd off the code instrumentation utilized by the GUI. Details can be found in Section Compile time configuration .
In the output, the entry point for browsing the documentation is
There is also a latex manual which is build by the command
os = linuxin
Makefile.conf. In order to have a full featured GUI, the following packages are required:
fig2devfor processing vectorial graphing formats
netpbmfor processing bitmaps
These packages are also used in the linux environment, but the cygwin setup does not install them by default.
init.tclcannot be found: In occasion, this probably also happens when one of the shell tools
goshis started directly. The problem has been observed with cygwin installations, and can be fixed by brute copying the file where the tcl interpreter finds it.
tcl_platform(threaded)option. One can fix the problem either by re-compiling the Tcl library or by installing a special distribution from the net (for example at mK extensions project or the Active Tcl distribution). Download works fine for linux, but in the cygwin case the original problem is most likely replaced by the following bug:
fig: Some graphing tool is missing. If vectorial formats such as
epscan be generated, but
gifcannot, something is wrong with the netpbm installation (the package used for bitmap manipulation). Otherwise, the
fig2devcommand line tool cannot be accessed. The latter tool is associated with the
xfigvectorial drawing program (sharing the input file format), but not necessarily installed with
xfig). Output to the
figformat is possible in any case.
[See manual page index]