15 May 1985 =================================================== Document Development Runoff Templates/Require Files =================================================== by Don Amby Delco Systems Operations General Motors Corporation Post Office Box 471, M/S 1A21 Milwaukee, Wisconsin 53201 (414)768-2682 GM Network: 8/521-2682 logical name: DOC_RNO The logical name DOC_RNO is assumed to point to this directory, and is set by the SETLOGS.COM file. This directory contains several standard Runoff REQUIRE files, and some templates that are used by the document development utilities (DOC_UTILS) to create new documents. Structured Documentation Development ------------------------------------ The purpose of a Runoff source file is the same as a source file in any programming language. These files are then run through a translation process that generates the desired output, from the input source files. The include (or require for *.RNO) files are set up to encapsulate common features of a document, be it a memo, a short report, or a large manual composed of many chapters and appendices. This is like the partitioning a large program into a set of reusable functions or procedures, that can be used by anyone to build new programs with them. They also function similar to the constants, types, and variable declarations of a programming language such as PASCAL. Important Files --------------- The following is a list of some of the important files that are to be found in this directory. REPORT.RNO Standard REPORT Body file template. REPORT.TOC Standard REPORT Table of Contents file template. REPORT.TPG Standard REPORT Title page file template. REPORT.TTL Standard REPORT Page heading file template. SETLOGS.COM Defines logical names for this directory. STD*.RNO Standard setup files for Runoff documents.