.; INITIAL MACRO FOR USER'S GUIDES .MAC BEGIN TITLE ^^ .TI #################%1 .PS 66,105 .NORMAL .RMARG .TSET .NORMSP .NJ .FI .NU 0 THIS PAGE IS BLANK .PE .E .; .; LABEL MACROS .; There are three label macros which must be used together. .; The reason for having three is that it is hard to put all .; the label information on one macro call line. .; LAB1 prints the job title, LAB2 prints the subtitle, and .; LAB3 prints the author, date, RCB number and SP number. They .; should be used together, in order, at the start of the table .; of contents page. .; TI is the title, which must be 57 letters. .; ST " " subtitle, " " " 57 " .; NAM is the author's name; 14 letters. .; DAT is the date; 10 letters. .; RCB is the RCB number; 4 digits. .; SP is the SP number; 2 characters (use 1# for SP-1) .; NP is the number of pages in the document; 2 characters .MAC LAB1 TI .SP 1 .FO 5 .NF .NJ .RI 130 .LE 42 # # )BQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;W )B:)C%1)B: )B: : ! .E .; .MAC LAB2 ST .SP 1 .FO 1 .NF .NJ .RI 130 .LE 42 )B:%1: ! .E .; .MAC LAB3 NAM;DAT;RCB;SP;NP .SP 1 .FO 9 .NF .NJ .RI 130 .LE 42 )B!,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,7,,,,,,7,,,,,7,,,,,,," )B: DR'N#%1DATE#%2 .BLDG. .CODE . CLASS : )B!,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,/,,,,,,/,,,,,/,,,,,,," )B: APP'D DATE . 600 . . E : )B!,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,/,,,,,,8,,,,,8,,,,,,," )B: ATOMIC ENERGY OF CANADA .  A-RCB-%3-SP-%4#: )B:  LIMITED .  : )B: CHALK RIVER ONTARIO CANADA  .REV. SHEET 1 OF %5: )BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;$;;;;;;;;;;;;;;;;;;;;S ! .RMARG .NORMAL .E .; .;MODE-SETTING MACROS .; .; These must be adjusted for changes to margins, etc. .; .; Long for normal pages .MAC LONG .PS 60 .RMARG .E .; .; Normal margin .MAC NORMAL .LE 17 .E .; .; Narrow column -- this leaves only 64 columns for typing. .MAC NARROW .LE 25 .E .; .; Normal spacing .MAC NORMSP .SP 1 .E .; .; Normal right margin .MAC RMARG .RI 88 .E .; .; Open right margin for tables .MAC OPEN .RI 104 .E .; .; Standard tab settings -- modified to allow for 2-space .; shift. This ensures same appearence on screen and on .; output. .MAC TSET .TA 17 23 31 39 47 55 63 71 79 87 .E .; .; Fudge tabs for IN -5 with tab broken from text .MAC TFU .TA 17 24 31 .E .; .; LOCAL MACROS .; .; New subsection macro -- equivalent to .PA 0 .MAC SECT TEST .SK 2 .TE %1 .IN 0 .E .; .; New paragraph macro .MAC NP .SK 1 .TE 5 .IN 8 .E .; .; Start of example .MAC SEG CHECK .SK 1 .TE %1 .NF .NARROW .OPEN .E .; .; Print example line at margin -- only for NARROW .MAC EDGE .IN -8 .E .; .; End of example .MAC EEG .NORMAL .RMARG .FI .SK 1 .E .; .; Table entry. N is --, or [n] for numbered list. .MAC TAB N .SK 1 .TE 4 .NARROW .TFU .IN -5 %1 .E .; .; End of table .MAC ENDTAB .NORMAL .TSET .SK 1 .E .BEGIN A-RCB-0065-SP-5##########LST USER'S GUIDE .LAB1 ####################LST USER'S GUIDE##################### .LAB3 P.D.#McMorran#;#77-12-8##;0065;5#;2# .SECT 10 PURPOSE .NP LST [1] is used to format listings for documentation. It provides a standard header and adequate margins on all sides. It also produces working listings which are easy to read in binder or file. LST leaves a space at the bottom of page 1 for a standard label. .SECT 10 METHOD OF USE .SEG 5 Command String (showing defaults): LP:output=input.LST .EEG .NP Note that the output type will default to the input type. The output specification and the '=' sign may be omitted. If the output is directed to a file, it will not be spooled. .NP LST generates different formats for the different compiler and assembler listings. It identifies the compiler by reading the first line of the file, and exits with an error if the type is unknown. So, .LST should not be used as an extension for other files. .NP To compile a program for listing with LST, specify a file name for the listing, and use the /-SP switch in F4P or MAC. .NP LST will format MAC, F4P and RAT listings, IHI source files, command files and editor-created data files. It also detects the extension .TXT which causes it to treat the first character of each line as a FORTRAN carriage control. .SK 1 .SECT 20 INTERNAL CONTROLS .SEG 10 ;%Heading Causes a new page and resets page number to 1. ;%%Heading Causes new page with next page number. ;%_^ Causes new page. .EEG In these codes, ; represents the comment code for the language in use .BR (;, C or _#). It must be in column 1 of the source file. The comment code is used to permit the compiler to accept the line. It is not checked, and may be blank or any other character for general files. The 'heading' is used as a title on the first line of each page. .NP If the first line of the file is not a heading, LST will prompt for a header and repeat it for validation. .SECT 10 REFERENCES .TAB [1] "Documentation Aids". CRNL Reactor Control Branch Engineering File RCB-0077, Dec.#1977. .ENDTAB .PE BLANK PAGE AT END