File: INSTALL

package info (click to toggle)
cost 2.2p1-3
  • links: PTS
  • area: main
  • in suites: woody
  • size: 1,032 kB
  • ctags: 1,728
  • sloc: ansic: 12,123; tcl: 2,702; sh: 209; makefile: 161
file content (159 lines) | stat: -rw-r--r-- 5,164 bytes parent folder | download | duplicates (2)
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
155
156
157
158
159
$Id: INSTALL,v 1.11 1999/10/20 19:24:46 joe Exp $
================================================================================
COST INSTALLATION GUIDE

	For information about Cost, see
	    <URL:http://www.flightlab.com/cost/>

	Please report any problems, questions, bugs, and suggestions
	for enhancements to:

	Joe English <joe@flightlab.com>, or <jenglish@crl.com>

================================================================================
BEFORE YOU START

To build Cost you will need a standard (ISO/ANSI) C compiler,
or something reasonably close.  'gcc' should be fine.

You will also need the following packages:

    * Tcl:   	Any version from 7.5 through 8.2 ought to work, with or without
		plus-patches and/or [incr Tcl].  However, I've really only
		tested the current version of Cost with Tcl 7.6+, Tcl 8.1,
		and Tcl 8.2.1.

    * [N]SGMLS:	SP/NSGMLS is recommended if it's available for your system.
		SGMLS version 1.1.91 is more portable and is next best.
		SGMLS version 1.1 will also work.

If you only want to process XML, then you don't need [N]SGMLS.

You may also want to get:

    * Tk:	Whichever version works with your copy of Tcl.


See below for archive sites where these packages may be obtained.

================================================================================
BUILDING COST UNDER UNIX

The usual routine:

	cd src
	./configure

	make package	;# build Cost as a dynamically loadable package
	make costsh	;# build Tcl interpreter with Cost package included
	make		;# all of the above

	make -n install	;# check what 'make install' will do
	make install	;# install the package

	make clean	;# remove intermediate files
	make spotless	;# remove intermediate files & all targets

If this works, great!

Chances are it won't work though.  I don't quite have the hang
of autoconf yet, sorry.  You can try copying 'Makefile.in'
to 'Makefile' and replacing @CONFIGVARS@ by hand.  Otherwise
e-mail me and I'll try to help.

On some platforms, it may be necessary to use different
compilation flags for shared objects than those which are
statically linked.  If this is the case, run 'make clean'
before 'make package'.  This will recompile all the .o files
with (hopefully!) the appropriate flags for shared objects.

To try Cost out before installing it, set the environment variable
COSTLIB to point to the 'lib' directory underneath where you unpacked
the distribution:

	setenv COSTLIB `pwd`/lib

For the truly adventurous, there is some support for the new
Tcl "Stubs" mechanism and for various other packages, but to add
these you'll need to edit the Makefile and tclAppInit.c by hand.

A couple other targets you might want:

	make costwish	;# Tcl interpreter with Cost and Tk built in
	make lib	;# build static library libcost<Version>.a

To build 'costwish', you must specify --with-tk=<dir>
to the 'configure' command, where <dir> specifies the location
of tkConfig.sh.


================================================================================
BUILDING COST UNDER WINDOWS

NOTE: a binary distribution for Windows is available as a
self-extracting executable from the Cost home page.

If you have the CYGWIN toolkit (release B20), you can run

	cd src
	sh cygconfig.sh     ;# note: autoconf configure script doesn't work
	make package

This builds Cost as a dynamically loadable library.
I haven't been able to build a standalone executable yet,
and you'll have to install stuff by hand:

	set COSTLIB=C:\PROGRA~1\TCL\Lib\COST22	
	rem ... or wherever you want to put it...
	rem  Note that Tcl only looks in %TCLDIR%\Lib for packages,
	rem  where %TCLDIR% is Tcl's installation directory (default  
	rem  "\Program Files\Tcl")

	mkdir %COSTLIB%
	copy libcost2.2.dll %COSTLIB%
	copy ..\lib\*.* %COSTLIB%

You can also try:

	make -n install | /bin/sh

For MSVC, there is a 'makefile.vc' file in the 'src' directory 
which *used* to work at one point.  I don't know if it still does.


================================================================================
BUILDING COST ON OTHER PLATFORMS

... I have no idea ...


================================================================================
WHERE TO GET STUFF

    Cost is available at
	<URL:ftp://ftp.crl.com:/users/je/jenglish/cost-2.2.tar.gz>

    NSGMLS and SGMLS are available at:
	<URL:ftp://ftp.jclark.com/pub/sp>
	<URL:ftp://ftp.jclark.com/pub/sgmls>
    and various mirror sites.

    Tcl and Tk are availble at
    	<URL:ftp://ftp.scriptics.com/pub/tcl>

    The CYGWIN toolkit contains a Windows port of many GNU utilities,
    including GCC.  Find it at:
	<URL:http://sourceware.cygnus.com/cygwin/>



Building SGMLS and Tcl is fairly simple.  Just unpack the
distributions, './configure',  'make', and (for Tcl) 'make install'.
You'll probably want to install the 'sgmls' executable somewhere
convenient as well like in /usr/local/bin.

Building SP/NSGMLS can be quite a bit more difficult.  If you have a
smart enough C++ compiler, then "./configure; make" ought to do the
trick.  If this doesn't work, abandon hope: try SGMLS instead.

================================================================================