PROJECT: MAC REPLACEMENT PROJECT DOC. TYPE: TECHNICAL NOTE SUBJECT: CCL COMMANDS: DOC, EDOC, SRC, ESRC - TECO OPTION TITLE: NEW CCL COMMANDS AND INDIRECT COMMAND FILES GROUP: LIBRARY AUTHOR: D.B.CURTIS DOC NO.: 42 DATE: 21-FEB-79 23:19 FILE: NCCLCMD.RNO MODIFIED: 12 MAR 79 14:47 PAGE 2 1.0 OBJECTIVES This document describes a TECO macro that you may want to use, and some previously undocumented system commands. 2.0 DISCUSSION TECO on the PDP-10 computer remembers the last file you editted. This facility is very useful to the users of the TECO editor. This document describes how you are able to have the same facility with the PDP-11 TECO. This document also describes the following system commands. At this writing, the source creation and editting commands are not yet implemented. They are described here for completeness. These commands are: 1. DOC -- Command that helps you generate documents 2. EDOC -- Command that helps you edit documents and leaves a modification trace 3. SRC -- Command that helps you create standard headers for source modules 4. ESRC -- Command that helps you edit sources and leaves a modification trace All of the above commands make use of either extensive indirect command files or TECO macros. These are stored on area [17,377]. 3.0 DETAILED PLAN This section is divided into two main subsections: 1. TECO.TEC 2. NEW CCL COMMANDS PAGE 3 3.1 TECO.TEC This TECO macro is called each time TECO is invoked. This is described in appendix C of the TECO-11 USERS MANUAL Page 82-84. Briefly, TECO allows this macro to modify the command line before TECO does its own command line processing. This allows the implemtation of another method of invoking TECO. All of the methods are listed below: 1. "TEC" - Runs TECO does not open any files. 2. "TEC filespec" Runs TECO, and does an "EBfilespec$ Y$$" 3. "MAK filespec" - Runs TECO, does an "EWfilespec$$" 4. "MUN filespec,inputline" - Runs TECO, does an "Iinputline$ EIfilespec$$" 5. "TECO" - Runs TECO, uses last defined filespec and executes TEC filespec 6. "TECO filespec" - Same as TEC filespec but saves the filespec for TECO All of the methods are described in the TECO USERS MANUAL except "TECO" and "TECO filespec" The four letter "TECO" flags the TECO.TEC macro to preprocess the command line. if a filespec is specified, it is saved on SY:LASTEDIT.CMD. If a filespec is not specified, TECO.TEC opens SY:LASTEDIT.CMD and uses its contents as the filespec for the TEC command. To obtain a copy of TECO.TEC, type "COPY /NV=[17,377]TECO.TEC". You may edit your copy of TECO.TEC to set TECO defaults if you wish. Some of these could be: 1. ^X - CASE INFORMATION DURING SEARCHES 2. ES - SELECTION OF AUTOMATIC VERIFICATION AFTER SEARCH 3. ED - ALLOWS "Y" TO OVERWRITE BUFFER, ALLOWS ^ TO FLAG FOLLOWING CHARACTER AS CONTROL ETC. 4. AND OTHER EXAMPLES PAGE 4 3.2 NEW CCL COMMANDS This section details some of the CCL comands that are available. There are four commands of two types: 1. CCL-invoked TECO indirect commands 1. EDOC -- edit document 2. ESRC -- edit source file 2. Indirect command files invoked by CCL. 1. DOC -- generate standard documents 2. SRC -- generate standard source modules 3.2.1 CCL-invoked TECO indirect commands - These commands help maintain documentation (EDOC) and source (ESRC) files. They perform the following functions: 1. prompt for a file name 2. save the name of the editted file in a trace file 3. attempt an EB open on the file name 4. update the date and time the file was modified 5. ESRC also updates the edit number PAGE 5 The prompt is: FILE NAME? The following string editting commands are available at this time: 1. ^U - functions as in TECO 2. ^R - retypes the line: functions as ^R to MCR 3. ^Z- exits automatic mode: enters normal TECO: exits the TECO macro 4. DELETE - functions as in TECO 5. ESCAPE - functions as RETURN 6. RETURN - opens last file edited by the TECO, EDOC, or ESRC commands. This uses the information in LASTEDIT.CMD as the file name to edit. The file name, either typed or defaulted, is then saved in a trace file on the users area. For EDOC, the trace file specification is "SY:ETRACE.CMD". For ESRC, the trace file specification is "SY:STRACE.CMD". The file is opened, and a page is read into memory. A modification trace is either added to the file or, if the trace already exists, it is updated. This trace is printed on your terminal. ESRC will also update and display the edit number if it exists. 3.2.2 Indirect command files invoked by CCL - These commands start indrect command files that reside in [17,377]. These files help you develope standard documentation and source modules. They are currently under develpoment. If you have a problem with them, please type "TELL CURTIS" or "TELL SYSTEM" and explane the problems you are having. DOC causes [17,377]GENDOC to be executed. This file leads you through a dialog that generates a document in the standard form. This document is in RNO source format. New projects or document types will be gladly added. SRC causes [17,377]GENSRC to be executed. This file leads you through a dialog that generates a standard source module. Examples of this PAGE 6 format are in appendix A. 4.0 GLOSSARY APPENDIX A EXAMPLES OF SOURCE FORMATS U N D E R D E V E L O P M E N T