VMS/IRAF Installation and Site Manager's Guide

VMS/IRAF Installation and Site Manager's Guide

9.3. Software management tools

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.