.COMMENT .;EDITED 3-OCT-71 /LPW .COMMENT .;EDITED 26-DEC-73 TO REFLECT RSX OPERATION -- E. POLLACK .COMMENT .;EDIDET SPRING-74 TO UPDATE LANGUAGE--MARK ? .COMMENT EDITED 5-DEC-75 TO INCLUDE NEW COMMANDS BY DC. .STANDARD .LEFT MARGIN 5 .PAPER SIZE 50,63 .FLAGS CAPITALIZE .TITLE ^^PDP-11 RUNOFF\\ .FIGURE 5 .SPACING 1 .CENTER ^^PDP-11 RUNOFF\\ .BREAK .CENTER ------------- .SKIP 1 .CENTER ^AUTHOR: ^L. ^WADE .CENTER ^REVISION ^DATE: 5 ^DECEMBER 75 .CENTER ^PROGRAM ^VERSION:??\\ .SKIP 5 ^^NOTICE: T\\HIS MEMORANDUM DESCRIBES A PROGRAM WHICH ^DIGITAL ^EQUIPMENT ^CORPORATION HAS NO COMMITTMENT TO OFFER OR SUPPORT AT THIS TIME. ^THIS MEMORANDUM IS, HOWEVER, BELIEVED TO BE AN ACCURATE DESCRIPTION OF ^^RUNOFF\\. .PAGE .CENTER ^^INTRODUCTION\\ .BREAK .CENTER ------------ .SKIP 1 ^^RUNOFF\\ IS A ^^PDP\\-11 PROGRAM RUNNING UNDER ^^RSX\\ TO FACILITATE THE PREPARATION OF TYPED OR PRINTED MANUSCRIPTS, SUCH AS MEMOS, MANUALS, ETC. ^THE USER PREPARES HIS MATERIAL ON ANY REGULAR ^^PDP\\-11 TERMINAL, AND WRITES IT ONTO A FILE USING ^^EDIT11\\. ^THE USER INCLUDES NOT ONLY TEXTUAL MATERIAL, BUT ALSO CASE AND FORMATTING INFORMATION. ^^RUNOFF\\ THEN TAKES THE FILE AND REPRODUCES IT ONTO THE LINE PRINTER, TELETYPE OR OTHER FILE TO PRODUCE A FINAL COPY OR FINAL FILE IMAGE. ^IT PERFORMS THE FORMATTING AND CASE SHIFTING AS DIRECTED, AND WILL ALSO PERFORM LINE JUSTIFICATION, PAGE NUMBERING AND TITLING, ETC., AS DESIRED. .SKIP 1 ^THE PRINCIPAL BENEFIT OF SUCH A PROGRAM IS THAT FILES PREPARED FOR USE WITH IT MAY BE EDITED AND CORRECTED EASILY. ^SMALL OR LARGE AMOUNTS OF MATERIAL MAY BE ADDED OR DELETED, AND UNCHANGED MATERIAL NEED NOT BE RETYPED. ^AFTER A SET OF CHANGES, THE PROGRAM MAY BE OPERATED TO PRODUCE A NEW COPY WHICH IS PROPERLY PAGED AND FORMATTED. ^DOCUMENTATION MAY THUS BE UPDATED AS NECESSARY WITHOUT REQUIRING EXTENSIVE RETYPING. .SKIP 2 .TEST PAGE 20 .CENTER ^^ON-LINE OPERATION\\ .BREAK .CENTER ----------------- .INDEX ^^ON-LINE OPERATION\\ .SKIP 1 ^^RUNOFF\\ IS A PROGRAM MUCH LIKE MOST ^^PDP-11\\ ^^RSX\\ SYSTEM PROGRAMS. ^IT IS ACCESSED BY THE USUAL "^^MCR\\" COMMAND "^^MCR>RNO#---#\\" TO THE MONITOR. .SKIP 1 ^^RSX\\ ^RUNOFF USES THE ^^GCML\\ ^^MACRO\\ WITH A SPECIFIED INDIRECT DEPTH OF TWO, AND THEREFORE, ALL SPECIFICATIONS REGARDING ^^INDIRECT\\ ^FILES ARE APPLICABLE. .SKIP 2 .PAGE .CENTER ^^COMMAND INPUT\\ .BREAK .CENTER ------------ .INDEX ^COMMAND INPUT .SKIP ^COMMAND LINE FORMATS: .SKIP #####^^OUTFILE/SW=INFILE/SW^^ .SKIP ^DEFAULT FILE SPECIFICATIONS (ANY PART MAY BE OVERRIDDEN): .SKIP #####^INPUT: ^^SY:RUNOFF.RNO\\ .BREAK #####^OUTPUT: ^^SY:RUNOFF.LST\\ .SKIP ^THE FOLLOWING SWITCHES ARE RECOGNIZED: .SKIP .LEFT MARGIN 5 .NOFILL /^^-SP\\ -- ^INHIBIT SPOOLING OFPUT FILE /^^U\\ -- ^FORCE ^^ALL\\ UPPERCASE OUTPUT /^^UC\\ -- ^FORCES ^^ALL\\ UPPERCASE OUTPUT /^^FF\\ -- ^FORCE ^FORM-FEEDS (INSTEAD OF MULTI-^^LF\\S) /^^WA\\ -- ^WAIT FOR ^^CR\\ INPUT AT BEGINNING OF EACH PAGE /^^PA:L:H\\ -- ^OUTPUT ONLY INDICATED PAGE RANGE /^^UL:B\\ -- ^UNDERLINE WITH A SPACING-BACKSPACE /^^UL:C\\ -- ^UNDERLINE WITH A NON-SPACING-BACKSPACE /^^UL:L\\ -- ^UNDERLINE VIA LINE OVERPRINT /^^UL:N\\ -- ^UNDERLINING SUPPRESSED (DEFAULT CASE) /^^-HY\\ -- ^SUPRESS HYPHENATION .FILL .LEFT MARGIN 5 .PAGE .TEST PAGE 20 .CENTER ^^SOURCE FILE FORMAT\\ .BREAK .CENTER ------------------ .INDEX ^SOURCE FILE FORMAT .SKIP ^AS STATED ABOVE, THE SOURCE FILE CONTAINS THE TEXTUAL MATERIAL WHICH WILL APPEAR ON THE FINAL COPY, PLUS INFORMATION TO SPECIFY FORMATTING. ^MOST IMPORTANTLY, UPPER AND LOWER CASE INFORMATION MAY ALSO BE SUPPLIED SO THAT COPY CAN BE PREPARED ON THE TELETYPE OR OTHER SUCH DEVICE WHICH CAN NORMALLY INPUT ONLY UPPER CASE LETTERS. ^ALL COMMAND INFORMATION CONSISTS OF REGULAR ^^ASCII\\ PRINTING CHARACTERS SO THAT A LISTING OF THE SOURCE FILE MAY BE EXAMINED IF THE FINAL COPY IS NOT EXACTLY AS DESIRED. .SKIP ^ALL MATERIAL IN THE SOURCE FILE IS TAKEN TO BE SOURCE TEXT EXCEPT THOSE LINES BEGINNING WITH A PERIOD. ^A LINE BEGINNING WITH A PERIOD IS ASSUMED TO BE A COMMAND, .INDEX ^COMMAND FORMAT AND MUST MATCH ONE OF THOSE LISTED BELOW. ^THE COMMANDS PROVIDE THE FORMATTING INFORMATION, AND CONTROL VARIOUS OPTIONAL MODES OF OPERATION. .SKIP ^USUALLY THE TEXT IS FILLED .INDEX ^FILLING OF TEXT AND JUSTIFIED .INDEX ^JUSTIFICATION OF TEXT AS IT IS PROCESSED. ^THAT IS, THE PROGRAM ^^FILLS\\ A LINE BY ADDING SUCCESSIVE WORDS FROM THE SOURCE TEXT UNTIL ONE MORE WORD WOULD CAUSE THE RIGHT MARGIN TO BE EXCEEDED. ^THE LINE IS THEN ^^JUSTIFIED\\ BY MAKING THE WORD SPACINGS LARGER UNTIL THE LAST WORD IN THE LINE EXACTLY MEETS THE RIGHT MARGIN. .SKIP ^THE USER MAY OCCASIONALLY WISH TO REPRODUCE THE SOURCE TEXT EXACTLY, WHICH IS DONE BY DISABLING FILLING AND JUSTIFICATION. ^THE PROGRAM MAY BE SET TO FILL BUT NOT JUSTIFY, IN WHICH CASE THE OUTPUT WILL BE NORMAL EXCEPT THAT LINES WILL NOT BE JUSTIFIED TO THE RIGHT MARGIN. ^THE PROGRAM MAY ALSO BE SET TO JUSTIFY BUT NOT FILL, ALTHOUGH THIS WOULD PROBABLY PRODUCE PECULIAR RESULTS AND IS NOT RECOMMENDED. .SKIP ^WHEN THE FILL MODE IS ON, SPACES .INDEX ^SPACE .INDEX ^WORD SPACING AND CARRIAGE RETURNS OCCURRING IN THE SOURCE TEXT ARE TREATED ONLY AS WORD SEPARATORS. ^MULTIPLE SEPARATORS ARE IGNORED. .SKIP ^SOME OF THE COMMANDS CAUSE A ^^BREAK\\ .INDEX ^BREAK IN THE OUTPUT. ^A BREAK MEANS THAT THE CURRENT LINE IS OUTPUT WITHOUT JUSTIFICATION, AND THE NEXT WORD GOES AT THE BEGINNING OF THE NEXT LINE. ^THIS OCCURS AT THE END OF PARAGRAPHS. .SKIP ^THE PROGRAM WILL ADVANCE TO NEW PAGES AS NECESSARY, PLACING .INDEX ^PAGE ^NUMBERING .INDEX ^TITLE THE TITLE (IF GIVEN) AND THE PAGE NUMBER AT THE TOP OF EACH PAGE. ^THE USER MAY EXPLICITLY CALL FOR A PAGE ADVANCE WHERE DESIRED, AND MAY INHIBIT THE OCCURRANCE OF A PAGE ADVANCE WITHIN SPECIFIED MATERIAL. .SKIP 2 .TEST PAGE 20 .CENTER ^^CASE INFORMATION\\ .BREAK .CENTER ---------------- .INDEX ^CASE INFORMATION .SKIP ^SPECIFICATION OF CASE FOR FILES PREPARED ON THE TELETYPE IS DONE WITH TWO CHARACTERS, UP-ARROW (_^, SHIFT-^N), AND BACK-SLASH (_\, SHIFT-^L). ^THE APPEARANCE OF AN UP-ARROW CAUSES THE LETTER IMMEDIATELY FOLLOWING TO BE TRANSMITTED IN UPPER CASE. ^THE APPEARANCE OF A BACK-SLASH CAUSES THE LETTER IMMEDIATELY FOLLOWING TO BE CONVERTED TO LOWER CASE. ^ANY LETTER NOT PRECEEDED BY ONE OF THESE CHARACTERS IS TRANSMITTED IN THE CURRENT MODE. ^THE MODE IS INITIALLY LOWER CASE, AND IS CHANGED BY THE OCCURRANCE OF TWO SUCCESSIVE CASE CONTROL CHARACTERS. ^TWO UP-ARROWS (_^_^) CAUSE THE MODE TO BE SET TO UPPER CASE, AND TWO BACK-SLASHES (_\_\) CAUSE THE MODE TO BE SET TO LOWER CASE. .SKIP ^THE USE OF THE ABOVE CORRESPONDS TO THE USE OF THE SHIFT AND SHIFT-LOCK KEYS ON A TYPEWRITER. ^USUALLY, TYPING APPEARS IN LOWER CASE. ^TO TYPE ONE LETTER IN UPPER CASE, THE SHIFT KEY IS USED. ^THE SHIFT-LOCK IS SET TO TYPE A SERIES OF UPPER CASE LETTERS, AFTER WHICH IT IS RELEASED. .SKIP ^THE FOLLOWING SHOWS THE USES OF THE CASE CONTROL CHARACTERS: .SKIP 1 ^^_^HERE IS A _^SAMPLE _^SENTENCE IN _^_^UPPER CASE_\_\ AND LOWER CASE. \\ .SKIP 1 BECOMES: .SKIP 1 ^HERE IS A ^SAMPLE ^SENTENCE IN ^^UPPER CASE\\ AND LOWER CASE. .SKIP ^NOTE: ^CASE CONVERSION TAKES PLACE ONLY ON ^^ASCII\\ CODES 101 TO 132 OCTAL, THAT IS, THE UPPER CASE LETTERS. ^ANY ACTUAL LOWER CASE LETTERS (CODES 141 TO 172 OCTAL) APPEARING IN THE SOURCE WILL BE TRANSMITTED UNCHANGED. ^IF THE SOURCE IS PREPARED ON A DEVICE SUCH AS A FLEXOWRITER OR MODEL 37 TELETYPE WHICH PRODUCES LETTERS OF THE PROPER CASE, THE MODE SHOULD BE SET TO UPPER CASE AT THE BEGINNING OF THE FILE AND LEFT UNCHANGED FOR THE REMAINDER. .SKIP 2 .TEST PAGE 20 .CENTER ^^SPECIAL CHARACTERS\\ .CENTER ------------------ .INDEX ^SPECIAL CHARACTERS .SKIP ^THE CHARACTER AMPERSAND (_&, SHIFT-6) IS USED TO SPECIFY UNDERSCORING. .INDEX ^UNDERSCORING ^THE AMPERSAND WILL CAUSE THE CHARACTER FOLLOWING IT TO BE UNDERSCORED, E.G. _&F_&O_&O BECOMES ^&FOO\&. .SKIP ^UNDERLINING OF A STRING OF CHARACTERS CAN ALSO BE SPECIFIED, SIMILAR TO THE USE OF THE SHIFT LOCK OPERATIONS DESCRIBED ABOVE. ^AN APPEARANCE OF AMPERSAND PRECEDED BY UP-ARROW (_^_&) WILL CAUSE UNDERLINING OF ALL FOLLOWING CHARACTERS EXCEPT SPACE. ^AN APPEARANCE OF AMPERSAND PRECEDED BY BACKSLASH (_\_&) WILL DISABLE THIS MODE. .SKIP ^THE PRESENT VERSION OF ^^RUNOFF\\ USES THE ^^ASCII\\ CHARACTER 137 FOR AN UNDERLINE. ^THIS CHARACTER MAY BE CHANGED BY A REASSEMBLY OF ^^RUNOFF\\ IF NECESSARY. .S;^WHEN '