Introduction to using tecoc Evocation --------- As stated in BUILD.txt, tecoc can either be executed directly, or a file link can be created, or a batch file or shell script can be created. For example, if you want to edit a file name MyFile.txt, if you have a link setup like: teco -> tecoc then you could execute: teco MyFile.txt However, if you want to run tecoc directly, you'd have to do: tecoc teco MyFile.txt The extra, and first, argument, "teco", tells tecoc what mode to run under. The remainder of this document will assume you have the link setup. If you have video mode configured, tecoc nevertheless starts in non-video mode by default. To start tecoc in video mode you could do: teco -scroll:5 MyFile.txt This would make the bottom 5 lines used for commands, and the remaining lines above to be the video display area. Additionally, video mode can be turned on or off while editing a file, regardless of the startup parameters. See "video.txt" Importantly, the command to save the file and exit is: EX followed by two escape key presses To exit the edit session without saving, do: -1EX followed by two escape key presses Commands -------- Teco is a character based editor. This means that teco keeps track of what character you are at, and not what line you are on. One normally edits a file by positioning the point and editing there. The "$" character functions as the "escape key". A single $ is used to separate multiple commands. Two consecutive escapes, $$, cause teco to execute all of the commands up to that point. Other characters, besides $, each have a meaning to teco. Some commands consist of more than one character. Teco commands are case-insensitive. This means that "m" and "M" mean the same thing. In this text I will show the commands in uppercase simply to avoid confusion between such letters as ell and one. For example, the "L" command causes teco to move its pointer to the following line. If you type "L", nothing happens until you tell teco to execute is by following the "L" with "$$". So, L$$ will cause teco to go to the next line. You may have any number of commands specified before executing them, for example: LLL$$ will go down three lines. Also, commands may take numeric arguments. For example, 3L$$ will go down 3 lines. Commands may also be negative, so the following: -4L$$ will cause teco to go up 4 lines. Also, since the default argument is one, -L$$ is the same as -1L$$ In video mode, you will see the changes occur as soon as you execute $$. In non-video mode, you see nothing unless you ask teco to display a portion of the text. For example, if you type: V$$ you will see the line you are on. The current character position is always available vie the "." command. There is also the "=" command that causes teco to display a value, thus: .=$$ causes teco to display the current character position. Teco has many, many powerful commands. It has loops, conditionals, variables, etc.. Each letter has a different function. See the included documentation. Macros ------ A series of commands, since they are only letters, may be entered into a text file. A user may tell teco to read and execute the commands in one of those files. The name associated to that set of commands is the name of the file they are located in (minus the .tec extension). The command used to execute a macro file is "EI", thus, for example, if you have a macro file named "ab.tec" located in the TEC_LIBRARY directory, executing: EIab$$ will cause teco to execute the commands located in that file. In this example, the command is "EI". It takes a trailing string argument "ab", and the "$$" means execute it. Moving On --------- To learn more, I suggest you read the following, included, documents in the order shown: Summary.pdf blake-notes.txt teco-manual.txt wchart.txt Many of the other documentation files are either historical or provide greater, tecoc specific, information.