diff --git a/1991/ant/README.md b/1991/ant/README.md index 2aad15235..67d2ff114 100644 --- a/1991/ant/README.md +++ b/1991/ant/README.md @@ -1,26 +1,32 @@ # Best Utility: - Anthony C Howe - Mortice Kern Systems Inc. #CL-23 - 35 King St. N 268 Phillip St. - Waterloo, On Waterloo, On - Canada, N2J 2W9 Canada, N2L 6G9 +Anthony C Howe +Mortice Kern Systems Inc. #CL-23 +35 King St. N 268 Phillip St. +Waterloo, On Waterloo, On +Canada, N2J 2W9 Canada, N2L 6G9 ## To build: - make all +```sh +make all +``` ## To run: - ./ant some_file +```sh +./ant some_file +``` NOTE: the file must already exist and not specifying any arg will make the program exit without doing anything. ## Try: - cp README.md hill - ./ant hill +```sh +cp README.md hill +./ant hill +``` ## Judges' comments: @@ -42,64 +48,59 @@ commands section for other commands. Ant's Editor vIOCCC91 -Text files consists of lines of printable text or tab characters. -A line can be of arbitrary length and is delimited by either a -newline or the end of file. Carriage return is mapped to newline -on input and ignored on output. Tab stops are every eight columns. -Non-printable characters may have unpredictable results depending -on the implementation of CURSES. +Text files consists of lines of printable text or tab characters. A line can be +of arbitrary length and is delimited by either a newline or the end of file. +Carriage return is mapped to newline on input and ignored on output. Tab stops +are every eight columns. Non-printable characters may have unpredictable +results depending on the implementation of `curses`. ### COMMANDS: - h j k l left, down, up, right cursor movement - H J K L word left, page down, page up, word right - [ ] beginning and end of line - t b top and bottom of file - i enter insert mode, formfeed to quit - x delete character under the cursor - W write buffer to file - R refresh the screen - Q quit +- h j k l left, down, up, right cursor movement +- H J K L word left, page down, page up, word right +- [ ] beginning and end of line +- t b top and bottom of file +- i enter insert mode, form-feed to quit +- x delete character under the cursor +- W write buffer to file +- R refresh the screen +- Q quit ### EXIT STATUS: - 0 success - 2 missing edit filename +- 0 success +- 2 missing edit filename ### ABOUT THIS ENTRY: -The BUF size should be set at compile time to 32767. This value -was used because the Sozobon C compiler for the Atari ST has 16 -bit ints and a limit on the size of arrays & structures of 32k. -Also the WatCom C compiler for the PC also has 16 bits ints. On -machines that have 32 bit ints (most unix boxes), a larger value -for BUF could be used. +The BUF size should be set at compile time to 32767. This value was used +because the Sozobon C compiler for the Atari ST has 16 bit ints and a limit on +the size of arrays & structures of 32k. Also the WatCom C compiler for the PC +also has 16 bits ints. On machines that have 32 bit ints (most unix boxes), a +larger value for BUF could be used. -It is recommend that compact memory model be used on PC class -machines. Small memory model may work too provided BUF is not -too large. +It is recommend that compact memory model be used on PC class machines. Small +memory model may work too provided BUF is not too large. -The character constants '\b', '\f', '\n', '\r', '\t' are used -in order to provide more portable code, since the compiler should -handle the translation of them into the native character set. -Note that '\f' (formfeed) was used to exit insert mode because -K&R C had no escape constant for the escape-key. +The character constants `'\b'`, `'\f'`, `'\n'`, `'\r'`, `'\t'` are used in order +to provide more portable code, since the compiler should handle the translation +of them into the native character set. Note that `'\f'` (form-feed) was used to +exit insert mode because K&R C had no escape constant for the escape-key. My goals for this project were to learn and experiment with the Buffer Gap Scheme [Fin80][net90], write a useful and *portable* -programme, and meet the requirements of the IOCCC. I initially -planned to have a mini CURSES built-in like the IOCCC Tetris entry +program, and meet the requirements of the IOCCC. I initially +planned to have a mini `curses` built-in like the IOCCC Tetris entry from a previous year, however this was not as portable as using a -CURSES library with TERMINFO/TERMCAP support. +`curses` library with `TERMINFO`/`TERMCAP` support. -I plan to post followups such as unobfuscated versions and bugs -fixes to comp.editors. Reposts of the editor.101, gap.doc, and -editor.102 can be found in the same group every so often. +I plan to post follow-ups such as unobfuscated versions and bugs fixes to +comp.editors. Reposts of the editor.101, gap.doc, and editor.102 can be found +in the same group every so often. -This entry will display a file with long lines, but has trouble -scrolling the screen with long lines. Paging up and down should -work correctly, however. +This entry will display a file with long lines, but has trouble scrolling the +screen with long lines. Paging up and down should work correctly, however. ### REFERENCES: