____ ___ ___ ___ ___ ___ ___ ____ ___ ___ ___  / /__//_ /__ / //_ //__ / //_ / / / //_ //__//_   / / //__ ___//__//__/___//__// / /_/_// // \/__  ------------------------------------------------------------------------------ - FOR ABO'S CONTACT US AT: BP:28 1170 WATERMAEL-BOITSFORT 1 BELGIUM!!... ------------------------------------------------------------------------------ - DON'T SEND ANY DISKS - ------------------------------------------------------------------------------  THE LEGENDARY >> SUBSOFTWARE << IN 87/88/89/90/91!!...  ------------------------------------------------------ - MANUAL for QUED - --------------- QUED - the quick editor for the Amiga programmer Copyright CACHET 1988,89 all rights reserved CACHET, Ostendstr. 32, 7524 Oestringen, W.-Germany Tel. national 0725 322 411 Tel. international (49) 725 322 411 Telefax (49) 725 322 450 1. Introduction Qued is an Editor specially adapted to the needs of any software programmer (even a special function for "C" is included). Normal texts can also be edited, as long as no special word-processing functions are expected (such as boldface printing, pages and index managing, etc.) We had two aims in the developement of this software: speed and details that could make working with QuED simple and easy. As to the speed, the extremely fast cursor and the smooth scrolling should be pointed out. It was of our special interest that the scrolling should not only be fast, but also always readable (thanks to the special syncronization with the electron beam of the monitor). Secondly, it is much faster to look for a given text with our program than with many others. Many details were included to ease the use, and we would like to point out some of them: Working with different texts at the same time, the user can jump from one to the other with CTRL + Fn ( n = the corresponding function key). If, for example, you only want to make a quick change on one of the texts, you can do it and return to your work in just a moment. It is also possible to set up to 10 text marks on all the texts that can be jumped to using the F keys (and they can even be saved using a special file). If the user should ever forget what a special command means, or how to use it, a complete overview can always be recalled using the HELP key. Pressing any key you will find yourself at exactly the same place you left before pressing help. Another point of special interest for users with limited memory, is being able to almost always load and edit files when their size "should" allow them to still fit in. This works due to the special way the textlines are managed in the program. Qued is able to use "isolated" free memory space down to 16 bytes. Last but not least, we want to point out that the speed of the editor stays always the same during all functions, independently of the length of the text. 2. Starting the editor QuED can be started from the workbench. To start the program just doubleclick the icon. It can also be called up from CLI. To start the program, you only have to type "qed". We recommend to install QuED into the C- directory in your standart-boot disc. Starting the editor from CLI you can already choose the name of the files (max 10) you want to work with and the size of the tabulators. The complete syntax to recall QuED is: qed ((File- name1 (,tab1)), (Filename2(,tab2)),..., (Filename10(,tab10))). If you do not give any tab-size QuED uses a default value of 3 in normal cases, the same with ".c" files, and with ".asm"-files a default value of 8. After starting, QuED runs an autodetach routine which enables you to continue using CLI (from which it was called up), while working with QuED. It has the same effect as a "run qed" command without the autodetach routine. QuED always opens its own screen with a bit plane, that means, only two colours are at your dis- position. There are two possibilities: On the one hand the QuED default colours black/white, on the other hand your own two colours selected with preferences. 3.The basic use of QuED Important information on the text you are working with can always be seen in the status line. This is the inverse line on top of the screen. The message "QuED#n:" will appear in this line ("n" showing the number of the text you are just working with.) This is important if you are working at the same time with different texts. Behind this message we find the name of the text, which is also the filename when saving it. This text can disappear when other status messages are shown, or information from the user is asked. To get back to the normal form of the status line, you only have to press the HELP key twice. Behind a vertical line at the end of the status line you will always find the message "Line: L/aL|s". "L" shows the current line number, "aL" the sum of all lines in the text and "s" block position of the cursor at the time. Additional to the normal use of the keyboard, QuED features some special functions to make your work as easy as possible: Special use of the cursor-keys: Without any other key, each cursor key moves the cursor in the corresponding direction. It is important to know that the cursor stops at the beginning and at the end of each line, even if you keep the key pressed. To move it further, you will have to press the key again. This is to avoid that the fast cursor of QuED runs past the line before you can release the key (which we assume you do not want to happen). For the DEL and the BACK SPACE key the same function is found. SHIFT + cursor left or right, makes it jump to the start or the end of the current line. SHIFT + cursor up or down moves one page in the chosen direction. CTRL + cursor up or down moves you to the beginning or the end of the text. CTRL + cursor left or right moves the line by one tab into the corresponding direction, jumping then to the next line. To use this function, the cursor has to be at the beginning or one space in front of the line (otherwise it will not work). Using this function it is very easy to insert whole parts of texts. IMPORTANT: with cursor functions you cannot use any of the (A)AMIGA keys instead of the CTRL key (this combination is used to simulate the mouse) Another way of moving the cursor is using the mouse: click at any point of the screen and the cursor will jump to it. Keeping the left mouse button pressed and moving the pointer horizontally over the screen, the cursor will always follow it. Moving it vertically, the screen will scroll in the given direction. Clicking the right mouse button, the cursor will move up if the pointer is in the upper half of the screen, and down if it is in the lower. If the end of the screen is reached, it will beginn scrolling in the corresponding direction. Functions of RETURN and ENTER key: RETURN (without additional keys) inserts a new line and jumps to it without splitting the actual line. The cursor will appear behind the same amount of tabs it was standing on in the line before (the actual line it jumped from). Both lines will begin at the same left margin. ENTER (on the numerical key pad) has almost the same function as RETURN. The only difference is that the cursor appears on the left margin of the new line, instead of on the same tab of the one jumped from. Using the SHIFT key in combination with these two keys, every- thing standing behind the cursor will appear on the new line. The TAB key alone does not insert a new tabulator, but only jumps to the next one. Only after the end of the line, tabulators will be inserted. With SHIFT + TAB you can jump back to the next tab in front of the cursor position. The function keys are used by QuED for different purposes: Pressing a function key with SHIFT, a corresponding mark in the current text position is inserted. Without SHIFT you can jump to all marks inserted that way. F9 and F10 are also used as marks for the beginning and the end of the block where the different functions can be used (see below). If a block is marked (this means, mark F9 and F10 exist, and F9 stands before F10) it will be shown inverse (white on black). Marks only define the lines, and not the actual cursor position. This is the reason why, when jumping with text marks, the cursor will always appear at the beginning of the line. Only when both marks (F9 and F10) stand in the same line is the cursor position considered. This makes it possible to work with parts of lines using block commands (see below). Pressing CTRL or (AMIGA) and F10, a new text is opened, if you are not already working with 10 different texts, in which you can work with a text independently from all the others. The different texts can easily be identified by the text number and the text name on the status line, as explained before. Different texts can easily be reached by pressing CTRL or (AMIGA) and the F key corresponding to the number of the text you want to work with. If you have 10 texts, the combination CTRL/+ can also be used for this. If you are working in another screen, and want to return to QuED as quick as possible, you do not have to click back that screen and activate QuED: by only pressing CTRL + ESC you will find yourself back in the editor. The same works if you want to return from QuED to the last screen you used. Pressing the HELP key a corresponding screen appears, in which a list of all possible function keys and their functions are shown (see below). By p ressing any key you will find yourself again in the same place before leaving your text. 4. Functions of QuED All functions are called pressing CTRL or (AMIGA) key in combination with others. More input is needed with some of them. In this case, it has to be typed into the status line. This is the case when a corresponding message appears black on white (not inverse) on the beginning of the status line. Following are the rules for this kind of input: - Input of numbers have to be followed by RETURN - If you press RETURN before entering a number (on numerical input) it will quit the input. - You can quit all input (numbers or letters) by pressing the ESC key. Explanation of each function: CTRL or (AMIGA) and: - ASCII input: the ASCII value of the sign below the cursor is shown and can be changed. This is important, for example, for special signs for the printer. B: - Block commands: when a block is marked with F9 and F10 (SEE 3.)different functions can be selected over the status line. Following functions marked with a star ("*") have an effect on the whole line, even if only a part of it was marked: Copy: copies the marked block to the current cursor position . Kill: destroys (erases) the marked block. If it is longer than a line, QuED asks for a confirmation of the command. *Replace: executes the replace function over the marked block (see below) *Save: saves the marked block. The corresponding filename is entered over the file-menu-box (see 5.) Parts of texts can also be printed with this function. (see 5.) *Transfer: transfers the marked block to another text that you are working with. The number of this text is also entered in the status line. Unmark: clears marks F9 and F10, by which no block in the text is marked any more. C: - Toggle colors: changes QuED standard colors to the ones selected by you in preferences, and back if already selected. E: - Exchange: changes the sign the cursor is on, with the one to the right of it. This helps to easily correct an often commited mistake. F: - Show free memory: shows the amount of free chip- and fastmemory. G: - Go on: repeats the last search- or replace-function (see below), which is specially usefull when you need to find a word many times in a text. J: - Jump line #: the cursor jumps to the line number entered over the status line. K: Kill line: kills (erases) the line the cursor is on. The line is kept in a special buffer, and is therefore not lost. You can insert this line from there as often as wished into any text. L: Put line: inserts the line in the buffer again into the text. Both functions "K" and "L" are especially useful to copy individual lines in a text. M: Merge file: loads a new file from disk and inserts it beginning at the cursor position. The name of the file to load is entered over the choose-files-box. N: Name & save: Saves the current text under a new name. The name is entered over the choose-name-box (see 5.). This function can also be used to print the whole text. O: - Open file: loads a new text. If you have not saved the text since the last change, QuED will ask you to confirm this command. The content of the file is lost when loading the new file. The filename is also entered over the file-menu-box (see 5.) Q: - Quit: Quit the editor. If you are working with other texts, the next text appears. If you have not saved the current text since the last change, QuED asks you to confirm your command. R: - Replace: searches (S) or searches and replaces (R) a word. S: - Srch: the word to be searched is entered over a requester. This word can contain a question mark ("?") as a joker. This joker stands for any sign, and you can use as many as you want. There is also a gadget in the requester to select whether QuED should ignore capital letters or not. If the word to replace has any jokers, they will be replaced by the corresponding letters of the searched word. This is difficult to explain, but we recommend to try it out and see the results by yourself. T: - Top/Bottom: the cursor jumps to the beginning of the text. If it is already there, it jumps to the end. U: - Undo: All changes on the current line are undone. V: - C-Verify: executes a simple test for typical C-mistakes. C-parenthesis ()<> are tested the following way: QuED searches for the next parenthesis and executes the test from this to the corresponding closing parenthesis. It finds out if there are too many, if parenthesis or ("/`) remain open, or similar mistakes that easily show where parenthesis have been forgotten. After the function the cursor stops either where a mistake was found, or after the corresponding closing parenthesis. W: - Write: saves the current text under the actual name. In special cases (for security reasons) QuED asks you to enter this name into the file-menu-box. In this case the function is completely identical with N-Name&Save. X: - Kill to BOL: clears all signs in the current line that are in front of the cursor. Y: - Kill to EOL: clears everything in the current line from the cursor position on. Z: - Zap buffer: clears the actual text, so that a new one can be started. If the current text has not been saved since the last change, QuED asks you to confirm this. SHIFT: changes from small to capital letters. TAB: asks you to enter the new tabsize into the status line. In the 2.0 (and later) versions. it does not change anything on the already existing text, but only on the one to come. ESC: changes to the last window used before QuED, if it still exists. The corresponding screen is brought in front. Pressing CTRL + ESC when QuED is not activ, (you are using another utilitz), the screen QuED is taken to the front and activated. You can immediatly continue editing. (IMPORTANT: for this function only the CTRL key can be used, and not the AMIGA key.) If you now press CTRL / A (AMIGA) + ESC you will return to the utility you were using before working with QuED. 5.Use of the file-menu-box Next to the simple way of selecting menu and index by clicking gadgets in the file-menu-box, there are some interesting details: - Instead of clicking a file in the index and then clicking OK, you can reach the same effect by clicking twice on the filename. - Once you have read the whole index, (you waited and did not immediately select the wanted file) it will not be read again, but always appear immediately when requested (as long as you are not using another index from the file-menu-box!) You can select the following three gadgets on all memory calls of the file-menu-box: PRT:, PAR: and SER:. By this way you can get an output of the text or of parts of it (printed or not). - The XTRA - gadget is used to find out if an extra file (.QuED) containing tab size and position of the selected Fn tabs, should be saved with the text. The default value is NOT to save it. - The TAB gadget finds out during the saving process, if the spaces can be changed to tab values to save memory. While loading it is used to find out if the tab-selection comes from an extra-(.qed)file or if the current selection should be kept. If this gadget is on, but no ".qed" file is found, standard values of 3 (for ".c"files) and 8 (for ".asm" files) are selected. Mathias Kegelmann and the complete CACHET Software team wish you happy programming with QuED- the quick editor. Update service: New versions of QuED CACHET, Ostendstr. 32, 7524 Östringen, West-Germany Telephone: (49) 725 322 411 Telefax (49) 725 322 450 This manual Copyright (C) CACHET 1988. All rights reserved. This document may not, in whole or in part, be copied, photocopied, reproduced, translated, or rediced to any electronic medium or machine readable form without prior consent, in writing, from CACHET. This software Copyright (C) CACHET, 1988. All Rights Reserved. This product is intended for the use of the original purchaser only. Transfer of licence is only by written permission of CACHET. Duplications for the purpose of backups is allowed, but duplication for the purpose of selling or otherwise distributing this product is a violation of the law.