UIS Source Code Annotator

This document serves as a user's guide for the UIS Source Code Annotator, a tool designed to facilitate the migration of VWS (VMS Workstation Software) applications to DECwindows. Operating on VMS V5.1 or above, the Annotator analyzes source code written in languages such as BASIC, FORTRAN, and Pascal (excluding Ada), identifying UIS$, UISDC$, and HCUIS$ routines. For each identified routine, it inserts comments into the code, providing information about equivalent Xlib routines, alternative methods for achieving similar functionality in DECwindows, or indicating if no direct equivalent exists. The process generates two outputs: an "annotated" source file (which remains compilable) and a "summary report" detailing the routines found, their validity, and the number of times they were called. The guide also includes detailed appendices listing UIS, UISDC, and HCUIS routines with their Xlib equivalents and functional explanations, a compilation of Annotator messages, and examples of annotated FORTRAN and Pascal programs with their respective summary reports.