Subversion Repositories tendra.SVN

Rev

Rev 2 | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 2 Rev 7
Line 1... Line 1...
1 
TENDRA 4.1.2 RELEASE INFORMATION
 1 
TENDRA 5.0.0 RELEASE INFORMATION
2 
================================
 2 
================================
3 
 
 3 
 
- 
 
 4 
REVISION INFORMATION
- 
 
 5 
--------------------
- 
 
 6 
$Id$
4 
 
 7 
 
5 
COPYRIGHT INFORMATION
 8 
COPYRIGHT INFORMATION
6 
---------------------
 9 
---------------------
7 
 
 10 
 
8 
Please read the file COPYRIGHT for the DERA copyright notice.  In addition,
 11 
Please read the file COPYRIGHT for the copyright notice.
9 
the power installer (src/installers/power and its subdirectories) are
 - 
 
10 
subject to the following copyright notice:
 - 
 
11 
 
 - 
 
12 
    Copyright (c) 1996 Open Software Foundation, Inc.
 - 
 
13 
 
 - 
 
14 
    All Rights Reserved
 - 
 
15 
 
 - 
 
16 
    Permission to use, copy, modify, and distribute this software and its
 - 
 
17 
    documentation for any purpose and without fee is hereby granted, provided
 - 
 
18 
    that the above copyright notice appears in all copies and that both the
 - 
 
19 
    copyright notice and this permission notice appear in supporting
 - 
 
20 
    documentation.
 - 
 
21 
 
 - 
 
22 
    OSF DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE
 - 
 
23 
    INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 - 
 
24 
    FOR A PARTICULAR PURPOSE.
 - 
 
25 
 
 - 
 
26 
    IN NO EVENT SHALL OSF BE LIABLE FOR ANY SPECIAL, INDIRECT, OR
 - 
 
27 
    CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
 - 
 
28 
    LOSS OF USE, DATA OR PROFITS, WHETHER IN ACTION OF CONTRACT,
 - 
 
29 
    NEGLIGENCE, OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
 - 
 
30 
    CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 - 
 
31 
 
 - 
 
32 
and the Motif 1.2 API description (src/lib/apis/motif1.2 and its
 - 
 
33 
subdirectories) are subject to the following copyright:
 - 
 
34 
 
 - 
 
35 
    COPYRIGHT NOTICE
 - 
 
36 
 
 - 
 
37 
    This program is the proprietary property of IXI Ltd, a subsidiary
 - 
 
38 
    of the Santa Cruz Operation (SCO). Use, reproduction, production
 - 
 
39 
    of amended versions and/or transfer of this program is permitted
 - 
 
40 
    PROVIDED THAT:
 - 
 
41 
 
 - 
 
42 
    (a)  This legend be preserved on any such reproduction and amended
 - 
 
43 
         version.
 - 
 
44 
 
 - 
 
45 
    (b)  Any recipient of such reproduction or amended version accept
 - 
 
46 
         the conditions set out in this legend.
 - 
 
47 
 
 - 
 
48 
    IXI accepts no liability whatsoever in relation to any use to
 - 
 
49 
    which this program may be put and gives no warranty as to the
 - 
 
50 
    program's suitability for any purpose.
 - 
 
51 
 
 - 
 
52 
    All rights reserved.
 - 
 
53 
 
 - 
 
54 
    Copyright (c) 1995, 1996
 - 
 
55 
 
 - 
 
56 
 
 - 
 
57 
DOWNLOADING INFORMATION
 - 
 
58 
-----------------------
 - 
 
59 
 
 - 
 
60 
The TenDRA 4.1.2 release is available via the Web site:
 - 
 
61 
 
 - 
 
62 
	http://alph.dera.gov.uk/TenDRA/
 - 
 
63 
 
 - 
 
64 
or by FTP from alph.dera.gov.uk, in the directory /pub/TenDRA.  It consists
 - 
 
65 
of the gzipped tar archive:
 - 
 
66 
 
 - 
 
67 
	TenDRA-4.1.2.tar.gz
 - 
 
68 
 
 - 
 
69 
(about 3.9MB - see the actual site for the precise figure), plus the
 - 
 
70 
optional documentation, comprising a copy of the documents available
 - 
 
71 
from the TenDRA web site:
 - 
 
72 
 
 - 
 
73 
	TenDRA-4.1.2-doc.tar.gz
 - 
 
74 
 
 - 
 
75 
(about 760kB).
 - 
 
76 
 
 - 
 
77 
 
 - 
 
78 
INSTALLATION INFORMATION
 - 
 
79 
------------------------
 - 
 
80 
 
 - 
 
81 
The main source archive, TenDRA-4.1.2.tar.gz, can be extracted using:
 - 
 
82 
 
 - 
 
83 
	gzip -d TenDRA-4.1.2.tar.gz
 - 
 
84 
	tar xvf TenDRA-4.1.2.tar
 - 
 
85 
 
 - 
 
86 
to give a directory, TenDRA-4.1.2, containing the release source.  If
 - 
 
87 
you also want to install the release documentation you will also need to
 - 
 
88 
download TenDRA-4.1.2-doc.tar.gz and extract this as above.  The
 - 
 
89 
documentation is extracted into the subdirectory TenDRA-4.1.2/doc.
 - 
 
90 
 
 - 
 
91 
The release is installed by running the shell script INSTALL found in
 - 
 
92 
the main source directory.  The default configuration installs the
 - 
 
93 
public executables into /usr/local/bin, the private executables,
 - 
 
94 
libraries, configuration files etc. into /usr/local/lib/TenDRA, and
 - 
 
95 
the manual pages into /usr/local/man. It also assumes that the source
 - 
 
96 
has been installed in /usr/local/src/TenDRA-4.1.2.  These locations
 - 
 
97 
may be changed by editing the INSTALL script (which is fully commented).
 - 
 
98 
 
 - 
 
99 
Note that the installation script makes no distinction between build
 - 
 
100 
and installation due to the large degree of interdependence between
 - 
 
101 
the various tools.  If a separate build phase is required then the
 - 
 
102 
system should be installed into a local directory and then re-installed
 - 
 
103 
into its permanent location.
 - 
 
104 
 
 - 
 
105 
Other installation details, such as which compiler to use, can be
 - 
 
106 
specified using command-line options to INSTALL, or by editing the
 - 
 
107 
script.  For example:
 - 
 
108 
 
 - 
 
109 
	INSTALL -gcc
 - 
 
110 
 
 - 
 
111 
will install the release using gcc as the compiler.  After this the
 - 
 
112 
work directory can be removed, and:
 - 
 
113 
 
 - 
 
114 
	INSTALL -tcc
 - 
 
115 
 
 - 
 
116 
run to bootstrap the system.
 - 
 
117 
 
 - 
 
118 
It is suggested that the output of INSTALL is piped into a log file
 - 
 
119 
for later examination if things go wrong (the script will report whether
 - 
 
120 
or not there were errors in the installation, but it isn't always
 - 
 
121 
reliable).
 - 
 
122 
 
 - 
 
123 
The comments in the INSTALL script should be consulted for more details.
- 
 
124 
 
 - 
 
125 
 
 - 
 
126 
KNOWN INSTALLATION PROBLEMS
 - 
 
127 
---------------------------
 - 
 
128 
 
 - 
 
129 
Several of the components have been updated to use the posix1 or xpg4
 - 
 
130 
APIs rather than the older posix and xpg3.  Due to an error in the
 - 
 
131 
TenDRA-4.1.1 posix1 API specification, this means that they may not
 - 
 
132 
compile under the TenDRA-4.1.1 (although they will with TenDRA-4.1.2
 - 
 
133 
of course).  If this is an issue then modify the Makefiles to use
 - 
 
134 
the older APIs.
 - 
 
135 
 
 - 
 
136 
The location of certain system linker files has changed in later versions
 - 
 
137 
of Linux.  The solution is to change the tcc environment files to reflect
 - 
 
138 
the new locations.  This can be done by:
 - 
 
139 
 
 - 
 
140 
	cd src/lib/env/linux/elf
 - 
 
141 
	mv 80x86 80x86.old
 - 
 
142 
	mv 80x86.new 80x86
 - 
 
143 
 
 - 
 
144 
before running INSTALL.
 - 
 
145 
 
 12 
 
146 
 
 13 
 
147 
ORGANISATION OF RELEASE
 14 
ORGANISATION OF RELEASE
148 
-----------------------
 15 
-----------------------
149 
 
 16 
 
Line 176... Line 43...
176 
target CPUs:
 43 
target CPUs:
177 
 
 44 
 
178 
    680x0		Motorola 68020, 68030 and 68040,
 45 
    680x0		Motorola 68020, 68030 and 68040,
179 
    80x86		Intel i386, i486 and Pentium,
 46 
    80x86		Intel i386, i486 and Pentium,
180 
    alpha		DEC Alpha,
 47 
    alpha		DEC Alpha,
- 
 
 48 
    amd64		AMD64,
181 
    hppa		HP Precision Architecture,
 49 
    hppa		HP Precision Architecture,
182 
    mips		SGI/DEC MIPS,
 50 
    mips		SGI/DEC MIPS,
183 
    power		POWER,
 51 
    power		POWER,
184 
    ppc601		POWER PC,
 52 
    ppc601		POWER PC,
185 
    sparc		SPARC.
 53 
    sparc		SPARC.
Line 187... Line 55...
187 
Each CPU directory is also divided into a common section, plus a directory
 55 
Each CPU directory is also divided into a common section, plus a directory
188 
for each of the target operating systems:
 56 
for each of the target operating systems:
189 
 
 57 
 
190 
    680x0/sunos		680x0 on SunOS 4,
 58 
    680x0/sunos		680x0 on SunOS 4,
191 
    80x86/cygwin32	Intel on Cygwin32,
 59 
    80x86/cygwin32	Intel on Cygwin32,
- 
 
 60 
    80x86/dragonfly	Intel on DragonFly,
192 
    80x86/freebsd	Intel on FreeBSD,
 61 
    80x86/freebsd	Intel on FreeBSD,
193 
    80x86/linux		Intel on Linux,
 62 
    80x86/linux		Intel on Linux,
- 
 
 63 
    80x86/minix		Intel on Minix,
- 
 
 64 
    80x86/netbsd	Intel on NetBSD,
- 
 
 65 
    80x86/openbsd	Intel on OpenBSD,
194 
    80x86/sco		Intel on SCO,
 66 
    80x86/sco		Intel on SCO,
195 
    80x86/solaris	Intel on Solaris 2,
 67 
    80x86/solaris	Intel on Solaris 2,
196 
    80x86/svr4.2	Intel on Unixware,
 68 
    80x86/svr4.2	Intel on Unixware,
197 
    alpha/osf1		Alpha on OSF/1,
 69 
    alpha/osf1		Alpha on OSF/1,
- 
 
 70 
    amd64/dragonfly	AMD64 on DragonFly,
- 
 
 71 
    amd64/freebsd	AMD64 on FreeBSD,
- 
 
 72 
    amd64/linux		AMD64 on Linux,
- 
 
 73 
    amd64/netbsd	AMD64 on NetBSD,
- 
 
 74 
    amd64/openbsd	AMD64 on OpenBSD,
198 
    hppa/hpux		HP-PA on HP-UX,
 75 
    hppa/hpux		HP-PA on HP-UX,
199 
    mips/irix		MIPS on Irix,
 76 
    mips/irix		MIPS on Irix,
200 
    mips/ultrix		MIPS on Ultrix,
 77 
    mips/ultrix		MIPS on Ultrix,
201 
    power/aix		POWER on AIX,
 78 
    power/aix		POWER on AIX,
202 
    ppc601/aix		POWER PC on AIX,
 79 
    ppc601/aix		POWER PC on AIX,
Line 260... Line 137...
260 
			memory allocation etc.
 137 
			memory allocation etc.
261 
 
 138 
 
262 
The tools directory contains the source for a number of different tools:
 139 
The tools directory contains the source for a number of different tools:
263 
 
 140 
 
264 
    disp		translates TDF into a human readable form;
 141 
    disp		translates TDF into a human readable form;
265 
 
 - 
 
266 
    pl			is a structured TDF assembler;
 - 
 
267 
 
 142 
 
268 
    tcc			is the front-end to the TenDRA compiler;
 143 
    tcc			is the front-end to the TenDRA compiler;
269 
 
 144 
 
270 
    tld			links a number of TDF capsules into one;
 145 
    tld			links a number of TDF capsules into one;
271 
 
 146 
 
272 
    tnc			is an unstructured TDF assember and disassembler;
 147 
    tnc			is an unstructured TDF assember and disassembler;
- 
 
 148 
 
- 
 
 149 
    tpl			is a structured TDF assembler;
273 
 
 150 
 
274 
    tspec		is a specification tool used in the TenDRA API
 151 
    tspec		is a specification tool used in the TenDRA API
275 
			descriptions.
 152 
			descriptions.
276 
 
 153 
 
277 
The utilities directory contains the source for a number of different
 154 
The utilities directory contains the source for a number of different
Line 282... Line 159...
282 
 
 159 
 
283 
    lexi		is a simple lexical analyser generator (lex is
 160 
    lexi		is a simple lexical analyser generator (lex is
284 
			not used);
 161 
			not used);
285 
 
 162 
 
286 
    make_err		is used to manage the producer error catalogue;
 163 
    make_err		is used to manage the producer error catalogue;
287 
 
 - 
 
288 
    make_mf		is a simple makefile generator;
 - 
 
289 
 
 164 
 
290 
    make_tdf		is used to generate TDF encoding and decoding
 165 
    make_tdf		is used to generate TDF encoding and decoding
291 
			routines from the TDF specification;
 166 
			routines from the TDF specification;
292 
 
 167 
 
293 
    shared		contains code common to a number of tools;
 168 
    shared		contains code common to a number of tools;
294 
 
 169 
 
295 
    sid			is a parser generator (yacc is not used);
 170 
    sid			is a parser generator (yacc is not used);
296 
 
 - 
 
297 
    tuname		is a uname-like utility used in the installation
 - 
 
298 
			process.
 - 
 
299 
 
 171 
 
300 
The lib directory is divided into a number of subdirectories:
 172 
The lib directory is divided into a number of subdirectories:
301 
 
 173 
 
302 
    apis		containing the TenDRA API descriptions used in
 174 
    apis		containing the TenDRA API descriptions used in
303 
			its API checking facilities;
 175 
			its API checking facilities;