Club Amiga de Montreal

home *** CD-ROM | disk | FTP | other *** search

/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 160.lha / Manual < prev next >

Wrap

Text File | 1988-04-27 | 20.4 KB | 449 lines

Welcome to TextED!! Congratulations! You have just purchased the most powerfull text editor made for the Amiga! TextED is a text editor that can be used by the casual user and by the advanced programmer. MKSoft TextED is based on the powerfull Unix text editor known as EMACS so most of the keyboard commands will be the same. This file contains a quick manual describing the features of MKSoft TextED. Please expand this window to full size and read on.... ----------------------------------------------------------------------------- ----------------------------------------------------------------------------- MKSoft TextED -- Copyright (c) 1986 by Michael Sinz -- MKSoft ----------------------------------------------------------------------------- ----------------------------------------------------------------------------- Changes to TextED -- Amiga Version 2.8 1. The word-wrap function is debugged and installed in the menus. This function only word-wraps on input. TextED is not designed as a word processor but rather a text processor, mainly for program source code. This feature was added for typing of large comments. 2. Some of the routines have been optimized. Many are now much smaller or work faster. (Sometimes both) 3. Now will open to FULL SCREEN on an INTERLACE workbench! 4. Better menu handling. You can't flood it anymore. 5. Longer maximum line length. 6. Longer MACRO buffer. 7. Completely recompiled with AZTEC C for smaller/faster code 8. Does not bring up the CREDITS screen at the start of the program. I have changed this so that TextED is faster to use from the CLI. You now do not have to use the mouse to CONTINUE from that point. It has been moved to a menu item. 9. All new FILE REQUESTER. This one gives you a list of files in alphabetical order with directories at the top. Complete with PROP gadget. Simple to use. Click on directory and it loads the new directory. Click on a file and it puts that file name in the FILE gadget. Click on OK and it uses the name in the file gadget. You can also enter the path and file names directly into the gadgets. 10. Fixed bug with FRIENDLY TOOL icons. When starting TEXTED by selecting a TextED Project icon or shift-collecting a text file and the TextED program, the file and the program do not have to be in the same directory or device. This one was found using the AZTEC debugger that comes with the compiler. Highly recommended! 11. All features work with FAST RAM installed. No more problems with CHIP memory graphics. 12. Faster loading of files. Sorry, but the clearing of a large buffer still takes some time since it also deallocates the memory for that buffer at the same time. (Allocated on a LINE by LINE basis.) 13. Does not bomb out it the workbench font is set differently. It will always reopen TOPAZ.8 as the TextED Font. Only the window title and top of menu bar will be in the workbench font. Changes to TextED -- Amiga Version 2.9 14. Sets its priority to 1 so that background compiling does not slow down the interactive aspects of TextED. Since most of the time TextED is waiting for user input, this setting does not slow down the compile by any large amount. 15. Increased the display speed by optimizing one of the routines. I hope it is fully debugged. (Seems like it is, but there might be a few small anoiances. (Interlace mode, most likely) Changes to TextED -- Amiga Version 2.9a 1. Recompiled under Manx 3.4b for scatter loading... Slightly larger file, but it now loads into a highly fragmented memory space. Also the run-time image is smaller and runs faster... 2. Fixed the exit code so that it returns the task to initial priority level. This one was easy to fix, but I had a hard time trying to find out why my task sometimes went to priority 1. Finally found out that TextED was leaving it there when it finished... ----------------------------------------------------------------------------- ----------------------------------------------------------------------------- MKSoft TextED -- Copyright (c) 1986 by Michael Sinz -- MKSoft ----------------------------------------------------------------------------- ----------------------------------------------------------------------------- 1. Introduction TextED is an advanced text editor that was designed for the Amiga computer system. It makes use of dynamic memory allocation so that it will only take as much memory as it needs for the files that it is editing. This means that you will have more memory available for other programs which might be running at the same time in your Amiga's multi-tasking OS. And, as your file gets larger, TextED will not tell you "BUFFER FULL" unless you have no more memory in the whole computer. (0 bytes free at the top of the WorkBench display.) So, if you have a 8 megabyte Amiga system, you would be able to edit a file that large! TextED knows if you are running from the WorkBench or the CLI and will act accordingly. That means that when you use TextED from the WorkBench, it will save your files and attach an ICON to them. But, for the advanced user who uses TextED from the CLI, it will not make an ICON for the files it saves. This reduces the clutter on the disk for the advanced user while still giving the WorkBench user the ICONs he wishes. For the programmer, TextED features auto-indent and true tabs. This reduces the time it takes to keyboard a program with indentation since TextED will automatically indent the next line the same as the line before. Also, the tabs are stored as tabs and act as tabs which makes the files smaller and, for you assembly programmers, the changing of the program much faster. While TextED is not a wordprocessor, it does have a word-wrap option. This document was created with TextED. TextED has full menu support for all but the most basic functions such as cursor movement. TextED also has a full help system that is available at the touch of the HELP key. And, for you mouse lovers, the cursor can be positioned with the mouse. TextED, like the Unix EMACS editor, lets you edit multiple files at the same time. You can even cut and paste between files. There is no real limit on the number of files that can be edited at the same time other than memory limits, however, the number of "windows" or files visible at a time is limited by the size of this window. Also, you can have two different views of the same file without having to load the file twice! This makes debugging much easier since you can look back in the code without loosing your place. ----------------------------------------------------------------------------- 2. The display... The TextED window is like any other window that you will use on the Amiga. You can size it, drag it, or shuffle it. It will respond to your every command. It is in this window that TextED lives. The bottom line of the display is used to give you messages and ask for special input such as a search string or file name. The rest of the display is used by TextED to display its windows. These windows are not like the other Amiga windows in that they are part of the TextED window. These windows are "views" into the file or files you are editing. The windows are separated by a status line which gives you the following information: « » buffername --» filename «----------------------------------------------- ^ ^ ^ | | | | | This is the name of the file being edited. | | | This is the name of the TextED buffer the file is in. | This is the status of the buffer. If blank, the buffer is unchanged from what is in the file on disk. If it has a C in it, the buffer has some changes and should be saved if you do not want to loose your work. When you split the screen, you get another view into the buffer you were working on. You can then either work with that buffer or select a new buffer and edit a different file in there. Try splitting the screen by using the menu or by pressing Shift-F2 (the 2 is for make 2 views). You can the make a view get larger (F1) or smaller (F2) or split it again or make the current view the only one (Shift-F1). Thus, with a full sized TextED window, you could have up to 11 different views on the screen at once! The CLOSE WINDOW gadget in the TextED window does not only quit TextED but also saves the current buffer if it has changed. (It is the same as pressing F10 or ctrl-Z) This is to protect you from any loss of text. (see the section on file i/o for more information on SAVE & EXIT) To move the cursor in the TextED window, you can use the mouse by pointing to the position you wish to move to or you can use the keyboard arrow keys. Using the arrow keys without the Shift key moves the cursor one character in the direction of the arrow. However, with the shift key held down while the arrow key is pressed, the cursor will move to the beginning or end of the line (Shift-Left and Shift-Right) or to the previous or next screen page (Shift-Up and Shift-Down). Using CTRL and Shift makes the cursor move to the previous or next word (CTRL-Shift-Left and CTRL-Shift-Right) or to the beginning or end of the file (CTRL-Shift-Up and CTRL-Shift-Down) This gives you complete control of the cursor. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ NOTE: Due to a bug in the Amiga Console Device, these are the only functions of the cursor keys. When the bug is fixed, the keys will have the following functions: (Note: Version 1.2 Fixes this bug...) Key | Plain | Shift | CTRL | CTRL-Shift --------|------------|------------|-----------|------------ Left | Move one | Beginning | Previous | Previous Arrow | character | of line | word | window --------|------------|------------|-----------|------------ Right | Move one | End of | Next | Next Arrow | character | line | word | window --------|------------|------------|-----------|------------ Up | Move one | Previous | Beginning | Scroll Arrow | line up | page | of file | Up --------|------------|------------|-----------|------------ Down | Move one | Next | End of | Scroll Arrow | line down | page | file | Down --------|------------|------------|-----------|------------ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ----------------------------------------------------------------------------- 3. Files and buffers... TextED uses a method of storing files in memory while they are being edited that facilitates the editing of unlimited number of files. To keep track of all of this, the files are stored in buffers that are many times the same name as the file. (Unless you asked differently) While you are editing inside one buffer, the other buffer remains unchanged. TextED even remembers where your cursor was when you left last. Each buffer also stores the name of the file that it is holding. This information is displayed in the status line while you are working with that buffer. To edit a file, you just have to enter into TextED (run it or double click it from the WorkBench) and then ask to read a file into a buffer. There are two different versions of this command. The first version reads the file into a new buffer. That is, it creates a buffer different from the ones that you have already and then loads the file into it. (This command is F8 or ^X^V) The second version reads the file into the current buffer. This command destroys what was in that buffer and replaces it with the file. Use this command to prevent having all of the files you are editing at one sitting from staying in memory. (This is Shift-F8 or ^V^R) When you want to save the buffer, you again have two choices. The first saves the buffer into the file which is shown in the status line. The second lets you enter the name of the file into which the buffer is to be saved. (These are F9 and Shift-F9 respectively) When you wish to exit TextED, you can either Exit without saving the buffer or Exit after saving the buffer. Only the current buffer is saved. If there are any buffers that have been modified and not saved, TextED will ask you if you are sure you would like to quit. If you answer NO, you will be in TextED as if you never left. You can then save the buffers you want saved and then exit. (The SAVE & EXIT command is F10 or the CLOSE WINDOW gadget.) ----------------------------------------------------------------------------- 4. Cut and Paste -- EMACS style. TextED lets you cut and paste between buffers so that you can get data from one file into another. However, TextED uses the EMACS method of Cut and Paste. Here is a quick lesson on how to use these functions. In TextED, the section of the buffer you are going to Cut or Copy is called the REGION. The region is defined as the section of the buffer between the MARK and the DOT (the DOT is another name for the CURSOR) The MARK is a position in the buffer that you set. To set the MARK, move the cursor to the position and press F6 (or use the menu). Then move the cursor to the other end of the section of text. To cut the text, press Shift-F7 (or, again, use the menu). To paste this text, press Shift-F6. You can move to a different buffer and paste the text again. You can paste the text as many times as you want as long as you do not clear the paste buffer. (The paste command is known as YANK in the EMACS world.) The only other command that uses the paste buffer is ctrl-K (kill to end of line) or multiple deletes (Using the repeat command operator ctrl-U) The MARK is also useful for remembering a position while you go off and look at another area of the file. You can then return to that position by using the SWAP DOT and MARK command. (F7) This command will place the cursor where the MARK was and place the MARK where the cursor was. This lets you flop back and forth between two different areas of the file. (A useful function for programmers.) 5. Searching and Search & Replace TextED lets you search through the file for any type of string. You can search foreward (F3) or reverse from the current cursor position. If you would like to search for the third time the search string is found, use the repeat command operator. (See the next section.) The search and replace function (Shift-F3) is somewhat like the search command. However, it can only work forewards. It will search for the search string and replace it with the replacement string. It will only do this once, but if you would like to do the whole file, just enter a large number with the repeat command operator. (See next section.) NOTE: Both search and search & replace ignore case. ----------------------------------------------------------------------------- 6. Repeating a command many times... Now this one is useful! This is a pre-command sequence that will force the next command to be repeated as many times as asked for. This command can be used to get to a specific line or to search & replace over the entire file. To use this command, type ctrl-U (or use the menu) and then the number of times you wish to repeat the command. Use only numbers and do not try to BACKSPACE since this will BACKSPACE that many times. If you make a mistake, press ctrl-G. (Abort from the menu) After you finished typing the number, type the command you wish to repeat (or use the menu). DO NOT PRESS RETURN AFTER TYPING THE NUMBER. That would only repeat the return key. For example, if you wish to get to line 233 of your file, go to the top of the file and type the following: <ctrl-U> <2> <3> <2> <down arrow> The reason you entered only 232 is that you are on line one when you started so you only have 232 lines to go. This is great for finding the lines with a compiler error. To search & replace all (or most) of the buffer, you should type: <ctrl-U> <9> <9> <9> <9> <9> <9> <Shift-F3> and the search and replacement strings. That should get most (if not all) of them. (If you have more that 999,999 of the string, type a larger number. You can type up to 1,999,999,999 (without the comas) since the program uses a 32-bit integer. However, anything over that amount could cause problems.) ----------------------------------------------------------------------------- 7. The MACRO function... TextED has a simple macro function. (Future versions of TextED will have an advanced MACRO language) The MACRO function lets you record your keystrokes and then replay them when you want. (It also works with the menus) The MACRO may contain any command but the MACRO commands themselves. Thus you can make a MACRO that reformats your text. (That one is neat!) To make a macro, you must tell TextED to start recording your keystrokes. This is done with Shift-F4. When you have finished making you macro, you tell TextED by pressing Shift-F5. Then, you can execute your macro by pressing F4. (Again, you can use the MENUs for all of this.) The macro may contain anything, including text or editing functions or even cut & paste commands. ----------------------------------------------------------------------------- 8. Command Summary Keys Description Amiga Keyboard ------------ ----------- -------------- ctrl-@ Set MARK <F6> ctrl-A Go to beginning of line <Shift-Left> ctrl-B Left <Left> ctrl-C Start a new CLI task ctrl-D Delete next character <DEL> ctrl-E Go to end of line <Shift-Right> ctrl-F Right <Right> ctrl-G Abort command (See note) ctrl-H Backspace <BACKSPACE> ctrl-I Tab <TAB> ctrl-J New line without auto-indent <ENTER> ctrl-K Delete to end of line ctrl-L Repaint the whole screen ctrl-M New line with auto-indent <RETURN> ctrl-N DOWN -- Next line <Down> ctrl-O Open line at cursor ctrl-P UP -- Previous line <Up> ctrl-Q Quote next keystroke ctrl-R Reverse search ctrl-S Foreward search. <F3> ctrl-T Twiddle characters ctrl-U set repeat command ctrl-V Go to next page. <Shift-Down> ctrl-W Cut region. <Shift-F7> ctrl-X This is the leadin for other commands ctrl-Y Paste (Yank) region back <Shift-F6> ctrl-Z Save and Exit <F10> <HELP> Help on these commands <HELP> ----------------------------------------------------------------------------- These commands are all started with typing ctrl-X and then the command listed (Amiga Keyboard shortcuts do not need the ctrl-X) Keys Description Amiga Keyboard ------------ ----------- -------------- ctrl-B List the buffers ctrl-C Exit without save <Shift-F10> ctrl-F Rename the file in the buffer ctrl-L Set region to lower case ctrl-N Scroll up ctrl-O Delete blanks ctrl-P Scroll down ctrl-R Load into current buffer <Shift-F8> ctrl-S Save buffer to file <F9> ctrl-U Set region to upper case ctrl-V Load into new buffer <F8> ctrl-W Save to new file <Shift-F9> ctrl-X Swap DOT and MARK <F7> ctrl-Z Shrink window <F2> ! Execute a CLI command = Show cursor position and status. <F5> ( Start MACRO <Shift-F4> ) End MACRO <Shift-F5> 1 Set current window to full size. <Shift-F1> 2 Split current window <Shift-F2> B Select a buffer to view E Execute the MACRO <F4> F Set Wrap Column K Kill a buffer N Next window P Previous window Z Enlarge current window <F1> ctr-X <HELP> Displays this list of commands ----------------------------------------------------------------------------- These commands are all started with typing <ESC> and then the command listed (Amiga Keyboard shortcuts do not need the <ESC>) Keys Description Amiga Keyboard ------------ ----------- -------------- ctrl-H Delete previous word <Shift-BACKSPACE> ! Set cursor position as Top of Window . Set MARK <F6> > Go to end of file <Ctrl-Shift-Down> < Go to beginning of file. <Ctrl-Shift-Up> B Move backward one word <Ctrl-Shift-Left> C Capitalize word D Delete next word <Shift-DEL> F Move foreward one word <Ctrl-Shift-Right> L Set word to lower case S Search & Replace <Shift-F3> U Set word to UPPER CASE V Move backward one page <Shift-Up> W Copy region ----------------------------------------------------------------------------- NOTE: The ABORT command (ctrl-G) is used to abort any command that requires keyboard input such as the SEARCH command or SELECT BUFFER command. -----------------------------------------------------------------------------