VMS/IRAF Installation and Site Manager's Guide
VMS/IRAF Installation and Site Manager's Guide
IRAF software management is performed with a standard set of tools,
consisting of the tasks in the SOFTOOLS package, plus the host system
editors and debuggers. Some of the most important and often used tools for
IRAF software development and software maintenance are the following.
- mkhelpdb
- Updates the HELP database of the core IRAF system or an external package
installed in hlib$extern.pkg.
The core system, and each external package, has its own help database.
The help database is the machine independent file helpdb.mip in the
package library (LIB directory). The help database file is generated with
mkhelpdb by compiling the root.hd file in the same directory.
- mkpkg
- The "make-package" utility. Used to make or update package trees.
Will update the contents of the current directory tree. When run at
the root iraf directory, updates the full IRAF system; when run at the
root directory of an external package, updates the external package.
Note that updating the core IRAF system does not update any external
packages (including NOAO). When updating an external package, the
package name must be specified, e.g., "mkpkg -p noao", and the command
issued within the package directory, not from the IRAF root.
- rmbin
- Descends a directory tree or trees, finding and optionally listing or
deleting all binary files therein. This is used, for example, to strip
the binaries from a directory tree to leave only sources, to force
mkpkg to do a full recompile of a package, or to locate all the
binary files for some reason. IRAF has its own notion of what a binary
file is. By default, files with the "known" IRAF virtual file extensions
(.a, .o, .e, .x, .f, .h, etc.) are classified as binary or text
(machine independent) files immediately,
while a heuristic involving examination of the file data
is used to classify other files. Alternatively, a list of file extensions
to be searched for may optionally be given.
- rtar,wtar
- These are the portable IRAF tarfile writer (wtar) and reader
(rtar) programs. These tasks produce archives compatible with
the UNIX tar program. In addition they can move only the machine
independent or source files
(wtar, like rmbin, can discriminate between machine
generated and machine independent files). A tarfile written on a VMS/IRAF
system has the files blank padded, but rtar when used on a UNIX
system will strip the trailing blanks by default.
- xc
- The X (SPP) compiler. This task can compile ".x" or SPP source files, knows
how to link with the IRAF system libraries and the shared library, knows how
to read the environment of external packages, and so on.
The SOFTOOLS package contains other tasks of interest, e.g., a program
mktags for making a tags file for the vi editor, a help
database examine tool, and other tasks. Further information on these
tasks is available in the online help pages.