trh@ukc.UUCP (T.R.Hopkins) (05/11/85)
As promised in an earlier posting here is the official contents of the first
public release of Toolpack. The deal is that it is public domain - the cost
of the tape is approx $100. Nag will try and fix any bugs but don't offer an
instant service.
There is a specially tailored C version of the Toolpack interface which
makes the tools go at an acceptable speed.
For more information (order forms etc.) contact :-
The Toolpack Coorinator,
NAG Central Office,
Mayfield House,
256, Banbury Road,
Oxford OX2 7DE,
U.K.
Or if you mail me your snail mail address I'll pass it on to NAG which may
save a week or two (no I don't get any commission!!)
Tim Hopkins,
Computing Laboratory,
University of Kent,
Canterbury CT2 7NF
Kent
U.K.
{ trh@ukc.UUCP }
Contents Summary
NAG Toolpack Public Distribution Tape: Toolpack/1
Summary:
This is a summary of the contents of the NAG Toolpack/1
distribution tape.
Tools:
The following tools are included on the tape. The tape also
includes a tool installers' guide and separate tool user
guides for each of the tools.
ISTAL A documentation generation aid, this tool can also be
used interactively to view symbols or the results of
ISTAN instrumentations.
ISTAN A Fortran 77 instrumentor for collecting run time
statistics and trace information.
ISTCE A command executor.
ISTCI An experimental command interpreter.
ISTDC A data file comparison tool.
ISTDS A programmable tool for standardising the declarative
sections of Fortran 77 program units.
ISTDX A small tool to strip marked documentation comments
from a Fortran source code file.
ISTED A line based editor with some facilities to assist the
Fortran 77 programmer.
ISTFD A fortran aware differencer.
ISTFI A tool to find "include file" dependencies.
ISTFL A file length measuring utility (this is an example
tool for the tool writers guide).
ISTFP A fast unscanner.
ISTGI A tool to turn intrinsic function references into their
generic forms.
ISTGP A generalised pattern finder.
ISTHP A simple on-line help system for the tool suite.
ISTJF A symbolic differentiator for Fortran 66.
ISTLX A Fortran 77 lexer/scanner.
ISTMP A comprehensive macro processor.
ISTNA The attribute generator for the Newton debugging
system.
ISTNI The instrumentor for the Newton debugging system.
ISTNL A loader for the Newton debugging system.
ISTNR The run time library for the Newton debugging system.
ISTPL A programmable Fortran 77 polisher.
ISTPO An interactive, menu driven, polish option editor.
ISTPR A simple Fortran 77 parser, this tool is only used in
association with the Newton debugging system.
ISTPT A tool to transform the arithmetic precision of a
Fortran program unit.
ISTRF A text formatter.
ISTSP A file splitter.
ISTSV A save/restore tool, similar to ISTSP but capable of
saving and restoring directory sub-trees.
ISTTD A programmable text differencer.
ISTVC A version controller.
ISTVS An utility for examining attributed symbol tables.
ISTVT An utility to display a parse tree, or print it out.
ISTYP A parser. This creates a parse tree and attributed
symbol table from a token stream.
ISTYF A parse tree flattener, this converts a parse tree to a
token stream.
ISTX1 An experimental simple expert system.
ISTX2 An experimental simple expert system.
ISTX3 An experimental simple expert system.
Documentation:
The following machine readable documentation is provided on
the tape. This list does not include documents mentioned
elsewhere in this summary.
FOC A document that describes how flow of control between
Toolpack/1 tools and command executors is achieved.
NTD A discussion document on the proposed updating of the
TIE portability base.
QRG A quick reference guide to the routines available in TIE
and the supplementary libraries.
SED A description of source embedded directives, a technique
for embedding tool control statements in Fortran source
code.
TDG Documentation guide and glossary.
TDM A guide to the Toolpack/1 documentation macros used for
text processing.
TQG A quick reference guide to the tools provided in
Toolpack/1.
TRD TIE Routine Definitions. The definitions of the TIE
routines and the Toolpack/1 virtual machine.
TWG Tool writers guide.
WIT What is TIE? A brief overview of TIE.
TIE Implementations:
The following implementations of TIE are provided. Each is
accompanied by installer documentation and any additional
utility programs required. Additionally, draft versions of a
TIE implementors guide and a TIECODE operation guide are
provided. Machine specific implementations are also
accompanied by example script or command files to assist in
using the tools.
TIECODE This is the 'portable' implementation of TIE written
in Fortran 77.
TIEVMS This is an implementation of TIE for the VAX(tm)
running under VMS(tm). The implementation is in a
mixture of Pascal and Fortran 77. Both Pascal and
Fortran compilers are required to use this version.
TIEC This is an implementation of TIE for Unix(tm)
systems. The implementation is written in C.
Supplementary Libraries:
The following supplementary libraries are provided. Unless
otherwise stated, these libraries may be considered portable
as they are built on the facilities provided by TIE. Each
supplementary library is accompanied by a user guide.
Access This is a library of routines to assist in the
reading, writing and modification of low-level
objects. The low-level objects covered include; ISTLX
format token streams, ISTYP format parse trees, ISTPR
format parse trees and ISTYP format symbol tables.
String This is a library of additional string handling and
manipulation routines. The library includes regular
expression pattern matching and string replacement.
Tables This is a library of routines that provide the means
of setting up and manipulating data structures such as
linked lists, queues, binary trees and tables.
Window This is a library of routines that provide a degree of
control over terminals. The library is split into
screen and window handling sections. This
supplementary library is likely to require some
installation effort.