Bonner Lab RUNOFF - Known bugs 1 Fall 82 John Clement Bonner Nuclear Labs Rice University P.O. Box 1892 Houston, Tx, 77251 April 29, 1982 The following is a complete list of known bugs in BONNER LAB RUNOFF. Each version fixed the bugs in the previous one and the Fall 83 bugs will be fixed in the next release. BUGS in the Fall 82 version ---- -- --- ---- -- ------- 1. Footnotes would not correctly justify and fill. This could have been worked around by using .NO FILL inside footnotes. 2. Footnotes would sometimes cause the first line of the next page to have incorrect fill and justification. 3. STYLE HEADERS wouldn't work in conjuction with NO HEADER, and TOP MARGIN 0. 4. .ELLIPSES would sometimes cause mistabulation. 5. .SUBPAGE command at the beginning of the first page causes RUNOFF to bomb. This is a nonsensical command sequence so nobody should have had problems with this one. 6. SUBSTITUTION failed unpredictably if a large number of substitutes were defined. 7. /RI switch did not work at all properly. This could be worked around with a permanent left margin. 8. RNO failed to underline the last word of a section terminated by \& if the last word occurred on the first word of an output line. 9. In .HEADER LEVEL command if capitalized first character is desired and the first char. was already in caps, the second char would be capitalized. The workaround was to not capitalize any section headers or use .STYLE HEADERS to disable automatic capitalization. 10. .LITERAL or .END LITERAL commands may bomb RNO with odd address trap. Also .LITERAL didn't turn off the flags properly if it worked. The use of .FLAGS ALL and .NO FLAGS ALL provided a partial workaround. 11. If overstriking preceeds underlining on the same line, underlining by /UL:S or /UL:L will fail to underline correctly. /UL:B worked however. 12. If both .NUMBER PAGE and .NUMBER SUBPAGE are used before a .SUBPAGE command the page number will be wrong. 13. Runoff can mess up the number of spaces in a line if the following conditions were met. .FILL .PERIOD are enabled and the end of the input line is terminated by a punctuation followed by a space. Since there is no need to have a space after a punctuation at the end of the line the workaround was to remove the final space. Bonner Lab RUNOFF - Known bugs 2 Spring 83 BUGS in Spring 83 version ---- -- ------ -- ------- 1. Equations imbedded inside text were not handled properly if the line had to be split. They are now properly moved to the next line. 2. Lines did not properly justify if they included equations. .NJ was the only solution in previous versions. 3. If .FILL is enabled and a printable escape sequence is braketed by a pair of spaces the final space was removed. This no longer happens if the HSP attribute is defined for the escape sequence. 4. If an escape sequence changed the pitch of the printer, improper un- derlining may result. If the pitch change can be specified by the PSP and HSP attributes then the underlining will be correct, other- wise the user must use /UL:B instead of UL:L. 5. Module RNOIF was in the wrong overlay. It must be in the same over- lay with OPEN,CLOSE or an overlay that calls OPEN,CLOSE. This has been fixed. RNO would bomb when a .IF statement was not folowed by the appropriate .ENDIF inside a "required file". 6. If hyphenation is enabled and escape sequences are used occasionally RNO will hyphenate the output in strange places. The workaround is to .DHY during escape sequences. 7. Strange hyphenation may occurr after tabs have been used. In general hyphenation only worked properly for normal text. Now it should work properly for all text. Authohyphenation has been restricted to normal text, but user specified hyphenation may be used in any text except equations. 8. Roman numerals were incorrectly converted for 9,90-99,900-999. . . 9. .NUMBER LIST n started numbering at n+1 rather than n. .NUMBER LEVEL also worked incorrectly. The defaults have been modified for the .NUMBER commands to correspond exactly to DSR. 10. .LITERAL or .NO FLAGS ALL would turn off SPECIAL FLAGS permanently never to turn on again. 11. The LCK attribute for escape sequences did not work correctly unless .FLAGS ESCAPE command was used. 12. The /WA switch worked incorrectly when combined with /PA. RNO would wait at the top of pages which are not being printed. BUGS in the Fall 83 version ---- -- --- ---- -- ------- 1. The subindex flag could not be used as a regular character after a .INDEX command even when preceeded by _. 2. Subindex terms with trailing or leading blanks were improperly in- dexed. 3. The index flag did not terminate an autoindex term. 4. .NUMBER LIST caused a fatal error in subsequent .LIST or .LIST ELE- MENT commands. 5. If .NUMBER CHAPTER and a .LAYOUT other than 0 is used the last page of each chapter was improperly numbered. 6. .SUBPAGE, and .END SUBPAGE did not work correctly. The subpage letter was correct, but the page number was incorrect. Bonner Lab RUNOFF - Known bugs 3 Fall 83 7. .DEFINE COMMAND did not work properly if the defined command line in- cludes literal parameters. Unpredictable results occurr when the command is used. 8. .IMMEDIATE TEST TEXT and .IMMEDIATE TEST PAGE incorrectly broke the input lines. 9. /-FF:n did not work correctly. n had to be in half lines and if n=0 an infinite loop resulted. 10. /PS:n also had to be in half lines. It is now in lines. 11. Occasionally when .JUSTIFY and .VARIABLE SPACING are in effect the first line after the page header was improperly justified. 12. .NO FLAGS EQUATION causeed an infinite loop if preceeded by .FLAGS EQUATION. 13. .TEXT would sometimes lose sections of the input text if .SKIP or .BLANK occurred at the end of a page. 14. When /UL:S is used /PA,/CH, and /AP did not work properly. 15. When /UL:L or /UL:S are used and /PA,/CH or /AP are used with under- lining in the title. The first page of output may have had spurious underlining. 16. If you had an extra right brace (}) in an equation RNO died with an internal error, instead of an illegal syntax error. 17. If you used /PA to suppress output pages before 256, page 256 would still be output. 18. Indirect command files did not work under IAS due to a bad overlay structure. 19. .ENABLE TOC and .DISABLE TOC would cause RNO to bomb. This was fixed in module STYLE by changing BIC and BIS to BICB and BISB. 20. .DISABLE TOC disabled tabs, and .DISABLE TAB disabled TOC. 21. /U:L did not work properly for RT-11 users. 22. Null literals may sometimes cause dynamic memory overflow. Bugs in Spring 84 version 1. .NO FLAGS ALL and .LITERAL would turn off flags which are in the page header. This causes incorrect titles, and subtitles. 2. The IASBLD.CMD file specifies STACK=64, which is way too small. This line has been deleted. When RNO was built under IAS a segment fault with stack overflow would result during execution. 3. A paragraph break that coincides with a page break can cause an extra line to be inserted before the page number for layouts other than 0. 4. Substitutions that occurr at a line break could cause spurious output and error messages. 5. Footnotes that are too long for the current page are incorrectly handled. 6. The widow and orphan preventions could cause spurious output when Footnotes are used. This is easily fixed by .SET PARAGRAPH ,,,0. Footnotes were split with intervening pages. 7. .LIST ELEMENT sometimes miscounted characters resulting in incorrect output. 8. The HSP,VSP attributes for escape sequences would not accept zero, contrary to the documentation. 9. The RT-11 version had a bug which caused an odd address trap on 11/73 but not on 11/23. The symbol TRCLN=17. in RNPRE.MAC was changed to Bonner Lab RUNOFF - Known bugs 4 Spring 84 TRCLN=18 to fix the problem. This fix was courtesy of Robert Wal- draven, of Univ. of California. 10. The RT-11 version had a bug which incorrectly handled dates for months after July. It rolled over to Jan this was naturally dis- covered in August. 11. The .HALF SPACING command caused a skip, rather than setting the number of half spaced lines. 12. The letter representation of number was incorrect past Z of (26). 13. If the very first header level had no level specified, an error mes- sage was given. Now the first .HEADER LEVEL command is assumed to start at level 1. Known bugs not currently solved. 1. .RESET SUBSTITUTE after .DEFINE NUMBER PAGE could cause a fatal er- ror. 2. .RESET INDEX with deferred pages containing index entries pending could cause a fatal error. 3. Any .RESET SUBSTITUTE inside a defined command will cause fatal er- rors. NOTE If you find any bugs I would appreciate getting a copy of both the .RNO and .DOC files containing these bugs. If you could isolate the bug and demonstrate it in just a few lines of input I would appre- ciate the effort. I will try to fix bad bugs or at least create a workaround. I do not guarantee anything.