EDGE V1.70 ========== HELP ---- This section will tell you how to use the AmigaGuide Help for Edge. AmigaGuide is a "hypertext" program to let you jump back and forth at random in a text file. You may read things sequentially, or you may browse in any subject you care to, and return to where you left off immediately. Simply click on any words that looks like a gadget, and you will jump to the place that explains the subject related to that word. If you double-click on ANY word that happens to be represented by a "hypertext node", then AmigaGuide will jump you there. If there is no word listed, the screen will flash and a "can't find" message will appear. Try clicking on requesters or double clicking on the word; "requesters", and you will see the results are the same. There are headings in the help window to let you return to the table of contents or jump back (Retrace) step by step to where you have been already. At any time you may simply "Browse" forward or backward through the file. When Edge is open, you may press the Help key at any time, and the Amiga Guide Help file will open to the area that will explain the relevant subject. For instance, if a requester is open, and you need help in deciding how to answer it, press help and the explanation of that requester will appear in the window. You may of course use the hypertext capabilities to jump around once you are in the Edge Help file. The help system is asynchronous, which means that you can have it running and still use the editor. To return to the Edge program to take up where you left off, simply activate the window you were working with. General Conventions and Syntax ------------------------------ The Edge Window Status Line Once the Edge Window opens, it displays a status information line which may be on the top or bottom of the window depending on the GlobalEnvFlags flag in GlobalEnvVars, accessable in WindowSettings. The information line contains, from left to right: Line number L:2 means Line number 2. Column number C:4 means Column number 4. Letter I or O I=Insert typing mode; O=Overstrike typing mode. Immediately next to I or O is a letter or a blank to tell whether the numeric keypad cursor keys are active or not. K=ON; blank=OFF The decimal ASCII character code of the character under the cursor. For example: 77 = decimal character code for "M" Number of Lines #L:40 is a 40 line file File size (bytes) Size:714 means a file size of 714 bytes Number of changes Chng:9 means you have made 9 changes to the file since opening/last saving it Page number Pg:1 means you are on page 1 of the document Page Line number PLn:5 means you are on line 5 of the current page The format of the status line is defined in the MiscTexts: section in the Text configuration file. At the lower right hand corner is a size gadget. Click, hold, and drag to resize the window. General Syntax and Conventions of Edge -------------------------------------- Edge has a number of equivalent actions that you may perform to select a checkbox, or activate a string gadget, or perform a menu function. If You Previously Assigned Edge: If you happen to have made an assignment of Edge: to some path or other, it will change the name shown in the Edge window to Edge2. It will also change the name of the ARexx port(s) of Edge and its windows. Generally it will append a "2" to the end of all named objects to do with Edge. If Edge2 also exists a "3" will be appended; if Edge3 exists a "4" is appended, etc. Menus ----- Menus are activated by clicking the Right Mouse Button (RMB) and holding it down. The Menu Bar at the top of the window will activate and names will appear. To select one of the Items under a Menu name, continue to hold down the RMB and move the pointer until the item or subitem you wish to activate is highlighted. The Item function is performed if you let go of the RMB while that item is highlighted. Certain menu items will have a "Command Equivalent" to the right of the item name. To use this "Keyboard Equivalent" of the menu, press the Right Amiga Key along with the keyboard character shown in the menu item. For instance, in a "Project" Menu, if you wish to Open a file, you may use the menu or press the Right Amiga key and the "o" key together. Now - to include a file by keyboard command you press the Right Amiga key together with any Shift key and the "o" key. In Edge, unlike most Amiga programs, if a menu shortcut key is displayed in upper case you must also press shift since Edge normaly distinguishes shifted and unshifted command keys. NOTE: caps lock will not do. Keyboard Equivalents -------------------- The Right Amiga key is called a "Qualifier" to the "o" key, above. All menu equivalents are qualified by the Right Amiga key. In the Help file, a "Qualified" key press is indicated by [Right Amiga] [O] A simple key press looks like [O] or "O", but in either case only the O key is pressed. Underlined Characters in the Gadget or Checkbox Name In general, all requesters EXCEPT the file requester will have one character in each gadget or checkbox name UNDERLINED. If you wish to activate that gadget or to toggle that checkbox ON or OFF, you may simply press the keyboard character that you see underlined in the gadget name. In the Help file: "Keyboard select: 'm'" means that you may SELECT the gadget or the checkbox or the string gadget by simply pressing the key for M (shifted or unshifted) because the gadget name has an underlined character 'm' in it. "Keyboard equivalent: [Right Amiga] [O]" means that pressing the key or keys shown together will PERFORM A FUNCTION. In string gadgets, to cycle forwards, press the "Tab" key. "Shift-Tab" cycles backwards. Mouse clicks inside string gadgets activate them with a cursor visible inside, or press the underlined character on the keyboard. If the gadget is active, pressing the underlined character will ENTER that character into the gadget. ARexx Every action you can do from the Edge interface has an equivalent ARexx Command. Look at Commands for more information. Starting Edge. -------------- This section will tell you how to start Edge, either from Shell or from Workbench, and what arguments you can supply. Starting Edge from the Workbench To start Edge from Workbench just double click on the Edge tool icon or select and double click the Edge project-file(s) you want to load. The Edge tool icon tooltypes are: Dictionary Filename of the default dictionary file, defaults to EdgePrg:Edge.dictionary Dormant Flag to specify that Edge is to start up in iconified state. If any files are to be loaded this flag is ignored. Force Flag to specify that you wish to start a new copy of edge and not create new files in the one copy already loaded. obviously this flag only has a meaning if you have Edge already running in memory and wish to start another. Global Filename of the global settings preference file, defaults to EdgePrg:Edge.global Icon Filename of the icon to use as project icon (not including .info, which is added automatically), defaults to EdgePrg:Edge.icon.info Keyboard Filename of the keyboard config file, defaults to EdgePrg:Edge.keyboard Local Filename of the local settings preference file, defaults to EdgePrg:Edge.local Menus Filename of the menu config file, defaults to EdgePrg:Edge.menus MouseButtons Filename of the mouse button config file, defaults to EdgePrg:Edge.mousebuttons PubScreen The name of the public screen to open on. This keyword will override the _GE_Monitor variable in the global settings prefs file. For example - to run Edge on DirectoryOpus's screen enter a new tooltype: PublicScreen='DOPUS.1' Startup Filename of the startup-script to be executed after all files are loaded, defaults to EdgePrg:Edge.startup Templates Filename of the default template file, defaults to EdgePrg:Edge.templates Texts Filename of the requester and text config file, defaults to EdgePrg:Edge.texts Wakeup Filename of the wakeup-script to be executed after Edge is uniconified, defaults to EdgePrg:Edge.wakeup WorkDir The path to use as current directory once the editor has started. For example: WorkDir=Data:myfiles/text/pgms The tooltypes in the project icon have the same name as the Edge environment variable they affect, so look in the environment section for an explanation of what and how the environment variables work. Edge on the Workbench --------------------- AppWindows When Edge is running on the Workbench all text windows become what is known as 'Application Windows'. This means that you may drag and drop project icons into the text windows in order to load them. If multiple icons are dropped in one window, then the first file will be loaded in that window and new windows will be opened for the rest of the files. AppIcon If you set the AppIcon flag in GE_Flags, accessible in General Settings by clicking on the AppIcon check box, Edge will put an Application Icon on the Workbench. This icon is called Edge-Deposit. Project icons may be dragged and dropped into the AppIcon to load them into Edge automatically. A new Edge window will open with each project loaded. This is a great way to open up multiple files without going to the trouble of multiple-selecting them. Just click and hold down the Left Mouse Button on a project file, drag it until the mouse pointer is over the icon, and release the mouse button. If the editor is iconified while doing so it will be awakened. Double clicking on the icon works just as pressing the Edge hot key - Edge will pop to front, and wake up if iconified. The AppIcon is fetched from disk using the name "EdgePrg:edge.appicon.info". Edge's Disk Icon Once Edge is running, a disk icon called "Edge-Docs" opens on the Workbench. This "disk" performs sort of like a RAM_Disk except that you cannot properly write to it, see EDGE: advanced information. What you do use it for is mainly to access the files loaded into the editor without the need of saving them, which is great for compiling, etc. If you use DirectoryOpus, you may open a directory window of Edge: or Edge-Docs: and view the files, copy project files to this disk device, or treat it as any other drive! When you copy files to this device, it is as if you had loaded the project into Edge in the more conventional fashion: a new window opens with the project file loaded. NOTE: When dropping icons on Edge-Docs in Workbench, the icon tool-types (e.g. the files local environment variables) and the files' true path are NOT available, use the AppIcon, or AppWindows, instead, if you need that information. Starting from a Shell --------------------- To start Edge from a Shell just type 'edge'; if you want the editor to load any files at startup simply type the filenames after the command 'edge work:mystuff/source.a'; or to load all C and assembler files in work:mystuff edge work:mystuff/#?(.c|.a). The command line syntax for Edge is as follows: Edge Files/M,PS=PubScreen/K,WD=WorkDir/K, S=Startup/K,W=Wakeup/K, G=Global/K,L=Local/K, M=Menus/K,T=Texts/K, K=Keyboard/K,B=MouseButtons/K, I=Icon/K,D=Dictionary/K,P=Templates/K, Z=Dormant/S,F=Force/S This syntax is shown if you type 'edge ?'. All arguments except FILES work as the tooltype with the same name and are explained below. FILES are, as said above, the name(s) of the file(s) you wish the editor to load at startup. EDGE: advanced information -------------------------- EDGE: is a virtual "disk" perhaps best described as a DOS interface to Edge. Through it you can access all files loaded into the editor and also load new files. Most things you can do with a normal ram disk you can also do with EDGE: - with a few exceptions: 1) .info files cannot be loaded via EDGE: 2) It is not possible to Seek in a file which is presently written to, e.g. opened with MODE_NEWFILE. 3) Read/Write files are not supported; open with MODE_READWRITE. For the more technical users out there, the following DOS packets are supported by the EDGE: device; ACTION_FREE_LOCK ACTION_END ACTION_READ ACTION_LOCATE_OBJECT ACTION_FINDINPUT ACTION_SEEK ACTION_EXAMINE_OBJECT ACTION_EXAMINE_NEXT ACTION_COPY_DIR ACTION_PARENT ACTION_RENAME_OBJECT ACTION_SET_PROTECT ACTION_DISK_INFO ACTION_INFO ACTION_IS_FILESYSTEM ACTION_SET_DATE ACTION_SET_COMMENT ACTION_DELETE ACTION_WRITE ACTION_FINDOUTPUT NOTE: If a blocking requester is active when EDGE: is in use, sometimes it may seem as if DOS is frozen. This is because the requester will also block the Edge's process communication with the EDGE: device - just get rid of the requester and everything will be ok. Edge Help: Basics ----------------- Entering Text Text may be entered into the window by simply typing it in. The cursor indicates where the text will appear if you start typing. Pressing the [Return] key breaks the line and moves the cursor down to the start of the next line. If you start in the middle of some text, the default is to insert the new text and push aside the old text to make room. This is called Insert mode. Toggle whether to Insert or Overstrike in the Settings/Local menu item. You may select which mode to save as the default by using the Local Settings requester opened from the Settings menu. The default is that if you indent a line, then all subsequent lines will indent the same amount until you move the start of the line back out to the left. This is intended for programmers who do a lot of block indentations. This is called AutoIndent. Your text would look like this. All such behaviors of the editor are configurable by the user. If you didn't want to use AutoIndent, for instance, you would select the Settings menu item and within it, select Local Settings or use the keyboard equivalent of pressing [Right Amiga]-[e]. This notation means to press the Right Amiga key, hold it down, and press the [e] key at the same time. Keys that aren't obvious such as the [e] key are named within the square brackets. Other such keys are [CursorUp] for the up arrow key, [Esc] for the Escape key, and so on. When the Local Settings requester opens, you have a choice of setting the Insert or Overstrike mode; Word wrap (words automatically continue or "wrap" around to the next line once you type past the right margin); or setting AutoIndent on or off, simply by clicking on check boxes. Try different settings to see how they affect editing in your document. You may set everything, including tab stops and whether to show spaces, in the Local Settings window. Printing a Document ------------------- You may print a document by selecting the Project/Print, Project/Print To or Project/Print As menu items. If you choose Print As, you get a window to change the printer settings before you print. These do not affect the global printer settings, however. Moving Around with the Mouse, Menu, and Keyboard You may move the cursor up and down and side to side with the cursor arrow keys or with the numeric keypad keys when the numeric pad is toggled so a K appears in the window's bottom indicator bar. Toggle the keypad on and off in Settings/Global Settings menu. You may move around quickly up and down and side to side by simply holding down the Left Mouse Button (LMB) and moving its pointer toward the top, bottom, or side margins. The closer the pointer is to the margins, the faster the text will scroll. You may move up and down with the scroll bar to the right hand side of the window as well. Click and hold the LMB on the scroll bar to move the text up and down smoothly; click on an "empty" space off the scroll bar to jump the text a proportional amount up or down. Bookmarks There is a special way to jump around inside the document. The menu item is called Tools and has two items at the bottom. The first one for setting bookmarks (special user-settable markers you can jump back to after going off somewhere else). The second item is for jumping to the bookmarks you set before. Move to The Tools menu also has a Move to section for moves to line numbers, last change, errors, even specific bytes (useful for programmers). Folds Edge has the capacity to hide sections of a large document as "folds". It behaves as if your file was written on a long scroll and part of it "folded" out of sight. This is useful for hiding completed sections of program code so that they will not distract from work on other parts of the listing. Use the Local Settings requester to set the Fold Start and Fold End character string you prefer to delimit the start and end of your folds. The default for start is /*FS*/ and the default for the end is /*FE*/ but you may change them to any string you prefer. You may also nest folds so that you may hide sections within sections. To show a hidden section, just place the cursor on the start of fold mark and select the menu item to show it or show all to reveal all folds. The File Requesters You have a choice of the Commodore system ASL file requester or a custom requester with more features just for Edge. If you choose in the Global Settings to have the ASL, help is not available, but on-line help will come up for the Edge requester when it is open, or you can jump to any help section from anywhere in the Amigaguide file. Block Operations Edge supports selection and operations with both horizontal and vertical blocks. In order to move text around, we usually cut or copy a block and then paste it down in some other part of the document. We select blocks by double clicking over the start of the block; or by selecting a menu item Block/Mark Block when the cursor is over the start of the block; or by using the keyboard [Right Amiga] [b]. The cursor changes color (if we are using enough colors in our system) after we select the start of the block. The next place we click or move the cursor will highlight all the text from the start to the cursor. Once we have moved the cursor to where we want the end of the block to be, we may cut, copy, or perform other block operations on it. To select a Vertical or Columnar block, we must hold down the [Shift] key while clicking with the mouse - or using the middle button if we have a three button mouse, select the Columnar Block item from the Edit/Begin Column menu, or press [Right Amiga] [Shift] [B] to start the block. Then the highlighted text will be in a column format rather than in a horizontal format. Find and Replace Refer to the Find/Replace requester for information about this subject. Running ARexx Macros There is a rich ARexx command set for Edge, and there are plenty of example programs to use or learn from. Teaching you to program in ARexx is beyond the scope of this help manual. You may run any of the macros included by using the menu item Macros/ARexx/Run ARexx Script or by pressing [Shift] [Esc]. A file requester will open asking you for the name of the ARexx script you want to run. The Setting/Edit Sub-Menu If you need to reconfigure or delete any features, you simply edit a text file such as EdgePrg:edge.menus/main. You don't have to remember which file is which. The Settings menu Edit item at the right hand side has sub-items to edit each configuration such as menus or keyboard settings. Selecting one of these will bring up the configuration file for that item. Save a backup under a different name the first few times you try this. After you finish your edit, another menu item lets you reload the configuration so your changes will take effect. Configuring Edge Although a well thought out default configuration is present from the first time you use Edge, you may easily change any of the default settings to suit your style or habits of use. If you have been using another brand of editor, you may want to reconfigure certain keystrokes and menus to match what you are used to. After installation, if you look at the directory in which Edge resides, you will notice a number of files with names such as Edge.menus or Edge.global. These are ASCII text files which govern the configuration of Edge. Edge itself can open a number of Requesters which allow you to change things such as the global prefs by pointing and clicking on check boxes which edit the associated file indirectly. Advanced users may edit these files directly. We recommend that everyone make a back up file before trying to edit a configuration file directly. Novices should at first use only the Requesters for changing things because these graphics interfaces don't make "typos" when changing a file, and they are easy to change back again. If Edge is your first editor, we suggest that you simply use it as it comes. You may use Edge's default configuration for a while without having to reconfigure anything. Remember that experts developed the defaults. The standard configuration should require only minor customization on your part: for instance, if you don't like or don't use some feature, you may easily delete it from the menu or keyboard configuration file. Extensive rearranging may take some planning, because if you change one thing, you'll probably have to change something else, too. Advanced users who program in different languages may configure different versions of Edge for different projects and languages. To reconfigure anything in your Edge editing environment, you simply modify a text file either directly or via a requester. Dictionaries Edge supplies a workable C language dictionary. Once the dictionary is loaded, it will automatically correct the case of otherwise esoteric strings. You may add words or modify dictionaries, because they are in plain ASCII text format. Dictionaries may be "included" so as to build up a project dictionary from multiple smaller ones. The dictionary feature helps prevent needless case sensitive errors in your code. The default configuration attempts to load a dictionary with the name EdgePrg:Edge.dictionary which is supplied as an empty file. If you desire to use one of the supplied technical programming dictionaries as the default, you should change its name to the default file, or put in a tooltype Dictionary=path:mydictionary which supplies a path to your default dictionary. Edge's Requesters... -------------------- About the Notify requester. The Notify requester is used to notify the user about something, when the response from the user is not significant - the Notify requester only has a 'Continue' gadget. To make the requester go away the user can click the 'Continue' gadget, the window close gadget, press the ESC or RETURN key on the keyboard, select 'Continue' from the menu or press the menu shortcut key for 'Continue' or press the underlined character 'C' for continue. Underlined characters in names for gadgets will select that item. The user can also press the HELP key to activate the Edge Help-system, which will display the page you see here. The Notify requester MENU has two items: Continue Close the requester (may also be done as described above). Keyboard equivalent: [Right Amiga] [C] Snapshot window Save the current position of the Notify requester window in the global environment and use it the next time the requester is called for. Keyboard equivalent: [Right Amiga] [S] NOTE: If you wish to permanently save the window position you must save the Global Settings to disk. NOTE: If the Notify requester window is pointer relative the saved position will NOT be used. NOTE: The Edge ARexx Command for a Notify requester is RequestNotify. About the Choice requester. The Choice requester is used to prompt the user about an OK/Cancel type of decision when the response from the user is significant. The requester will contain a short text describing the matter the user is supposed to decide about. To give a positive response to the requester the user may click the 'OK' gadget (the left one), select 'OK' from the menu or press the menu shortcut key for 'OK', or press the underlined character 'O' in the name 'OK'. To give a negative response to the requester the user may click the 'Cancel' gadget, select 'Cancel' from the menu, press the menu shortcut key for 'Cancel' or press underlined character 'C' or the ESC key on the keyboard. The requester is closed by any of the responses described above. The user can also press the HELP key to activate the Edge Help-system, which will then display this page. The Choice requester MENU has three items: OK Give a positive response. Keyboard equivalent: [Right Amiga] [O] Cancel Give a negative response. Keyboard equivalent: [Right Amiga] [C] Snapshot window Save the current position of the Choice requester window in the global environment and use it the next time the requester is called for. Keyboard equivalent: [Right Amiga] [S] NOTE: If you wish to permanently save the window position you must save the Global Settings to disk. NOTE: If the Choice requester window is pointer relative the saved position will NOT be used. NOTE: The Edge ARexx Command for the Choice requester is RequestChoice. About the Enter a Number requester. The Enter a Number requester is used to prompt the user for a number. The window title will contain a short text telling the user what the number is for. The requester may be preloaded with a default number and if that is OK for the user then he can just 'OK' the requester. The string gadget is automatically activated when the requester is opened but if it should get inactive just click in it. You can only enter digits in this requester within the limits shown in a small window below the number entry gadget. If the number is off limits and you try to 'OK' the requester, the display will flash and a message will be printed in the requester telling you if the number is too small or too large. The requester will refuse to accept an out-of-limits number. To 'OK' the requester and accept the number, either press the RETURN key on the keyboard, click the 'OK' gadget, select 'OK' from the menu or press the menu shortcut key for 'OK', or press 'O', the underlined character. To 'Cancel' the requester either click the 'Cancel' gadget, select 'Cancel' from the menu, press the menu shortcut key for 'Cancel', press the ESC key on the keyboard or press the RETURN key on the keyboard with the string gadget empty (no digits), or press 'C' for 'Cancel'. The requester is closed by any of the responses described above. (as for the 'OK' responses - the number must be within limits or the requester will not go away). The user can also press the HELP key to activate the Edge Help-system, which will then display this page. The Enter a Number requester MENU has three items: OK Give a positive response. Keyboard equivalent: [Right Amiga] [O] Cancel Give a negative response. Keyboard equivalent: [Right Amiga] [C] Snapshot window Save the current position of the Enter a Number requester window in the global environment and use it the next time the requester is called for. Keyboard equivalent: [Right Amiga] [S] NOTE: If you wish to permanently save the window position you must save the Global Settings to disk. NOTE: If the Enter a Number requester window is pointer relative the saved position will NOT be used. NOTE: The Edge ARexx Command for number requester is RequestNumber. About the Enter a Key requester. The Enter a Key requester is used to prompt you for a key-sequence. The window title will contain a short text telling you what the key is for. To start sampling click the 'Sample' gadget - now keyboard input is monitored and displayed in the box below the 'Sample' gadget. Once a complete key-sequence is entered, sampling will stop. As long as sampling is engaged the window title will say 'Sampling'. You may also activate sample mode by pressing the underlined character, 'p', in the name 'Sample'. To the right of the requester there are four checkboxes controling the qualifier options. Click in the box to toggle select/deselect or press the keyboard equivalent - the underlined character in the name of the box. Alt Same Holds the state of the ALTSAME flag in _GE_Flags. If set, left Alt and right Alt are equivalent; i.e. it doesn't matter which Alt key is pressed. Keyboard select: 'A' Shift Same Holds the state of the ALTSHIFT flag in _GE_Flags. If set, left Shift and right Shift are equivalent; i.e. it doesn't matter which Shift key is pressed. Keyboard select: 'S' Mask Alt Holds the state of the QMALT flag in _GE_Flags. If set, the Qualifier mask will include Alt; i.e. the Alt keys as qualifiers are ignored. Keyboard select: 'M' Mask Shift Holds the state of the QMSHIFT flag in _GE_Flags. If set, the Qualifier mask will include Shift; i.e. the Shift keys as such are ignored. Keyboard select: 'Q' To 'OK' the requester; i.e. accept the key-sequence, either press the shortcut key for the 'OK' gadget, click the 'OK' gadget, select 'OK' from the menu or press the menu shortcut key for 'OK'. Keyboard select: 'O' To 'Cancel' the requester either click the 'Cancel' gadget, select 'Cancel' from the menu, press the menu shortcut key for 'Cancel', press the ESC key on the keyboard or press click on the window close gadget. Keyboard select: 'C' The requester is closed by any of the responses described above. You can also press the HELP key to activate the Edge Help-system, which will then display this page. The Enter a Key requester menu has three items: OK Give a positive response. Keyboard equivalent: [Right Amiga] [O] Cancel Give a negative response. Keyboard equivalent: [Right Amiga] [C] Snapshot window Save the current position of the Enter a Key requester window in the global environment and use it the next time the requester is called for. Keyboard equivalent: [Right Amiga] [S] NOTE: If you wish to permanently save the window position you must save the Global Settings to disk. NOTE: If the Enter a Key requester window is pointer relative the saved position will NOT be used. NOTE: The Edge ARexx Command for the EnterAKey requester is RequestKey. About the Enter a String requester. The Enter a String requester is used to prompt the user for a string. The window title will contain a short text telling the user what the string is for. The requester may be preloaded with a default string and if that is OK for the user then he can just 'OK' the requester. The string gadget is automatically activated when the requester is opened, but if it should become inactive just click in it. You can enter any character in this requester. In order to enter non- printing characters use backslash and a three digit decimal number, e.g. '\\010' for a Line Feed (LF), '\\013' for Carriage Return (CR), etc. To 'OK' the requester; i.e. accept the string, either press the RETURN key on the keyboard, click the 'OK' gadget, select 'OK' from the menu or press the menu shortcut key for 'OK', or press 'O', the underlined character. To 'Cancel' the requester either click the 'Cancel' gadget, select 'Cancel' from the menu, press the menu shortcut key for 'Cancel', press the ESC key on the keyboard or press the RETURN key on the keyboard with the string gadget empty (no characters), or press 'C' for 'Cancel'. The requester is closed by any of the responses described above. The user can also press the HELP key to activate the Edge Help-system, which will then display this page. The Enter a String requester MENU has three items: OK Give a positive response. Keyboard equivalent: [Right Amiga] [O] Cancel Give a negative response. Keyboard equivalent: [Right Amiga] [C] Snapshot window Save the current position of the Enter a String requester window in the global environment and use it the next time the requester is called for. Keyboard equivalent: [Right Amiga] [S] NOTE: If you wish to permanently save the window position you must save the Global Settings to disk. NOTE: If the Enter a String requester window is pointer relative the saved position will NOT be used. NOTE: The Edge ARexx Command for a string requester is RequestString. About the Find/Replace requester. The Find/Replace requester is used to prompt the user for find and replace strings and search attributes. The Find and Find/Replace requesters are identical except for one thing, the replace string gadget which will only appear in the Find/Replace requester. All gadgets in the Find/Replace requester display the last values used. If this is OK, then just 'OK' the requester. The find string gadget is activated when the requester is opened, but if it should become inactive just click in it or press a key if the requester window is active. To move the cursor between the find and replace string gadgets from the keyboard use the TAB key. The labels for the options have characters in their names underlined. To select that option, just press the left Amiga key and one of the underlined characters. Edge maintains a history of the find and replace string gadgets. To cycle through the list, simply use the Cursor Up/Down keys. Shift Cursor Down will move to the end of the list and clear the gadget. Shift Cursor Up will search the list for the string currently in the gadget (just like the shell). You can enter any character in the string gadgets; in order to enter a non-printable character use backslash and its three digit decimal number, e.g. '\\010' LF, '\\013' CR, '\\000' NULL, etc. To 'OK' the requester, i.e. accept the string(s), either press the RETURN key on the keyboard, click the 'OK' gadget, select 'OK' from the menu, press the menu shortcut key for 'OK', or use the keyboard: Press the 'O' key. In general, all requesters' items may be chosen by pressing the underlined character in their name. To 'Cancel' the requester either click the 'Cancel' gadget, select 'Cancel' from the menu, press the menu shortcut key for 'Cancel', press the ESC key on the keyboard or press the RETURN key on the keyboard with the find string gadget empty (no characters). You may also press 'C'. The requester is closed by any of the responses described above. The user can also press the HELP key to activate the Edge Help-system which will then display this page. The Find/Replace requester MENU has eight items, described below. OK Go ahead and Find/Replace. Keyboard equivalent: [Right Amiga] [O] Cancel Abort the operation. Keyboard equivalent: [Right Amiga] [C] Snapshot window Save current position of the Find/Replace requester window in the global environment and use it the next time the requester is called for. Keyboard equivalent: [Right Amiga] [S] NOTE: If you wish to permanently save the window position you must save the Global Settings to disk. NOTE: If the Find/Replace requester window is pointer relative, the saved position will NOT be used. The five items below are used to toggle the state of the five checkboxes in the right side, displaying the current state of the search flags. A check in the checkbox means the flag is active. Ignore case Toggles the UCEQLC flag; if this flag is active upper case is treated equal to lower case in searches, else case is significant. Keyboard equivalent: [Right Amiga] [A] Scan forward Toggles the FORWARD flag; if this flag is active the search is made forwards in the file, towards the end of the file, else the search is made backwards, towards start of the file. Keyboard equivalent: [Right Amiga] [F] Use wildcards Toggles the WILD flag; if this flag is active and the find string contains any wildcard characters then pattern matching is used during the search. Keyboard equivalent: [Right Amiga] [D] Searching with wildcards is line oriented, e.g. the entire line is matched against the find-string once and only once. If a match occurs then the cursor will be positioned at column 1 on the line that matched. The 'Only whole words' option is ignored when searching for wildcards. Only whole words Toggles the WORD flag; if this flag is active then the search is made to check for white spaces before and after the specified find string. Keyboard equivalent: [Right Amiga] [W] Circular scan Toggles the CIRCULAR flag; if this flag is active then the search is made circular; that is when end or start of file is reached, the search is restarted at the other end of the file and will continue until either the find string or the beginning of the search is found. Keyboard equivalent: [Right Amiga] [R] Swap... This item only appears in the Replace requester. When selected the Find and Replace strings are swapped. Keyboard equivalent: [Right Amiga] [T] NOTE: The Keyboard equivalents will toggle checkboxes even if a string gadget is active. About the Edge File/Directory requester. NOTE: If you have selected the ASL File Requester (the Amiga Standard File Requester) in the General Settings window, this description does not apply. The ASL requester is described in the AmigaDOS documentation. The Edge File/Directory requester is used to prompt you for either a file or a directory. The File and Directory requesters are identical except for one thing; if you are to select a directory the 'File' gadget is disabled and no files are shown in the filelist - only directories. The window title will contain a short text telling you what the file/directory is for. The 'File', 'Directory' and 'Pattern' gadgets may be preloaded, normally they contain the last used strings, and if that is OK then just 'OK' the requester. NOTE: There are NO underlined character equivalents in the File Requester. The 'Directory' gadget is activated when the requester is opened. To activate the other string gadgets either click in them, or use TAB and SHIFT TAB on the keyboard to circulate. There are three scroll-lists in the requester: Filelist The big list in the middle: here all files and directories read from the directory specified in the 'Directory' gadget are shown, EXCEPT those excluded by a pattern. When you type something in the 'File' or 'Directory' gadget the Filelist will scroll to show the first file and/or directory that matches the start of the name you have typed. To copy the topmost name from the list to the gadget you're in, press CURSORDOWN; to copy the next name, press CURSORDOWN again. To walk backwards in the list press CURSORUP. This function is circular. The names will always be copied to the correct gadget: Directory names to the 'Directory' gadget and file names to the 'File' gadget. After they have been copied their gadgets will be activated. To read in a selected directory just press RETURN in the 'Directory' gadget or select 'GetDir' from the menu or a gadget. To select multiple files, press and hold down any SHIFT key while you either click on the file(s) with the mouse or press RETURN to select the file currently in the 'File' gadget. You can only select multiple files in the file-list and only when MULTISELECT is enabled and only during a READ operation. Devicelist The small list at the right top: here all volumes, devices and assigned directories are shown. To walk through the devicelist from the keyboard press ALT together with CURSORUP/CORSURDOWN. The names will be copied from the list to the 'Directory' gadget and activate it. Lastlist The long list at the left top: here the last used files and directories are shown. You may define how many entries the last list should hold in the Global Settings - General requester. To walk through the lastlist from the keyboard press SHIFT together with CUSORUP/CURSORDOWN. The entries will be copied to the appropriate 'Directory' and 'File' gadget and the 'Directory' gadget will always be activated. When MULTISELECT is enabled you may type a pattern directly in the 'File' gadget, e.g. @{"#?.c" link DosWildCards}. If the requester is used in a READ operation - Open, Include, etc - you must select an existing object. The requester will refuse to 'OK' a non existing file or directory for a READ operation. In WRITE or SAVE operations, you may specify a non existing file, but it must be a valid AmigaDOS filename. To 'OK' the requester; i.e. accept the file/directory, either press the RETURN key on the keyboard, click the 'OK' gadget, select 'OK' from the menu or press the menu shortcut key for 'OK'. As mentioned above, the requester will only 'OK' existing objects in READ operations. To 'Cancel' the requester either click the 'Cancel' gadget, select 'Cancel' from the menu, press the menu shortcut key for 'Cancel' or press the ESC key on the keyboard. The requester is closed by any of the responses described above. You can also press the HELP key to activate the Edge Help-system, which will then display this page. There are seven button gadgets in the right side of the requester. They are explained below when dealing with their menu equivalents. The gadget equivalent names are listed second if they are different from the menu items. The requester MENU has eight items: OK OK, go ahead. Keyboard equivalent: [Right Amiga] [O] Cancel Abort the operation. Keyboard equivalent: [Right Amiga] [C] Snapshot window (MENU ONLY) Saves current position of the requester window in the global environment and uses it the next time the requester is called for. Keyboard equivalent: [Right Amiga] [S] NOTE: If you wish to permanently save the window position you must save the Global Settings to disk. NOTE: If the File/Directory requester window is pointer relative the saved position will NOT be used. Parent Gets parent directory to the current one, if possible. Keyboard equivalent: [Right Amiga] [P] Get dir Re-reads the current directory, or reads the contents of the directory specified in the 'Directory' gadget. Keyboard equivalent: [Right Amiga] [G] Next Cache Displays the next directory cache, if any, in the file NCache list using the current pattern. Keyboard equivalent: [Right Amiga] [>] Previous Cache Displays the previous directory cache, if any, in the 'PCache' file list using the current pattern. All File/Directory requesters in Edge can cache their directory lists if directory caching is enabled. You can easily scan through different directories without having to read them anew from disk. Keyboard equivalent: [Right Amiga] [<] Current Cache Displays a requester's currently cached directory 'CCache' list, which has not yet become part of the 'real' cache list. If caching is disabled or you cancel the requester, Current Cache will not become a real cache. Keyboard equivalent: [Right Amiga] [/] NOTE: The Keyboard equivalents will work even as the string gadgets are active. NOTE: The Edge ARexx Command for the built in Edge or ASL file requester is RequestFile. The kind of file requester put up by the above commands will depend on the global setting. About the Local Settings requester. The Local Settings requester is used to customize the local environment in Edge, and is local in the sense that each file may have its own unique local environment. At the top right there is a scroll-list containing the tabstops for the file. To scroll the list use the slider below the ruler. A 'T' indicates a tabstop at that position, a '-' indicates no stop. To toggle the tabstops just click on them. The tabstoplist is found in the _FE_TabList (File Environment) variable. Below the tabstops are a bunch of string gadgets, described later, and to the left are some checkboxes displaying the state of the Edge local flags, described below. (all Edge local flags are found in the _FE_Flags variable). To select items in requesters that have underlined characters in the item names, simply press the underlined character's key on the keyboard. MakeIcon This checkbox shows the state of the 'ICON' flag. When this flag is on, Edge will create an icon for the file when it is saved, providing no icon existed before. If an icon existed then Edge will check its default tool. If that is the same as Edge's default tool then Edge will keep the icon image but update the tooltypes; if not, no new icon will be created and the old icon is left untouched. Keyboard select: 'M' SafeSaves This checkbox shows the state of the 'SAFESAVES' flag. When this flag is on, Edge will save files in a safe way, that is the file will first be saved with a temporary name, then the old original file is deleted and the temporary file is renamed. When this flag is off, the old original file is overwritten directly. Keyboard select: 'v' TabsToSpaces This checkbox shows the state of the 'TABSTOSPACES' flag. When this flag is on, tabs ('\\009') are translated to an equal number of spaces needed to move the cursor to the same column. Keyboard select: 'T' Editable This checkbox shows the state of the 'EDITABLE' flag. When this flag is on, you may alter the file, e.g. type, delete, cut, insert, etc. When off, the file is in 'View only' mode and you can not alter it. Keyboard select: 'i' MakeBackup This checkbox shows the state of the 'BACKUP' flag. When this flag is on, whenever the file is saved a backup is saved as well to the directory defined in _FE_BackDir and with the name defined in _FE_BackFile. (these two variables are described later when dealing with the string gadgets). The backup is saved using the current settings of the 'ICON' and 'SAFE' flags. Keyboard select: 'B' LineWrap This checkbox shows the state of the 'LINEWRAP' flag. When this flag is on, the cursor will wrap around at sol/eol, e.g. if the cursor is at column 1 and you move the cursor left it will move up to the end of the line above, if possible, and then continue to move left the specified number of characters. A similar effect occurs when the cursor is at the end of a line and you move right. Keyboard select: 'p' AutoIndent This checkbox shows the state of the 'AUTOINDENT' flag. When this flag is on, Edge will automatically indent the cursor to the same position as the first non space/tab character on the line above when you press RETURN or use the NewLine command. Keyboard select: 'A' Layout This checkbox shows the state of the 'LAYOUT' flag. When this flag is on, it is possible to move the cursor beyond the end of the line and if you then type something the 'space' between the cursor and eol is padded with spaces. Keyboard select: 'y' Insert This checkbox shows the state of the 'INSERT' flag. When this flag is on, Edge type mode is insert; e.g. when you type something the characters to the right are pushed to the right. When this flag is off the type mode is overwrite; e.g. the characters to the right of the cursor are overwritten when you type something. The state of this flag is also shown in the status line after the column number, 'I' for insert and 'O' for overwrite. Keyboard select: 'r' WordWrap This checkbox shows the state of the 'WORDWRAP' flag. When this flag is on, Edge will wrap down the cursor and the current word to the next line if you try to type beyond the defined wrap border _FE_WrapBorder. In other words, Edge will keep track of the right margin for you while you type. Keyboard select: 'W' CorrectCase This checkbox shows the state of the 'CORRECTCASE' flag. When this flag is on, Edge will automatically try to correct the case of the words that you type. For the case correction to succeed the word must be found in the edge dictionary. If a word is not found no action is taken. Keyboard select: 'o' ShowSpaces This checkbox shows the state of the 'SHOWSPACES' flag. When this flag is on white spaces will be printed with characters that have an image; i.e. space will be printed as '·', tab will be printed as '°' & LF will be printed as '¶'. Keyboard select: 'h' That takes care of all the local environment flags; now for a description of the string gadgets and their associated variables. When the requester is opened none of the string gadgets are activated. With the mouse - just click in the one you want to activate. With the keyboard - press the underlined key in the name of the gadget you wish to activate. Use TAB and SHIFT TAB to circulate. RETURN will deactivate the current gadget. GADGETS, CENTER COLUMN: Backup dir This gadget holds the contents of the _FE_BackDir variable. The string in _FE_BackDir is used as the path description when saving backups. It is not necessary to end it with a '/' - Edge will take care of that. However, it must be a valid AmigaDOS path or an error will be reported when Edge tries to use it. Keyboard select: 'd' Backup file This gadget holds the contents of the _FE_BackFile variable. Keyboard select: 'k' The string in _FE_BackFile is used as the filename description when saving backups. If the string is empty and 'BACKUP' is on the default file for backups '*{#}' is used. If you choose to have a backup file with a simple name; e.g. 'oldfile.c.bak'. The backup system will always backup to a file with that name. You can also make use of the star '*' to allow a dynamic name and let Edge evaluate the true name when saving a backup; e.g. '*.bak' will use the original filename and then append '.bak' to it. (the star is equal to the current name of the file). Additionally you may also want to use the hash mark '#' to make use of Edge's autonumbering capability. When a '#' is encountered in the name it is replaced with the current value of the file's backup-counter, located in the file '*.B' in the backup directory. After the backup is saved a check is made to see if the maximum number of backups (_FE_MaxBackups) has been exceeded, and if so the oldest backup is deleted. Then the backup-counter is incremented. With the dynamic name and the autonumbering it is easy to maintain a backup directory that contains multiple backups of several files and it makes making a backup worthwhile - you have the option to reload old versions of you sources. Max backups This gadget holds the contents of the _FE_MaxBackups variable. The number in _FE_MaxBackups is used to define how many backup copies are to be used for this file. Keyboard select: 'x' Fold start This gadget holds the contents of the _FE_FoldStart variable. The string in _FE_FoldStart is used as the fold start marker. Keyboard select: 'l' Fold end This gadget holds the contents of the _FE_FoldEnd variable. The string in _FE_FoldEnd is used as the fold end marker. Keyboard select: 'e' Undo buffer This gadget holds the contents of the _FE_UndoBuff variable. The number in _FE_UndoBuff defines the byte-size of the undo buffer for this file. The bigger the number the more changes can be stored. Keyboard select: 'n' IMark image This gadget holds the contents of the _FE_IMark variable. The string in _FE_IMark is the image used in the FindIMark function. The 'x' in the string is replaced by the number supplied as the argument to FindIMark, if no 'x' exists in the string only one IMark can exist. The string may be 31 characters, unexpanded. Keyboard select: 'g' GADGETS, RIGHT COLUMN: Tab distance This gadget has no variable. It is used to simplify the setting of a tab list with the same spacing between all stops. Just type a number and press RETURN or TAB. Keyboard select: '1' NOTE: You must press either the RETURN or the TAB key in order to change the tabstoplist. Page length This gadget holds the contents of the _FE_PageLen variable. The number in _FE_PageLen is the number of lines that will fit in a page in this file. The minimum page length is one line. Keyboard select: '2' Upper scrollborder This gadget holds the contents of the _FE_UpperSB variable. The number in _FE_UpperSB is the number of lines that the upper scrollborder consists of; i.e. when the cursor is _FE_UpperSB lines from the top of the window and you move up, the text will scroll. (this will not happen at start of file.) Keyboard select: '3' Lower scrollborder This gadget holds the contents of the _FE_LowerSB variable. The number in _FE_LowerSB is the number of lines that the lower scrollborder consists of; i.e. when the cursor is _FE_LowerSB lines from the bottom of the window and you move down, the text will scroll. Keyboard select: '4' Left scrollborder This gadget holds the contents of the _FE_LeftSB variable. The number in _FE_LeftSB is the number of characters that the left scrollborder consists of; i.e. when the cursor is _FE_LeftSB characters from the left side of the window the text will scroll. (this is not true at start of line.) Keyboard select: '5' Right scrollborder This gadget holds the contents of the _FE_RightSB variable. The number in _FE_RightSB is the number of characters that the right scrollborder consists of; i.e. when the cursor is _FE_RightSB characters from the right side of the window, the text will scroll. Keyboard select: '6' Wrap border This gadget holds the contents of the _FE_WrapBorder variable. The number in _FE_WrapBorder is used as the right border when 'WORDWRAP', word wrap, is on and in paragraph formatting, Format. Keyboard select: '7' That is all regarding the Local Settings requesters string gadgets. At the bottom right there are three action gadgets: Save OK the requester, use the changes made and save them to the default local settings preferences file, using either the name EdgePrg:Edge.local or the name defined by you at startup using the LOCAL keyword/tooltype. Keyboard select: 'S' Use OK the requester, use the changes made but don't save them. Keyboard select: 'U' Cancel Cancel the requester, restore the local settings to the state they were in when the requester was opened. Keyboard select: 'C' The Local Settings requester has three menus: Project This menu has five items: Open Load a local settings preference file other than the default one. You will be prompted for a name with the Filerequester. Keyboard equivalent: [Right Amiga] [O] Save As Save the local settings preference file to a file other than the default. You will be prompted for a name with the FileRequester. No keyboard equivalent. Snapshot window Save the current position of the requester window in the global environment and use it the next time the requester is called for. Keyboard equivalent: [Right Amiga] [S] NOTE: If you wish to permanently save the window position you must save the Global Settings to disk. NOTE: If the Local Settings requester window is pointer relative the saved position will NOT be used. Use Selecting this item has the same effect as clicking on the 'Use' gadget. Keyboard equivalent: [Right Amiga] [U] Quit Selecting this item has the same effect as clicking on the 'Cancel' gadget. Keyboard equivalent: [Right Amiga] [Q] Edit This menu has three items: Reset to defaults Restore the local settings to the internal defaults of Edge. Keyboard equivalent: [Right Amiga] [D] Last saved Reload the local settings preference file, either EdgePrg:Edge.local or the file defined by you at startup, with the LOCAL keyword/tooltype. Keyboard equivalent: [Right Amiga] [L] Restore Restore the local settings to the state they were in when the requester was opened. Keyboard equivalent: [Right Amiga] [R] Options This menu has only one item: Save icon If enabled, an icon will be created for the local settings preference file when saved. No keyboard equivalent. NOTE: The ARexx Command for the local settings requester is LocalSettings. About the Global Settings - General requester. The Global Settings requester is used to customize the global environment in Edge. The requester is divided into four parts: Screen, Printer, Windows and General. This section, General, contains general and all purpose variables and flags. The left side of the requester contains some string gadgets, described later, and the right side has a lot of checkboxes, displaying the global environment general flags, found in the _GE_Flags variables. The checkboxes may be toggle-selected to ON or OFF by clicking inside the checkbox, or you may simply press the keyboard key corresponding to the underlined character in the checkbox's name. The flags are explained below: CHECKBOXES, MIDDLE COLUMN: CutRepeat This checkbox shows the state of the 'CUTREPEAT' flag. When this flag is on, overflowing REPEAT messages from the keyboard will be ignored, which really means that the editor responds a bit snappier to key release events. Keyboard select: 'e' ShowDir This checkbox shows the state of the 'SHOWDIR' flag. When this flag is on, the FileRequester will display the filelist as it reads it in. When the flag is off the filelist is not shown until the entire directory is read. Keyboard select: 'h' CacheDir This checkbox shows the state of the 'CACHEDIR' flag. When this flag is on, the FileRequester caches the filelist so you won't have to wait for it to be read in the next time you use the same FileRequester. Keyboard select: 'r' AutoDir This checkbox shows the state of the 'AUTODIR' flag. When this flag is on, the FileRequester will automatically reread the directory if the directory attributes (the path name or date) have changed. Keyboard select: 'o' AutoSaveOn This checkbox shows the state of the 'AUTOSAVEON' flag. When this flag is on, the automatic save function is activated and the save will kick in whenever the counter has reached the value of _GE_AutoSaveTimer. Keyboard select: 'n' AutoSaveReq This checkbox shows the state of the 'AUTOSAVEREQ' flag. When this flag is on, you will be prompted with a Choice requester before any files are auto-saved. Keyboard select: 'q' AutoSaveChng This checkbox shows the state of the 'AUTOSAVECHNG' flag. When this flag is on, the file(s) will only be auto-saved if any changes have been made. Keyboard select: 'g' AutoSaveAll This checkbox shows the state of the 'AUTOSAVEALL' flag. When this flag is on, all files in the editor will be considered for auto-saving, not just the current one. Keyboard select: 't' LoadLocal This checkbox shows the state of the 'LOADLOCAL' flag. When this flag is on and a file is loaded, the local settings will be loaded from the tooltypes in the files icon. Those variables not contained in the icon, or if this flag is off, will be loaded from the default local environment, which in turn is loaded from the EdgePrg:Edge.local file if not overridden by you at startup with the LOCAL keyword/tooltype. Keyboard select: 'd' SaveLocal This checkbox shows the state of the 'LOCALSAVE' flag. When this flag is on, Edge will save the local settings in the icon when saving files. Keyboard select: 'v' ASLReq This checkbox shows the state of the 'ASLREQ' flag. When this flag is on, Edge will use the ASL FileRequester instead of the one built into Edge. The ASL Requester appears relative to your mouse pointer if FileReqPRel flag is set. If not set the position is stored in _GE_ReqFileX (leftedge) and _GE_ReqFileY (topedge). These variables are also used by the built-in FileRequester. The size is stored in _GE_ASLWidth and _GE_ASLHeight Global Environment variables. The size & position of the ASL is updated automatically when you OK the file requester. Keyboard select: 'A' CHECKBOXES, RIGHT COLUMN: Clock This checkbox shows the state of the 'CLOCK' flag. When this flag is on, the Edge clock, in the screen title bar, is enabled all the time. Keyboard select: 'k' AutoClock This checkbox shows the state of the 'AUTOCLOCK' flag. When this flag is on, the Edge clock, in the screen title bar, is enabled only when an Edge window is active and automatically disabled when no Edge window is active and not blocked by a requester. Keyboard select: 'l' IconWindow This checkbox shows the state of the 'ICONWINDOW' flag. When this flag is on, Edge will open a small window in the Workbench when in iconified state. To wake up Edge either activate the iconwindow and click the right mousebutton or press the hotkey. Keyboard select: 'W' DormantQuit This checkbox shows the state of the 'DORMANTQUIT' flag. When this flag is on, Edge will iconify instead of quit when you close the last window. Edge will NOT iconify if there is an outstanding ARexx message. All ARexx messages must return before Edge will iconify. Keyboard select: 'm' MouseBlanker This checkbox shows the state of the 'MOUSEBLANKER' flag. When this flag is on, Edge will blank the mousepointer whenever you type something on the keyboard and turn it back on when you move the mouse. Keyboard select: 'B' AppIcon This checkbox shows the state of the 'APPICON' flag. When this flag is on Edge will put an application icon in the Workbench, which will make it easier to load files from WB - just drop them on the icon. Keyboard select: 'I' Now to describe the string gadgets and their associated variables. When the requester is opened none of the string gadgets are activated. With the mouse, just click in the one you want to activate and use TAB and SHIFT TAB to circulate. RETURN will deactivate the current gadget. With NO GADGET ACTIVE, pressing the underlined keyboard number shown beside the name of the gadget will active that gadget. Pressing a number with a gadget active will insert that number at the cursor position. Max lastfiles This gadget holds the contents of the _GE_MaxLast variable. The number in _GE_MaxLast defines the maximum number of entries in the Lastlist in the FileRequester. Keyboard select: 1 AutoSave timer This gadget holds the contents of the _GE_AutoSaveTimer variable. The number in _GE_AutoSaveTimer is the number of minutes between auto-saves. Keyboard select: 2 Edge priority This gadget holds the contents of the _GE_Priority variable. The number in _GE_Priority is the Edge process priority. It should normally be set to zero. Keyboard select: 3 Error level This gadget holds the contents of the _GE_ErrLevel variable. The value in _GE_ErrLevel is a threshold for errors reported to you; e.g. if _GE_ErrLevel is 10 and an error with severity 9 or less occurs it won't be reported. However, errors with a severity of 10 or greater will be reported. You may customize the error levels for all Edge errors in the Text config file. Keyboard select: 4 Close delay This gadget holds the contents of the _GE_CloseDelay variable. The value in _GE_CloseDelay is the number of seconds to wait after an ARexx-script has finished until the ARexx-console is closed. A value of -1 means never. A value of 0 will close the ARexx IO stream immediately after all messages have returned. Keyboard select: 5 Hotkey pri This gadget holds the contents of the _GE_CX_Pri variable. The value in _GE_CX_Pri is used as the commodities hotkey priority. Keyboard select: 6 ARexx console This gadget holds the contents of the _GE_RexxConsole variable. The string in _GE_RexxConsole is the name of the console to open before an ARexx-script is to be run. Keyboard select: 7 Icon toolname This gadget holds the contents of the _GE_ToolName variable. The string in _GE_ToolName is used as the default tool when saving Edge project icons. Keyboard select: 8 Hotkey This gadget holds the contents of the _GE_CX_PopKey variable. The string in _GE_CX_PopKey is used as hotkey description for the hotkey used to uniconify Edge. Keyboard select: 9 At the bottom left there are three action gadgets: Screen Clicking this gadget will display the Screen Settings. Keyboard select: '[' Printer Clicking this gadget will display the Printer Settings. Keyboard select: ']' Windows Clicking this gadget will display the Window Settings. Keyboard select: ';' At the bottom right there are also three action gadgets. Save OK the requester, use the changes made and save them to the default global settings preferences file, using either the name EdgePrg:Edge.global or the name defined by you at startup using the GLOBAL keyword/tooltype. Keyboard select: 'S' Use OK the requester, use the changes made but don't save them. Keyboard select: 'U' Cancel Cancel the requester, restore the global settings to the state they were in when the requester was opened. Keyboard select: 'C' The Global Settings requester has three MENUS: Project This menu has five items: Open Load a global settings preference file other than the default one. You will be prompted for a name with the FileRequester. Keyboard equivalent: [Right Amiga] [O] Save As Save the global settings preference file to a file other than the default. You will be prompted for a name with the FileRequester. No keyboard equivalent. Snapshot window Save the current position of the requester window in the global environment and use it the next time the requester is called for. Keyboard equivalent: [Right Amiga] [S] NOTE: If you wish to permanently save the window position you must save the Global Settings to disk. NOTE: If the Global Settings requester window is pointer relative the saved position will NOT be used. Use Selecting this item has the same effect as clicking on the 'Use' gadget. Keyboard equivalent: [Right Amiga] [U] Quit Selecting this item has the same effect as clicking on the 'Cancel' gadget. Keyboard equivalent: [Right Amiga] [Q] Edit This menu has three items: Reset to defaults Restore the global settings to the internal defaults of Edge. Keyboard equivalent: [Right Amiga] [D] Last saved Reload the global settings preference file, either EdgePrg:Edge.global or the file defined by you at startup with the GLOBAL keyword/tooltype. Keyboard equivalent: [Right Amiga] [L] Restore Restore the global settings to the state they were in when the requester was opened. Keyboard equivalent: [Right Amiga] [R] Options This menu has only one item: Save icon If enabled, an icon will be created for the global settings preference file when saved. No keyboard equivalent. NOTE: The menus and action gadgets work on the entire global environment, not just the section currently displayed. About the Global Settings - Screen requester. The Global Settings requester is used to customize the global environment in Edge. The requester is divided into four parts: Screen, Printer, Windows and General. This section, Screen, contains screen variables. At the left top there is a scroll-list showing all available display modes and public screen. To select a display mode just click on it with the mouse; the currently selected mode is shown just below the list. You may "clone" any existing screen including the Workbench. If you choose to clone a screen, its screen attributes - such as font, dri_pens, size and colors - will be imitated by the new custom Edge screen. The colors are copied so that their complements work as on the original screen. To the right of the display mode list are two string gadgets indicating width and height, and one slider indicating the depth. When the requester is opened none of the string gadgets are activated. With the mouse, just click in the one you want to activate. With the keyboard, press the key that you see underlined to activate the gadget. 'I' activates Screen Width; 'H' activates Screen Height; 'D' activates Screen Depth. If one of the gadgets is active, just use TAB and SHIFT TAB to cycle through the rest. RETURN will deactivate the current gadget. Screen Width This gadget holds the contents of the _GE_ScreenWidth variable. The value in _GE_ScreenWidth is used as the width of the Edge custom screen. If Edge is running on Workbench or on a Screen clone this variable is ignored. The minimum allowed screen width is 640 pixels. To get the default width of the selected display mode enter -1. Keyboard select: 'W' Screen Height This gadget holds the contents of the _GE_ScreenHeight variable. The value in _GE_ScreenHeight is used as the height of the Edge custom screen. If Edge is running on Workbench or on a Screen clone this variable is ignored. The minimum allowed screen height is 200 pixels. To get the default height of the selected display mode enter -1. Keyboard select: 'H' Screen Depth This gadget holds the contents of the _GE_ScreenDepth variable. The value in _GE_ScreenDepth is used as the number of bitplanes in the Edge custom screen. If Edge is running on Workbench or on a Screen clone this variable is ignored. The Screen Depth is displayed as a number beside the name of the gadget. Keyboard select: 'D' Left, below the display mode list are a bunch of gadgets forming the palette control. To select a color just click on it in the color table; the currently selected color is shown in the box at the left of the color table. Use the three sliders below the color table to adjust the selected color's Red, Green and Blue components. The four action gadgets below the color table are used to perform some other functions on the palette. If you use a Workbench:Clone or a Workbench:Use option, then the palette will be ghosted and disabled. If any other screens are running, then you may USE or CLONE them, too. Edge will use their palettes and screen resolutions, and GHOST the appropriate gadgets. Copy When this gadget is clicked on the currently selected color will be copied to the one you click on next. Keyboard select: 'y' Swap When this gadget is clicked on the currently selected color will be swapped with the color you click on next. Keyboard select: 'a' Spread When this gadget is clicked on the colors between the currently selected one and the next one you click on will be filled with a range of colors spreading from the currently selected color to the next color you click on. Keyboard select: 'e' Undo Clicking this gadget will undo all changes made to the palette since the requester was opened. Keyboard select: 'o' To the right of the palette there are three big action gadgets. These are the font gadgets, and you use them to select the Edge fonts. When you click on any of them an ASL FontRequester will be opened to let you select a font and specify the soft styles to be used. The font soft style flags are kept in the _GE_FontFlags variable. Just under each font gadget is a box showing the currently selected font and its soft style. Screen Font Clicking on this gadget will let you specify the screen font. That font is used in the screen title bar, the menus, and the window's title bars. The screen font name is held in the _GE_ScreenFontName variable and the size is held in the _GE_ScreenFontSize variable. The screen font can be any font you like, but the size must be within 6 - 64 points. The empty string "", or ".font" selects the default system font. Keyboard select: 'F' Text Font Clicking on this gadget will let you specify the text font. That font is used to print the text in the text windows. The text font name is held in the _GE_TextFontName variable and the size is held in the _GE_TextFontSize variable. The text font can be any monospace font you like, but the size must be within 6 - 64 points. The empty string "", or ".font" selects the default system font. Keyboard select: 'x' Gadget Font Clicking on this gadget will let you specify the gadget font. This font is used for printing all gadget texts, and most message and info texts too. The gadget font name is held in the _GE_GadgetFontName variable and the size is held in the _GE_GadgetFontSize variable. The gadget font may be any monospace font but the size must be within 6 - 64 points. The empty string "", or ".font" selects the default system font. Keyboard select: 't' At the bottom left there are three action gadgets: General Clicking this gadget will display the General Settings. Keyboard select: ' (single quote) Printer Clicking this gadget will display the Printer Settings. Keyboard select: ']' Windows Clicking this gadget will display the Window Settings. Keyboard select: ';' At the bottom right there are also three action gadgets: Save OK the requester, use the changes made and save them to the default global settings preferences file, using either the name EdgePrg:Edge.global or the name defined by you at startup using the GLOBAL keyword/tooltype. Keyboard select: 'S' Use OK the requester, use the changes made but don't save them. Keyboard select: 'U' Cancel Cancel the requester, restore the global settings to the state they were in when the requester was opened. Keyboard select: 'C' The Global Settings requester has three MENUS: Project This menu has five items: Open Load a global settings preference file other than the default one. You will be prompted for a name with the FileRequester. Keyboard equivalent: [Right Amiga] [O] Save As Save the global settings preference file to a file other than the default. You will be prompted for a name with the FileRequester. No keyboard equivalent. Snapshot window Save the current position of the requester window in the global environment and use it the next time the requester is called for. Keyboard equivalent: [Right Amiga] [S] NOTE: If you wish to permanently save the window position you must save the Global Settings to disk. NOTE: If the Global Settings requester window is pointer relative the saved position will NOT be used. Use Selecting this item has the same effect as clicking on the 'Use' gadget. Keyboard equivalent: [Right Amiga] [U] Quit Selecting this item has the same effect as clicking on the 'Cancel' gadget. Keyboard equivalent: [Right Amiga] [Q] Edit This menu has three items: Reset to defaults Restore the global settings to the internal defaults of Edge. Keyboard equivalent: [Right Amiga] [D] Last saved Reload the global settings preference file, either EdgePrg:Edge.global or the file defined by you at startup with the GLOBAL keyword/tooltype. Keyboard equivalent: [Right Amiga] [L] Restore Restore the global settings to the state they were in when the requester was opened. Keyboard equivalent: [Right Amiga] [R] Options This menu has only one item: Save icon If enabled, an icon will be created for the global settings preference file when saved. No keyboard equivalent. NOTE: The menus and action gadgets work on the entire global environment, not just the section currently displayed. About the Global Settings - Printer requester. The Global Settings requester is used to customize the global environment in Edge. The requester is divided into four parts: Screen, Printer, Windows and General. This section, Printer, contains printer variables and flags. The greatest part of the requester contains string gadgets, described later, but the right side has a few checkboxes and radio buttons, displaying the global environment printer flags, found in the _GE_PrtFlags variable. The flags are explained below. You may click on the checkbox with the Left Mouse Button or you may toggle the checkbox on and off by pressing the underlined character in the checkbox's name. For instance, Header is activated or deactivated by pressing the '1' key. Header Date This checkbox shows the state of the 'HEADDATE' flag. When this flag is on, the time and date will be printed in the page header. Keyboard select: '1' Header FileName This checkbox shows the state of the 'HEADNAME' flag. When this flag is on, the filename will be printed in the page header. You may define the format string for the header/footer name field in the Text config file. The default format string is 'File : %s'. Keyboard select: '2' Header Page # This checkbox shows the state of the 'HEADPAGE' flag. When this flag is on, the current page number will be printed in the page header. You may define the format string for the header/footer page number field in the Text config file. The default is 'Page : %-5ld'. Keyboard select: '3' Footer Date This checkbox shows the state of the 'FOOTDATE' flag. When this flag is on, the time and date will be printed in the page footer. Keyboard select: '4' Footer FileName This checkbox shows the state of the 'FOOTNAME' flag. When this flag is on, the filename will be printed in the page footer. Keyboard select: '5' Footer Page # This checkbox shows the state of the 'FOOTPAGE' flag. When this flag is on, the current page number will be printed in the page footer. Keyboard select: '6' The radio buttons are used to select if and how to convert tabs/spaces. Tabs to Spaces This button shows the state of the 'TABSTOSPACES' flag. When this flag is on, all tabs (\\009) are translated to an equal number of spaces needed to move the cursor to the same column. The translation is made using the tabstoplist defined in the file's local settings. Spaces to Tabs This button shows the state of the 'SPACESTOTABS' flag. When this flag is on, all spaces are translated to tabs using the internal tabstoplist. No Conversion This button doesn't have a corresponding flag. It is used to indicate/select that neither of the two options above are on. STRING GADGETS Now to describe the string gadgets and their associated variables. When the requester is opened none of the string gadgets are activated. With the mouse, just click in the one you want to activate. With the keyboard, press the underlined key to activate. For example, pressing 'H' activates the 'Header Init' string gadget. Use TAB and SHIFT TAB to cycle through the rest of the gadgets. RETURN will deactivate the current gadget. Header Init This gadget holds the contents of the _GE_HeadInit variable. The string in _GE_HeadInit is sent to the printer just before the header and the header title is printed. This way you may choose to have another style in the header than in the main text. In order to enter non-printable characters use backslash and a three digit decimal number e.g. '\\015' FF, '\\027' ESC, etc. Keyboard select: 'H' Header Title This gadget holds the contents of the _GE_HeadTitle variable. The string in _GE_HeadTitle is sent to the printer just after the header is printed. Keyboard select: 'e' Footer Init This gadget holds the contents of the _GE_FootInit variable. The string in _GE_FootInit is sent to the printer just before the footer and the footer title are printed. This way you may choose to have another style in the footer than in the main text. In order to enter non-printable characters use backslash and a three digit decimal number; e.g. '\\015' FF, '\\027' ESC, etc. Keyboard select: 'F' Footer Title This gadget holds the contents of the _GE_FootTitle variable. The string in _GE_FootTitle is sent to the printer just after the footer is printed. Keyboard select: 'o' File Init This gadget holds the contents of the _GE_FileInit variable. The string in _GE_FileInit is sent to the printer just before the main text is printed. This way you may choose to have another style in the main text than in the header and footer. In order to enter non-printable characters use backslash and a three digit decimal number e.g. '\\015' FF, '\\027' ESC, etc. Keyboard select: 'I' Output This gadget holds the contents of the _GE_Printer variable. The string in _GE_Printer is the name of the printer to use. Normally this is 'PRT:'. Keyboard select: 't' Left Margin This gadget holds the contents of the _GE_LeftMargin variable. The number in _GE_LeftMargin is used as an indent amount for each line. Keyboard select: 'L' Right Margin This gadget holds the contents of the _GE_RightMargin variable. The value in _GE_RightMargin is used as the right border for each line printed, so the number of characters that will fit on a line is _GE_RightMargin minus _GE_LeftMargin. Keyboard select: 'R' Paper Length This gadget holds the contents of the _GE_PaperLen variable. The number in _GE_PaperLen is used to tell Edge how many lines of text will fit on a paper, used when calculating paper advance. Keyboard select: 'n' Tab Distance This gadget holds the contents of the _GE_TabDistance variable. The value in _GE_TabDistance is not sent to the printer, it is only used to calculate how many characters will fit within the right margin. Keyboard select: 'b' At the bottom left there are three action gadgets: Screen Clicking this gadget will display the Screen Settings. Keyboard select: '[' General Clicking this gadget will display the General Settings. Keyboard select: ' (single quote) Windows Clicking this gadget will display the Window Settings. Keyboard select: ';' At the bottom right there are also three action gadgets: Save OK the requester, use the changes made and save them to the default global settings preferences file, using either the name EdgePrg:Edge.global or the name defined by you at startup using the GLOBAL keyword/tooltype. Keyboard select: 'S' Use OK the requester, use the changes made but don't save them. Keyboard select: 'U' Cancel Cancel the requester, restore the global settings to the state they were in when the requester was opened. Keyboard select: 'C' The Global Settings requester has three menus: Project This menu has five items: Open Load a global settings preference file other than the default one. You will be prompted for a name with the Filerequester. Keyboard equivalent: [Right Amiga] [O] Save As Save the global settings preference file to a file other than the default. You will be prompted for a name with the FileRequester. No keyboard equivalent. Snapshot window Save the current position of the requester window in the global environment and use it the next time the requester is called for. Keyboard equivalent: [Right Amiga] [S] NOTE: If you wish to permanently save the window position you must save the Global Settings to disk. NOTE: If the Global Settings requester window is pointer relative the saved position will NOT be used. Use Selecting this item has the same effect as clicking on the 'Use' gadget. Keyboard equivalent: [Right Amiga] [U] Quit Selecting this item has the same effect as clicking on the 'Cancel' gadget. Keyboard equivalent: [Right Amiga] [Q] Edit This menu has three items: Reset to defaults Restore the global settings to the internal defaults of Edge. Keyboard equivalent: [Right Amiga] [D] Last saved Reload the global settings preference file, either EdgePrg:Edge.global or the file defined by you at startup with the GLOBAL keyword/tooltype. Keyboard equivalent: [Right Amiga] [L] Restore Restore the global settings to the state they were in when the requester was opened. Keyboard equivalent: [Right Amiga] [R] Options This menu has only one item: Save icon If enabled, an icon will be created for the global settings preference file when saved. No keyboard equivalent. NOTE: The menus and action gadgets work on the entire global environment, not just the section currently displayed. NOTE: A slightly modified version of this requester comes up when you select the Project/Print As... menu, or the Edit/Print Clipboard menu. It is the same as the Global Print requester, except that there are only Print and Cancel buttons on the bottom. Settings made in this requester are only good for the print session, and DO NOT change the global printer settings. See Print & PrintClip. About the Global Settings - Windows requester. The Global Settings requester is used to customize the global environment in Edge. The requester is divided into four parts: Screen, Printer, Windows and General. This section, Windows, contains window variables and flags. Below is an explanation of the checkboxes found to the right and bottom middle of the requester, containing the global environment window flags - which are all found in the _GE_WndFlags variable. Checkboxes may be toggled by pressing the underlined character in their name (the Keyboard select characters below). Misc window flags, LEFT SIDE: SnapSize This checkbox shows the state of the 'SNAPSIZE' flag. When this flag is on, the text windows will automatically adjust their size to even characters when resized. Keyboard select: 'z' InfoTop This checkbox shows the state of the 'INFOTOP' flag. When this flag is on, the status line is at the top of the text windows; when off, at the bottom. Keyboard select: 'f' KeyPad This checkbox shows the state of the 'KEYPAD' flag. When this KEYPAD flag/qualifier is used; i.e. if you press a key on the numeric keyboard, it will be treated as a numeric keyboard key. If the flag is off, the keys on the numeric keyboard will not be treated differently from the rest of the keyboard. (similar to NUMLOCK/SCROLLLOCK) Keyboard select: 'y' ScrScroll This checkbox shows the state of the 'SCRSCROLL' flag. When this flag is on, the screen will automatically scroll when the cursor is moved beyond the size of the visible part of the screen. Keyboard select: 'r' NOTE: For this to work your window must be on a screen which is larger than the display clip. NOTE: This feature works only on Kickstart v39 and better. On pre v39 systems this gadget is disabled. Misc window flags, RIGHT SIDE: AutoZoom This checkbox shows the state of the 'AUTOZOOM' flag. When this flag is on, the text windows are automatically zoomed when they are deactivated. Keyboard select: 'o' AutoUnZoom This checkbox shows the state of the 'AUTOUNZOOM' flag. When this flag is on, the text windows are automatically unzoomed when activated. Keyboard select: 'm' AutoFront This checkbox shows the state of the 'AUTOFRONT' flag. When this flag is on, the text windows are automatically brought to the front of all windows when activated. Keyboard select: 'A' Pointer relative requesters LEFT SIDE: Number This checkbox shows the state of the 'NUMERPREL' flag. When this flag is on, the Enter a Number requester, RequestNumber from ARexx, is positioned relative to the mouse pointer when opened. Keyboard select: 'N' NOTE: When this flag is on, the saved position is not used. String This checkbox shows the state of the 'STRINGPREL' flag. When this flag is on, the Enter a String requester, RequestString from ARexx, is positioned relative to the mouse pointer when opened. Keyboard select: 'g' NOTE: When this flag is on, the saved position is not used. Key This checkbox shows the state of the 'KEYPREL' flag. When this flag is on, the Enter a Key requester, RequestKey from ARexx, is positioned relative to the mouse pointer when opened. Keyboard select: 'K' NOTE: When this flag is on, the saved position is not used. Notify This checkbox shows the state of the 'NOTIFYPREL' flag. When this flag is on, the Notify requester, RequestNotify from ARexx, is positioned relative to the mouse pointer when opened. Keyboard select: 't' NOTE: When this flag is on, the saved position is not used. Choice This checkbox shows the state of the 'CHOICEPREL' flag. When this flag is on, the Choice requester, RequestChoice from ARexx, is positioned relative to the mouse pointer when opened. Keyboard select: 'h' NOTE: When this flag is on, the saved position is not used. Pointer relative requesters RIGHT SIDE: Find This checkbox shows the state of the 'FINDPREL' flag. When this flag is on, the Find/Replace requester, is positioned relative to the mouse pointer when opened Keyboard select: 'd' NOTE: When this flag is on, the saved position is not used. File This checkbox shows the state of the 'FILEREQPREL' flag. When this flag is on, the FileRequester, RequestFile from ARexx, is positioned relative to the mouse pointer when opened. Also the ASL Requester makes use of this flag. Keyboard select: 'e' NOTE: When this flag is on, the saved position is not used. Local This checkbox shows the state of the 'LOCALPREL' flag. When this flag is on, the Local Settings requester, LocalSettings from ARexx, is positioned relative to the mouse pointer when opened. Keyboard select: 'l' NOTE: When this flag is on, the saved position is not used. Global This checkbox shows the state of the 'GLOBALPREL' flag. When this flag is on, the Global Settings requester, GlobalSettings from ARexx, is positioned relative to the mouse pointer when opened. Keyboard select: 'b' NOTE: When this flag is on, the saved position is not used. ErrorList This checkbox shows the state of the 'ERRLISTPREL' flag. When this flag is on, the Error list window, GoToError SHOW from ARexx, is positioned relative to the mouse pointer when opened. Keyboard select: 'i' NOTE: When this flag is on, the saved position is not used. Now to describe the rest of the gadgets and their associated variables. When Edge is running on a public screen, Workbench for example, the Pen variables are hardwired to the public screen's pen array. Since you are not actually able to change the pen values, the cycle and palette gadgets are disabled. If you are running on Workbench you are able to adjust its pen array values with Workbench's Palette preference tool. PenName Pen Array Entry Used _GE_InfoInk FILLTEXTPEN _GE_InfoPaper FILLPEN _GE_TextInk TEXTPEN _GE_ItemInk BARDETAILPEN for ks >= v39, 0 for ks < v39 _GE_MessageInk HIGHLIGHTTEXTPEN _GE_ListInk TEXTPEN _GE_FileInk TEXTPEN _GE_DirInk HIGHLIGHTTEXTPEN If you are running Edge on its own private screen you can click on it to cycle through the choices: Status line ink Status line background Text ink Menuitem ink Messages text ink On systems with Kickstart v39 or better there are three more choices: Scroll lists text ink Filerequester file ink Filerequester dir ink When you cycle to the Pen you want, simply click in the color box you desire that pen to be, and when you close the requester with "Save" it will always be that color; when you close with "Use", it will be the color you select only as long as Edge is open. The pen choices shown in the cycle gadget correspond to the following environment variables: Status line ink The _GE_InfoInk variable. The value in _GE_InfoInk is used as the text pen number for the status line. Status line background The _GE_InfoPaper variable. The value in _GE_InfoPaper is used as the background pen number for the status line. Text ink The _GE_TextInk variable. The value in _GE_TextInk is used as the text pen number for the text. NOTE: The number of bitplanes used when scrolling, printing, etc., depends only on the color used, so for best speed and appearance you should select a pen that is a 2^n number, i.e. 1, 2 or 4. NOTE: The color used to mark blocks is located in one of the planes not used by the text, so if you specify a text color that uses all bitplanes, you will not be able to see the block marking. Menuitem ink The _GE_ItemInk variable. The value in _GE_ItemInk is used as the item-text pen number in all Edge and requester menus. (not true for the ASL FileRequester.) Message text ink The _GE_MessageInk variable. The value in _GE_MessageInk is used as the text pen number for all message/info text in Edge, i.e. text that can't be clicked on and simply inform you of something. Scroll lists text ink The _GE_ListInk variable. The value in _GE_ListInk is used as the text pen number in all scroll-list text in Edge. NOTE: This feature works only on Kickstart v39 and better. On pre v39 systems this variable is disabled. Filerequester file ink The _GE_FileInk variable. The value in _GE_FileInk is used as the text pen number for file entries in the FileRequester filelist. NOTE: This feature works only on Kickstart v39 and better. On pre v39 systems this variable is disabled. Filerequester dir ink The _GE_DirInk variable. The value in _GE_DirInk is used as the text pen number for directory entries in the FileRequester filelist. NOTE: This feature works only on Kickstart v39 and better. On pre v39 systems this variable is disabled. For more examples of Global Environment variables, see Global Environment Variables. There are four string gadgets to set the scroll rates. They are arranged like this: | Scroll jumps | ---------|---------|-------|--------- Keyboard select: [#] Vert 1 | -1 [1] | -1 [2]| Vert n | | | Horiz 1 | -1 [3] | -1 [4]| Horiz n ---------|---------|-------|--------- The [#] values here and underlined values in the requester are the keyboard characters to press to get the cursor to appear in the string gadget. To cycle through the active gadgets, press the Tab key; to cycle backwards, use Shift-Tab. The default VALUES are -1. The LEFT column is the amount of scroll for ONE scrolling increment. You may scroll in increments of n. The RIGHT column is for input of the amount of n increments. The -1 default is for the fastest scrolling. The variables represented are as follows, left to right; top to bottom: Vert 1 This gadget holds the contents of the _GE_ScrollJumpV1 variable. The value in _GE_ScrollJumpV1 is used when scrolling the text vertically one line, every time the text is scrolled it is scrolled _GE_ScrollJumpV1 pixels. A value of one gives the smoothest and slowest scroll; a value equal to the font height, or -1, gives the jerkiest but fastest scroll. For example, if the font height is 8 and the value in _GE_ScrollJumpV1 is 2, the text will be scrolled 2 pixels every time the text is scrolled and must therefore be scrolled 4 times to complete a line. (8 / 2 = 4) Keyboard select: '1' Vert n This gadget holds the contents of the _GE_ScrollJumpVn variable. The value in _GE_ScrollJumpVn is used when scrolling the text vertically more than one line. For an explanation of how, see 'Vert 1'. Keyboard select: '2' Horiz 1 This gadget holds the contents of the _GE_ScrollJumpH1 variable. The value in _GE_ScrollJumpH1 is used when scrolling the text horizontally one character. For an explanation of how, see 'Vert 1'. Keyboard select: '3' Horiz n This gadget holds the contents of the _GE_ScrollJumpHn variable. The value in _GE_ScrollJumpHn is used when scrolling the text horizontally more than one character. For an explanation of how, see 'Vert 1'. Keyboard select: '4' At the bottom left there are three action gadgets: Screen Clicking this gadget will display the Screen Settings. Keyboard select: '[' Printer Clicking this gadget will display the Printer Settings. Keyboard select: ']' General Clicking this gadget will display the General Settings. Keyboard select: ' (single quote) At the bottom right there are also three action gadgets: Save OK the requester, use the changes made and save them to the default global settings preferences file, using either the name EdgePrg:Edge.global or the name defined by you at startup using the GLOBAL keyword/tooltype. Keyboard select: 'S' Use OK the requester, use the changes made but don't save them. Keyboard select: 'U' Cancel Cancel the requester, restore the global settings to the state they were in when the requester was opened. Keyboard select: 'C' The Global Settings requester has three menus: Project This menu has five items: Open Load a global settings preference file other than the default one. You will be prompted for a name with the Filerequester. Keyboard equivalent: [Right Amiga] [O] Save As Save the global settings preference file to a file other than the default. You will be prompted for a name with the FileRequester. No keyboard equivalent. Snapshot window Save the current position of the requester window in the global environment and use it the next time the requester is called for. Keyboard equivalent: [Right Amiga] [S] NOTE: If you wish to permanently save the window position you must save the Global Settings to disk. NOTE: If the Global Settings requester window is pointer relative the saved position will NOT be used. Use Selecting this item has the same effect as clicking on the 'Use' gadget. Keyboard equivalent: [Right Amiga] [U] Quit Selecting this item has the same effect as clicking on the 'Cancel' gadget. Keyboard equivalent: [Right Amiga] [Q] Edit This menu has three items: Reset to defaults Restores the global settings to the internal defaults of Edge. Keyboard equivalent: [Right Amiga] [D] Last saved Reloads the global settings preference file, either EdgePrg:Edge.global or the file defined by you at startup with the GLOBAL keyword/tooltype. Keyboard equivalent: [Right Amiga] [L] Restore Restores the global settings to the state they were in when the requester was opened. Keyboard equivalent: [Right Amiga] [R] Options This menu has only one item: Save icon? If enabled, an icon will be created for the global settings preference file when saved. No keyboard equivalent. NOTE: The menus and action gadgets work on the entire global environment, not just the section currently displayed. About the Error list window. The Error list window is used to view all errors currently linked into Edge's error list; if no errors are linked the window will not open, and optionally move the cursor to their position. (Note that the cursor will always be moved to the position to the currently selected error). To move the cursor to the position of errors just click on them with the mouse, use the cursor keys or the 'Top', 'Bottom', 'Next' and 'Previous' gadgets. If you double click on an error the cursor will move to its position and the window will close. The format of the errors displayed are: : At the bottom there are six gadgets: Exit Keep the cursor on its present position and close the window. Keyboard select: 'E' NOTE: The same action is performed by pressing the RETURN key or selecting 'Exit' from the menu. Top Select the first error in the list and move the cursor to its position. Keyboard select: 'T' NOTE: The same action is performed by pressing [Alt] [CursorUp]. Bottom Select the last error in the list and move the cursor to its position. Keyboard select: 'B' NOTE: The same action is performed by pressing [Alt] [CursorDown]. Next Select the next error in the list and move the cursor to its position. Keyboard select: 'N' NOTE: The same action is performed by pressing [CursorDown]. Previous Select the previous error in the list and move the cursor to its position. Keyboard select: 'P' NOTE: The same action is performed by pressing [CursorUp]. Return Close the window and move the cursor the the position it was on when the window was opened. Keyboard select: 'R' NOTE: The same action is performed by pressing [Esc] or selecting 'Return' from the menu. You can also press the HELP key to activate the Edge Help-system which will then display this page. The Error list window's menu has three items: Exit Keep the cursor on its present position and close the window. Keyboard equivalent: [Right Amiga] [E] Return Close the window and move the cursor to the position it was on when the window was opened. Keyboard equivalent: [Right Amiga] [R] Snapshot window Save the current position of the Error list window in the global environment and use it the next time the requester is called for. Keyboard equivalent: [Right Amiga] [S] NOTE: If you wish to permanently save the window position you must save the Global Settings to disk. NOTE: If the Error list window is pointer relative the saved position will NOT be used. NOTE: The Edge ARexx Command for the Error list window is GoToError SHOW. NOTE: If no errors are currently linked the Error list window will not open. The Edge Default Menu --------------------- Menu name Keyboard Edge ARexx Command or Script Item name Command Executed by Menu Selection Subitem name Equivalent or Keyboard Equivalent ------------------ ---------- ---------------------------- Project Clear RCommand N clear Open... RCommand o open Include... RCommand O include Save RCommand s save Save As... RCommand S saveas Print RCommand p print Print To... RCommand p EdgePrg:Rexx/Menu_PrintTo.edge Print As... RCommand P print prompt About... RCommand ? EdgePrg:Rexx/Menu_AboutEdge.edge Technical Support... EdgePrg:Rexx/Menu_AboutEdge.edge TechSupport Version... EdgePrg:Rexx/Menu_AboutEdge.edge Version Iconify... RCommand I iconify Quit Program... RCommand Q quit Windows New Window RCommand w new New Window w/File... RCommand W EdgePrg:Rexx/Menu_OpenNewFile.edge Close Window RCommand q close Activate Window Next RCommand ] activatewindow next Previous RCommand [ activatewindow previous Last One Active RCommand t activatewindow lastactive All Windows To Maximum Size EdgePrg:Rexx/Menu_WinsToFull.edge Panel Vertically EdgePrg:Rexx/Menu_WinsToVert.edge Panel Horizontally EdgePrg:Rexx/Menu_WinsToHorz.edge Resize Window Zoom/UnZoom RCommand z window zip Minimum Size RCommand < window min Maximum Size RCommand > window max Split Window Vertically window splitvertical Horizontally RCommand . window splithorizontal Window Information... RAlt ? EdgePrg:Rexx/Menu_AboutWindow.edge Snapshot Window window snapshot Edit Begin Block RCommand b markblock Begin Column RCommand B markblock columnar Cut RCommand x cut Copy RCommand c copy Paste RCommand v paste Global Clipboard Cut RCommand X cut globalclip Copy RCommand C copy globalclip Paste RCommand V paste globalclip Print Clipboard Local As... printclip prompt Global As... printclip globalclip prompt Erase Block erase Evaluate Block RCommand = EdgePrg:Rexx/Menu_Evaluate.edge Undo RCommand u undo Redo RCommand U redo Enter ASCII... enterascii Find/Replace Find... RCommand F find Repeat Find Forward RCommand f findnext Repeat Find Backwards RCommand a findnext back Replace... RCommand R findreplace Repeat Replace Forward RCommand r findreplacenext Repeat Replace Backwards findreplacenext back Block To Find Buffer RCommand h blocktofindbuff Block To Replace Buffer RCommand H blocktoreplacebuff Word To Find Buffer RAlt h EdgePrg:Rexx/Menu_WordToFind.edge Word To Replace Buffer RAlt H EdgePrg:Rexx/Menu_WordToRep.edge Macros Start/Stop Recording... RCommand m Learn filename ram:Edge.macro Playback Default Macro RCommand , EdgePrg:Rexx/Menu_PlayDefMac.edge Playback 'N Times... EdgePrg:Rexx/Menu_PlayNDefMac.edge Edit Default Macro... EdgePrg:Rexx/Menu_EditDefMac.edge Bind Macro To Key... RCommand M EdgePrg:Rexx/Menu_BindKey.edge Edit A Key... EdgePrg:Rexx/Menu_EditKey.edge Load Macro As Default... EdgePrg:Rexx/Menu_LoadDefMac.edge Save Default Macro As... EdgePrg:Rexx/Menu_SaveDefMac.edge ARexx Send ARexx Command... ESC rx Send ARexx Command Synchronous... rx sync Run ARexx Script... Shift ESC rx filereq Run ARexx Script Synchronous... rx sync filereq Command Shell RAlt ESC EdgePrg:Rexx/Menu_CMDShell.edge Tools AmigaDOS AmigaDOS Shell LAlt ESC EdgePrg:Rexx/Menu_DOSShell.edge Delete File(s)... EdgePrg:Rexx/Menu_DeleteFile.edge Insert Datestamp RCommand d EdgePrg:Rexx/Menu_TimeDate.edge Insert Filename... RCommand i EdgePrg:Rexx/Menu_TypeName.edge Name File... EdgePrg:Rexx/Menu_ChangeName.edge Set Script Flag EdgePrg:Rexx/Menu_ScriptBit.edge Show Files... EdgePrg:Rexx/Menu_Files.edge Case Change Change Case Block swapcase block Upper Case Block RCommand 5 uppercase block Lower Case Block RCommand 6 lowercase block Change Case Word swapcase word Upper Case Word RCommand 7 uppercase word Lower Case Word RCommand 8 lowercase word Change Case Letter swapcase char Upper Case Letter RCommand 9 uppercase word Lower Case Letter RCommand 0 lowercase word Folds Hide NumericPad ( fold hide Show NumericPad ) fold show Hide Nested Shift NumericPad ( fold hidenested Show Nested Shift NumericPad ) fold shownested Hide All RAlt NumericPad ( fold hideall Show All RAlt NumericPad ) fold showall Format Paragraph Left Justified RCommand 1 format left Right Justified RCommand 2 format right Centered RCommand 3 format center Filled RCommand 4 format fill Move To AutoMark RCommand l gotoauto Byte... gotobyte Error RCommand J gotoerror Last Change RCommand G undo Line... RCommand j gotoline Page... RCommand ; gotopage Matching Bracket RCommand } findbracket Set Bookmark #1..#10 RCommand Shift F1..F10 setbookmark Move To Bookmark #1..#10 RCommand F1..F10 gotobookmark INCLUDE EdgePrg:UserTools.menus" IFEXISTS NOTE: If the file 'UserTools.Menu' exists in the EdgePrg: it will be included at the end of the Tools menu. we suggest you have a BAR at the beginning of your menu so you can see where your menu items start and ours end. Settings Local... RCommand e localsettings General... RCommand E globalsettings Print... globalsettings printer Screen... globalsettings screen Windows... globalsettings windows Edit Dictionary EdgePrg:Rexx/Menu_EditConfig.edge DictionaryFile Global Settings EdgePrg:Rexx/Menu_EditConfig.edge GlobalFile Keyboard EdgePrg:Rexx/Menu_EditConfig.edge KeyboardFile Local Settings EdgePrg:Rexx/Menu_EditConfig.edge LocalFile Menus EdgePrg:Rexx/Menu_EditConfig.edge MenusFile Mousebuttons EdgePrg:Rexx/Menu_EditConfig.edge MouseButtonsFile Requesters & Texts EdgePrg:Rexx/Menu_EditConfig.edge TextsFile Templates EdgePrg:Rexx/Menu_EditConfig.edge TemplatesFile Startup Script EdgePrg:Rexx/Menu_EditConfig.edge StartupFile Wakeup Script EdgePrg:Rexx/Menu_EditConfig.edge WakeupFile Reload Config File Dictionary loaddictionary Global Settings EdgePrg:Rexx/Menu_LoadGConfig.edge Keyboard loadkeyboard Local Settings EdgePrg:Rexx/Menu_LoadLConfig.edge Local Settings, Default EdgePrg:Rexx/Menu_LoadDefLConfig.edge Menus loadmenus Mousebuttons loadmousebuttons Requesters & Texts loadtexts Templates loadtemplates Run Startup Script EdgePrg:Rexx/Menu_RunStartup.edge Run Wakeup Script EdgePrg:Rexx/Menu_RunWakeup.edge NOTE: If the file 'User.Menu' exists in the EdgePrg: it will be included in the menu strip. This allows you to add your own custom menus. The Edge Keyboard: Default Configuration ---------------------------------------- Keystroke(s) Action ------------ ------ Up cursor up 1 Down cursor down 1 Left cursor left 1 Right cursor right 1 Help help Delete delete char BackSpace delete char back Shift Up options results;cursor up result-1 Shift Down options results;cursor down result-1 Shift Left previous word Shift Right next word Shift TAB nop Shift Delete options results;cut smallclip word Shift Return newline Shift BackSpace cut smallclip word back Control Up previous page Control Down next page Control Left options results;cursor left result-1 Control Right options results;cursor right result-1 Control Delete cut smallclip line Control BackSpace nop Alt Up position sof Alt Down position eof Alt Left position sol Alt Right position eol Alt Delete cut smallclip eol Alt BackSpace cut smallclip eol Shift Alt Up cursor up 1 Shift Alt Down cursor down 1 Shift Alt Left position sow Shift Alt Right position eow RCommand k cut smallclip line RCommand K paste smallclip RCommand y cut smallclip eol RCommand Y cut smallclip sol RCommand Alt F1 correctword RCommand Alt F2 completetemplate RCommand Alt F3 correctcase NOTE: The following are only valid if Settings/Windows had its KeyPad flag on NumericPad 1 position eof NumericPad 2 cursor down 1 NumericPad 3 next page NumericPad 4 cursor left 1 NumericPad 6 cursor right 1 NumericPad 7 position sof NumericPad 8 cursor up 1 NumericPad 9 previous page NOTE: If the file 'User.Keyboard' exists in EdgePrg: it will be included. This allows you to add your own custom keyboard definitions. Text Table Configuration ------------------------ When Edge is first started it will try to load the text configuration, either the default one EdgePrg:Edge.texts or the one specified by the user with the TEXTS keyword/tooltype. If the file is not found Edge will use its internal defaults instead. You may load another configuration at any time with the LoadTexts command. The text configuration file is made up of several independent sections that may appear in any order, however the format inside the sections is very strict and must be followed or you may end up with some strange text. Between the sections you may optionally place an INCLUDE directive to include another text configuration into the current one. INCLUDES may be nested up to 8 levels before an error is reported. NOTE: When using nested includes the current directory will be set to the path of the included file before the next level of include is called. This is useful when creating files like the 'all.xxx' files in the 'Dictionaries' directories - including all files in the current directory. Each section begins with a name that identifies it (must end with a ':') and it is terminated with a hash sign '#'. Between the name and the '#' you put your data, which must be quoted. If you do not supply a full section the remaining strings will use the internal defaults, as will all lines starting with a semicolon ';' and all sections not supplied by you at all. Below are the different sections and their format listed and explained in such a way that the explanation is located within the quotes where you should write your definition. NOTE: All menu shortcuts in the text configuration file are normal Amiga shortcuts, that is ONE SINGLE CASE-INSIGNIFICANT CHARACTER. They are also optional and may only be supplied if you want them. The EdgeErrors: section is special since after the quoted string you may place a decimal number - which is the error's severity level, click on EdgePrg:Edge.texts to see actual format. Menu_Config ----------- When Edge is first started it will try to load a menu configuration, either the default one EdgePrg:Edge.menus or the one specified by the user with the MENUS keyword/tooltype. If the file is not found Edge will use its internal defaults instead. You may load another configuration at any time with the LoadMenus command. The file is made up of 9 directives: MENU/A/K NAME/A ITEM/A/K COMMKEY/K KEY/K Q/K QM/K COMMAND/A/K/F BAR/K ENDMENU/A/K See next section INCLUDE for an example of the format. This directive is used to define two things: 1) A new menu if no menu is currently being defined. 2) A sub-menu within the current menu. NAME The name of the Menu/Submenu, must be supplied or an error is reported. If the NAME contains any spaces or tabs it must be quoted. To include non-printable characters use '\\xxx' e.g. 'A' = '\\065', 'ö' = '\\246', '' = '\\246', '"' = '\\034','*' = '\\042', etc. ITEM The text "in quotes" for each item in the named menu must be preceeded by the keyword ITEM. Following each item the optional keywords supply keyboard equivalent shortcuts. BAR Use this keyword to separate menu items by a bar or line. KEY Shortcut key for this item, optional. See Keyboard configuration for an explanation of key-sequences. QUALIFIER (or Q) The shortcut key qualifiers to test for. QUALMASK (or QM) The qualifiers to mask out before testing the qualifier. COMMKEY When this keyword is used, a standard menu shortcut key is created; that is, a Right Amiga key with or without shift is automatically generated as your shortcut key qualifier. Using this keyword renders the KEY, QUALIFIER and QUALMASK keywords inoperative. (see next section for example.) COMMAND The command to execute when the item is selected. The command may be an internal command, an ARexx string-program, enclosed within single quotes, or the filename of an ARexx-script or a DOS-command. ENDMENU This keyword appears at the end of the menu column. INCLUDE IFEXISTS/S FILE/A Include another keyboard-configfile. FILE The name of the file to include must be given, or an error is reported. Includes may be nested up to 8 levels before an error is reported. IFEXISTS Switch to suppress the error normally reported if the file does not exists. NOTE: When using nested includes the current directory will be set to the path of the including file before the next level of include is called. This is useful when creating files like the 'all.xxx' files in the 'Dictionaries' directories - including all files in the current directory. All lines not beginning with one of those directives, not counting initial tabs and spaces, are taken as comments and ignored. Click the button to see the actual default menu config file. Keyboard_Config --------------- When Edge is first started it will try to load a keyboard configuration, either the default one EdgePrg:Edge.keyboard or the one specified by the user with the KEYBOARD keyword/tooltype. If the file is not found Edge will use its internal defaults instead. This initial loading is always performed with the FORCE switch present; e.g. no requester will pop up on keys defined more than once - the last definition will be the active one. You may load another configuration at any time with the LoadKeyboard command. The keyboard file is made up of two directives: KEYCOM KEY/A,Q=QUALIFIER/K,QM=QUALIFIER/K,COMMAND/A/F This directive is used to define a keyboard command. KEY The actual key to press, without qualifiers, allowed keys are: Any single key you can create on the keyboard 'a', '!', '' = '\\246', '"' = '\\034', '*' = '\\042', etc. QUALIFIER The qualifiers that must be pressed in order for the KEY to be valid. Available qualifiers are: SHIFT Either shift key LSHIFT Left shift key RSHIFT Right shift key ALT Either alt key LALT Left alt key RALT Right alt key CONTROL Control key RCOMMAND Right amiga key LCOMMAND Left amiga key NUMERICPAD A key on the numeric keypad NOTE: The qualifiers not given must not be pressed for the KEY to be valid. NOTE: CAPSLOCK always ignored when dealing with key-sequences. QUALMASK The qualifiers that are to be masked out before the qualifier test is made. A few examples to show how this works: KEY "2" Q "shift" Depress shift and no other qualifier and press '2'. KEY "@" QM "shift alt" The '@' character, ignore shift and alt qualifiers. KEY="C" Q="control" QM="shift" Depress control and shift and press 'c' assuming 'C' is mapped to shift 'c'. KEY "c" Q="control shift" Depress control and shift and press 'c'. KEY "?" Q="rcommand" QM="shift" Right amiga and '?', wherever it may be. KEY "f10" Function key 10, with no qualifiers. KEY "+" Q="numericpad" The '+' key on the numeric keypad. By using the QUALMASK and ignoring qualifiers, especially shift, gives greater flexibility for different keymaps, by not using the QUALMASK will give you greater control over exactly which keys to press. COMMAND The command to execute may be an internal command, an ARexx string program, enclosed within single quotes, or the name of a ARexx script or dos-command. INCLUDE FILE/A,FORCE/S,IFEXISTS/S Include another keyboard-configfile. FILE The name of the file to include must be given, or an error is reported. Includes may be nested up to 8 levels before an error is reported. FORCE Suppresses the requester that will pop up if a key already exists, asking you if overwriting is OK. IFEXISTS Switch to suppress the error normally reported if the file does not exists. NOTE: When using nested includes the current directory will be set to the path of the including file before the next level of include is called. This is useful when creating files like the 'all.xxx' files in the 'Dictionaries' directories - including all files in the current directory. All lines not beginning with any of the directives, not counting leading spaces and tabs, are treated as comments and ignored. Click the button to see the actual default keyboard config file. MouseButton_Config ------------------ When Edge is first started it will try to load a mouse button configuration, either the default one EdgePrg:Edge.mousebuttons or the one specified by you with the KEYBOARD keyword/tooltype. If the file is not found no mouse button commands will be installed. This initial loading is always performed with the FORCE switch present, i.e. no requester will pop up on buttons defined more than once - the last definition will be the active one. You may load another configuration at any time with the LoadMouseButtons command. The mouse button config file is made up of two directives: MOUSECOM BUTTON/A,Q=QUALIFIER/K,QM=QUALMASK/K,COMMAND/A/F This directive is used to define a mouse button command. BUTTON The mouse click sequence to press, allowed types are: DOUBLELEFT Double-click the left button. DOUBLEMIDDLE Double-click the middle button. LEFTMIDDLE Depress left button and click middle button. LEFTRIGHT Depress left button and click right button. MIDDLELEFT Depress middle button and click left button. MIDDLERIGHT Depress middle button and click right button. NOTE: The following four click sequences are extensions to the four last sequences listed above. The commands installed using the above click sequences will ALWAYS be executed BEFORE the commands installed using the click sequences below. Care should be taken when using the four click sequences below, since it is impossible to avoid the execution of the commands installed with the click sequences above. However, the default mouse button configuration file shows a good example of where those click sequences can be made useful. LEFTDOUBLEMIDDLE Depress left button and double-click middle. LEFTDOUBLERIGHT Depress left button and double-click right. MIDDLEDOUBLELEFT Depress middle button and double-click left. MIDDLEDOUBLERIGHT Depress middle button and double-click right. QUALIFIER The keyboard qualifiers to test for. See Keyboard configuration for an explanation of key-sequences. QUALMASK The keyboard qualifiers to mask out before testing the qualifier. An explanation of the above: If Q = shift and QM = alt then that means that you MUST depress either shift-key for the click sequence to be valid, but whether you depress any alt key as well is insignificant. COMMAND The command to execute may be an internal command, an ARexx string program, enclosed within single quotes, or the name of an ARexx script or dos-command. INCLUDE FILE/A,FORCE/S,IFEXISTS/S Include another mouse button configfile. FILE The name of the file to include must be given, or an error is reported. Includes may be nested up to 8 levels before an error is reported. FORCE Suppresses the requester that will pop up if a key already exists, asking you if overwriting is OK. IFEXISTS Switch to suppress the error normally reported if the file does not exists. NOTE: When using nested includes the current directory will be set to the path of the included file before the next level of include is called. This is useful when creating files like the 'all.xxx' files in the 'Dictionaries' directories - including all files in the current directory. All lines not beginning with any of the directives, not counting leading spaces and tabs, are treated as comments and ignored. Click the following button to see the actual config file for mousebuttons. EdgePrg:Edge.mousebuttons Template_Config --------------- When Edge is first started it will try to load a template configuration, either the default one EdgePrg:Edge.templates or the one specified by you with the TEMPLATES keyword/tooltype. If the file is not found no templates will be installed. This initial loading is always performed with the FORCE switch present; i.e. no requester will pop up on templates defined more than once - the last definition will be the active one. You may load another configuration at any time with the LoadTemplates command. The template config file is made up of two directives: TEMPLATE TEMPLATE/A,FILL/A/F This directive is used to define a template. TEMPLATE The text used to check for a match, i.e. identify the template. Case is not important. If a template already exists and the FORCE switch is not on, a requester will pop up asking you about which definition to use. FILL The text to fill in if the template matches. The characters used to match the template will be overwritten when this text is inserted. There are two special characters you may use in the fill-text: '@' Position the cursor on the character after this when the fill-text has been filled in. '«' Insert a 'backspace' in the fill-text. To include a true '@' or '«' simply type two. To include non printing characters use decimal code: '\\xxx' e.g. '\\169' = '-', '\\065' = 'A', '\\010' = LF, etc. INCLUDE FILE/A,FORCE/S,IFEXISTS/S Include another template configfile. FILE The name of the file to include must be given, or an error is reported. Includes may be nested up to 8 levels before an error is reported. FORCE Suppresses the requester that will pop up if a key already exists, asking you if overwriting is OK. IFEXISTS Switch to suppress the error normally reported if the file does not exists. NOTE: When using nested includes the current directory will be set to the path of the included file before the next level of include is called. This is useful when creating files like the 'all.xxx' files in the 'Dictionaries' directories - including all files in the current directory. All lines not beginning with any of the directives, not counting leading spaces and tabs, are treated as comments and ignored. Click the following to see an example config file, the 'C_Templates' file included with Edge in the 'Templates' directory. EdgePrg:templates/C_Templates Dictionary_Config ----------------- When Edge is first started it will try to load a dictionary configuration, either the default one EdgePrg:Edge.dictionary or the one specified by you with the DICTIONARY keyword/tooltype. If the file is not found no dictionary will be installed. This initial loading is always performed with the FORCE switch present; i.e. no requester will pop up on words defined more than once - the last definition will be the active one. The dictionary is used with the CorrectCase and CorrectWord functions, and you must have a dictionary for those functions to work. You may load another configuration at any time with the LoadDictionary command. The dictionary config file is made up of two directives: WORD WORD/A This directive is used to define a word in the dictionary. WORD The word you wish to add to the dictionary. If it already exists and the FORCE switch is not given a requester will pop up asking you about which definition to use. INCLUDE FILE/A,FORCE/S,IFEXISTS/S Include another dictionary configfile. FILE The name of the file to include must be given, or an error is reported. Includes may be nested up to 8 levels before an error is reported. FORCE Suppresses the requester that will pop up if a key already exists, asking you if overwriting is OK. IFEXISTS Switch to suppress the error normally reported if the file does not exists. NOTE: When using nested includes the current directory will be set to the path of the including file before the next level of include is called. This is useful when creating files like the 'all.xxx' files in the 'Dictionaries' directories - including all files in the current directory. All lines not beginning with any of the directives, not counting leading spaces and tabs, are treated as comments and ignored. Click the following button to see an example of a 'C_dictionary' included in the 'Dictionaries' directory on disk. EdgePrg:Dictionaries/C_dictionary ARexx Macros ------------ ARexx Commands and Macros in Edge ARexx Commands must be sent to an ARexx command Host or a Port Name. If you are within Edge you may send ARexx Commands to Edge itself. These are called macros. In the "Macros/Bind Macro to Key" menu, you may sample for a "hot-key" sequence of keystrokes. After you OK the key sequence, a file requester opens and you may choose the ARexx program you want executed every time the hot-key sequence is pressed (with Edge running, of course). Later if you want to assign another macro to that hot-key sequence use the "Macros/Edit a Key" menu. In this way, you may customize Edge as much as you want. If you want to bind a single ARexx command to a key, it is best done by editing the keyboard file directly, as you don't need to maintain a file for the command as you do when you bind a macro to a key. Use the Settings/Edit/Keyboard menu to open the keyboard configuration file. NOTE: Edge has an ARexx or host address which is case sensitive. The primary ARexx port is normally "EDGE" and is also the screen title text. Normally you won't talk to this port. Additionally, each window in turn opens its own ARexx port with the following syntax (case sensitive): --------------------------------------------------------------------------- EDGE1.1.2 means Edge, window 1, view 2 EDGE1.3.4 means Edge, window 3, view 4 --------------------------------------------------------------------------- If your ARexx macro needs to send commands between windows, then you need to do an address instruction to change the current address to the window you want to send the command to. There is a rich ARexx command set for Edge, and there are plenty of example programs to use or learn from. Teaching you to program in ARexx is beyond the scope of this on-line help. Click for more info See ARexx commands for more information Commands -------- See ARexx macros & hot-keys for more information Edge ARexx Command Set All commands return their result in the ARexx RESULT variable; the RC variable indicates failure or success (0=success, any other value is severity level on the error that occurred). About SHOW/S,VERSION/S,TECHSUPPORT/S ActivateWindow PORT,TOP/S,BOTTOM/S,NEXT/S,PREVIOUS/S,LASTACTIVE/S, CURRENT/S AddErr LINE/A/N,CHAR/A/N,MESSAGE/A AddressOf FILENAME,FULLNAME,TOP/S,BOTTOM/S,NEXT/S,PREVIOUS/S, TW=TOPWINDOW/S,BW=BOTTOMWINDOW/S,NW=NEXTWINDOW/S, PW=PREVIOUSWINDOW/S BeepScreen , BlockInfo , BlockOff , BlockToBuff ADDRESS/A/N,MAXSIZE/A/N BlockToFindBuff , BlockToReplaceBuff , ChangeWindow LEFTEDGE/N,TOPEDGE/N,WIDTH/N,HEIGHT/N,DELTAX/N,DELTAY /N,DELTAW/N,DELTAH/N CheckAbort , Clear FORCE/S,RESTORELS/S ClearClip GC=GLOBALCLIP/S ClearErr , Close FORCE/S,FORCEREXX/S,FORCEOK/S,SAVE/S,ICON/S,NOICON/S, BACKUP/S,NOBACKUP/S,NOQUIT/S CloseRexxIO , CompleteTemplate TEMPLATE Copy GC=GLOBALCLIP/S,SC=SMALLCLIP/S,CHAR/S,WORD/S,BACK/S, LINE/S,SOL/S,EOL/S,APPEND/S,RB=RESULTBUFF/S CorrectCase WORD CorrectWord WORD CurrentDir DIRNAME Cursor UP/N,DOWN/N,LEFT/N,RIGHT/N Cut GC=GLOBALCLIP/S,SC=SMALLCLIP/S,CHAR/S,WORD/S,BACK/S, LINE/S,SOL/S,EOL/S,APPEND/S,RB=RESULTBUFF/S Delete CHAR/S,WORD/S,BACK/S,LINE/S,SOL/S,EOL/S Dictionary WORD/A,ADD/S,FORCE/S,REMOVE/S DisableUser , EnableUser , EnterASCII ASCII/N Erase , Fault ERRNUM/N,RAW/S Find FIND,UCEQLC/N,FORWARD/N,WILDCARD/N,WORDS/N,CIRCULAR/N FindBracket , FindCFunction , FindIMark MARK/A/N FindLabel , FindNext BACK/S FindReplace ONCE/S,ALL/S,FIND,CHANGE,UCEQLC/N,FORWARD/N,WILDCARD/ N,WORDS/N,CIRCULAR/N FindReplaceNext ONCE/S,ALL/S,BACK/S Flag FIELD/A,FLAG/A,T=TOGGLE/S,S=SET/S,C=CLEAR/S Fold SHOW/S,HIDE/S,SHOWNESTED/S,HIDENESTED/S,SHOWALL/S, HIDEALL/S Font NAME,SIZE/N,SCREEN/S,TEXT/S,GADGET/S,BOLD/S,ITALIC/S, UNDERLINE/S,SCALE/S Format LEFT/S,RIGHT/S,CENTER/S,FILL/S GetENVVar NAME/A,RAW/S GlobalSettings PRINTER/S,SCREEN/S,WINDOWS/S GoToAuto , GoToBookMark MARK/A/N GoToByte BYTE/N GoToColumn COLUMN/N GoToError ERRNUMBER/N,PREVIOUS/S,SHOW/S GoToLine LINE/N GoToPage PAGE/N Help HELPFILE/K,SECTION,LOADINDEX/S,LOADALL/A,CACHENODE/S, KEEPCACHE/S,QUIT/S Iconify FORCE/S,FORCEREXX/S,FORCEOK/S,SAVE/S,ICONS/S,NOICONS/ S,BACKUPS/S,NOBACKUPS/S Include FILENAME KeyBoard KEY/A,Q=QUALIFIER/K,QM=QUALMASK/K,ASK/S,FORCE/S, COMMAND/F Learn FILENAME LoadDictionary FILENAME,FORCE/S,APPEND/S LoadENV FILENAME,GE/S,LE/S,DEFLE/S,PATTERN LoadKeyboard FILENAME,FORCE/S,APPEND/S LoadMenus FILENAME,APPEND/S LoadMouseButtons FILENAME,FORCE/S,APPEND/S LoadTexts FILENAME,APPEND/S LoadTemplates FILENAME,FORCE/S,APPEND/S LocalSettings , LowerCase CHAR/S,WORD/S,BACK/S,LINE/S,SOL/S,EOL/S,BLOCK/S MarkBlock COLUMNAR/S EdgeToBack , EdgeToFront , MouseButton BUTTON/A,Q=QUALIFIER/K,QM=QUALMASK/K,ASK/S,FORCE/S, COMMAND/F MovePage UP/N,DOWN/N,LEFT/N,RIGHT/N,CENTER/S MoveScreen LEFTEDGE/N,TOPEDGE/N,DELTAX/N,DELTAY/N New PORTNAME/K,LEFTEDGE/N,TOPEDGE/N,WIDTH/N,HEIGHT/N, ZOOMLEFTEDGE/N,ZOOMTOPEDGE/N,ZOOMWIDTH/N,ZOOMHEIGHT/ N,PATH,NAME,COPYLS/S NewLine NI=NOINDENT/S,I=INDENT/S,TI=TOGGLEINDENT/S Next WORD/S,PAGE/S Nop , Open FILES/M,FORCE/S,RESTORELS/S,PATH/K OpenClip FILENAME,GC=GLOBALCLIP/S,APPEND/S Paste GC=GLOBALCLIP/S,GCC=GLOBALCLIPCOLUMNAR/S,SC=SMALLCLIP /S Position LINE/N,COLUMN/N,CHAR/N,SOF/S,EOF/S,SOL/S,EOL/S,SOW/S, EOW/S,SOP/S,EOP/S Previous WORD/S,PAGE/S Print PROMPT/S PrintClip GC=GLOBALCLIP/S,PROMPT/S PutENVVar NAME/A,VALUE/A Quit FORCE/S,FORCEREXX/S,FORCEOK/S,SAVE/S,ICONS/S,NOICONS /S,BACKUPS/S,NOBACKUPS/S Redo , RequestFile TITLE/K,PATH,FILE,PATTERN,DIR/S,SAVE/S,GETDIR/S, MULTISELECT/S RequestKey TITLE/K,ALTSAME/N,SHIFTSAME/N,QMALT/N,QMSHIFT/N, SAMPLE/S RequestNotify TITLE/K,STRING/A/F RequestNumber TITLE/K,DEFAULT/N,MIN/N,MAX/N,SHOWLIMITS/S RequestChoice TITLE/K,STRING/A/F,PG=POSITIVEGADGET/K,NG=NEGATIVEGADGET /K RequestString TITLE/K,DEFAULT,TRANSLATE/S RX SYNC/S,FILEREQ/S,PATH/K,FILE/K,PATTERN/K, STOP=STOPLEARNING/S,COMMAND/F Save ICON/S,NOICON/S,BACKUP/S,NOBACKUP/S SaveAs FILENAME,FORCE/S,ICON/S,NOICON/S,BACKUP/S,NOBACKUP/S SaveChanges ICONS/S,NOICONS/S,BACKUPS/S,NOBACKUPS/S SaveClip FILENAME,FORCE/S,GC=GLOBALCLIP/S,ICON/S,NOICON/S SaveDictionary FILENAME,FORCE/S SaveENV FILENAME,GE/S,LE/S,DEFLE/S,FORCE/S,PATTERN SaveKeyboard FILENAME,FORCE/S SaveMenus FILENAME,FORCE/S SaveMouseButtons FILENAME,FORCE/S SaveTexts FILENAME,FORCE/S SaveTemplates FILENAME,FORCE/S ScreenMode MONITOR,WIDTH/N,HEIGHT/N,DEPTH/N,DETAILPEN/N, BLOCKPEN/N,TEXTPEN/N,SHINEPEN/N,SHADOWPEN/N,FILLPEN /N,FILLTEXTPEN/N,BACKGROUNDPEN/N,HIGHLIGHTTEXTPEN/N, BARDETAILPEN/N,BARBLOCKPEN/N,BARTRIMPEN/N Select FILENAME,FULLNAME,TOP/S,BOTTOM/S,NEXT/S,PREVIOUS/S SetBookMark MARK/A/N SwapCase CHAR/S,WORD/S,BACK/S,LINE/S,SOL/S,EOL/S,BLOCK/S Template TEMPLATE/A,ASK/S,FORCE/S,FILL/F Text TEXT/A,RAW/S Undo , UpperCase CHAR/S,WORD/S,BACK/S,LINE/S,SOL/S,EOL/S,BLOCK/S Wakeup , Window SV=SPLITVERTICAL/S,SH=SPLITHORIZONTAL/S,CLOSE/S, FORCE/S,FORCEREXX/S,FORCEOK/S,SNAPSHOT/S,MIN/S,MAX/S, FRONT/S,BACK/S,ZOOM/S,UNZOOM/S,ZIP/S WindowTitle MESSAGE/A,DISPLAYTIME/N About ----- FORMAT About SHOW/S,VERSION/S,TECHSUPPORT/S DESCRIPTION If the SHOW switch is present the about string will be displayed using the Notify requester and in this case the function will not return until the user closes the Notify requester. Specify TECHSUPPORT to get information about how and where to contact technical support. Specify VERSION to get version information about Edge, Kickstart, Workbench and your computer. Without VERSION and TECHSUPPORT specified About will give copyright information, mailing addresses and phone numbers. INPUTS SHOW - Use this flag to display the about string with a Message requester. VERSION - Get version information TECHSUPPORT - Get technical support information RESULTS A string containing information on the selected topic. ActivateWindow -------------- FORMAT ActivateWindow PORT,TOP/S,BOTTOM/S,NEXT/S,PREVIOUS/S,LASTACTIVE/S,CURRENT/S DESCRIPTION Activate a window for USER input. Take care when using this function from ARexx, since the host address doesn't change. If you wish to change the host address to that of the activated window you must 'address value result' using the result from this function. INPUTS PORT - Activate the Edge window with the given ARexx address, if the port is not found no window will be activated. TOP - Activate the first window in the first file. BOTTOM - Activate the last window in the last file. NEXT - Activate the next window in the window list. PREVIOUS - Activate the previous window in the window list. LASTACTIVE - Activate the window previously active, useful for toggling between two windows. CURRENT - Activate the Edge window attached to the current ARexx address. NOTE NEXT and PREVIOUS are circular, which means that if the current window is the last one and you specify NEXT you will activate the first window in the first file, and if the current window is the first one and you specify PREVIOUS you will activate the last window in the last file. If no switches are specified the last text window receiving input from the user will be activated. You may only specify one of the switches at a time. RESULTS The ARexx-address of the activated window. AddErr ------ FORMAT AddErr CHAR/A/N,LINE/A/N,MESSAGE/A DESCRIPTION Add an error message to the error list. INPUTS CHAR - Character offset on the line. LINE - Line-number where the error occurred. MESSAGE - The error/warning message itself. AddressOf --------- FORMAT AddressOf FILENAME,FULLNAME,TOP/S,BOTTOM/S,NEXT/S,PREVIOUS/S, TW=TOPWINDOW/S,BW=BOTTOMWINDOW/S,NW=NEXTWINDOW/S, PW=PREVIOUSWINDOW/S DESCRIPTION Get the ARexx-address of an Edge window. If no parameters are specified the address of the current window will be returned. INPUTS FILENAME - Get the address of the first window in the file with the given filename; the search is made ignoring the Edge path components. FULLNAME - Get the address of the first window in the file with the given filename; the search is made taking into account the Edge path componets. TOP - Get the address of the first window in the first file. BOTTOM - Get the address of the first window in the last file. NEXT - Get the address of the first window in the next file. PREVIOUS - Get the address of the first window in the previous file. TW - Get the address of the first window in the window list. BW - Get the address of the last window in the window list. NW - Get the address of the next window in the window list. PW - Get the address of the previous window in the window list. NOTE NEXT and PREVIOUS are circular which means that if the current file is the last one and you specify NEXT you will get the address of the first file, and if the current file is the first one and you specify PREVIOUS you will get the address of the last file. The same goes for the window switches and the window list. You may only specify one of the parameters at a time. RESULT The ARexx-address of the specified file. BeepScreen ---------- FORMAT BeepScreen , DESCRIPTION Flash the screen Edge is running on. BlockInfo --------- FORMAT BlockInfo , DESCRIPTION Returns information on the currently selected block. If no block is currently selected an error is returned. RESULTS The info returned are five decimal numbers and a word; the start line and column of the block, the current (end of block) line and column, the byte-size of the block and a flag telling you whether the block is a "Normal" block or a "Columnar" one. BlockOff -------- FORMAT BlockOff , DESCRIPTION Turn off block mode. BlockToBuff ----------- FORMAT BlockToBuff ADDRESS/A/N,MAXSIZE/A/N DESCRIPTION Copies the currently selected block to the buffer starting at the given address, but copies no more than MAXSIZE bytes. Use with caution since it is easy to cause a memory overwrite. INPUTS ADDRESS - Decimal address, pointing to the start of the buffer. MAXSIZE - Maximun number of bytes that may be transferred (allocated size of the buffer). RESULTS The actual number of bytes copied. BlockToReplaceBuff ------------------ FORMAT BlockToReplaceBuff , DESCRIPTION Copies the currently selected block to the _FE_ReplaceString buffer. RESULTS The number of bytes copied. BlockToFindBuff --------------- FORMAT BlockToFindBuff , DESCRIPTION Copies the currently selected block to the _FE_FindString buffer. RESULTS The number of bytes copied. ChangeWindow ------------ FORMAT ChangeWindow LEFTEDGE/N,TOPEDGE/N,WIDTH/N,HEIGHT/N,DELTAX/N,DELTAY/N, DELTAW/N,DELTAH/N DESCRIPTION Changes the size and/or the position of an Edge text window. To find out what the size/position actually became, use the Window command. INPUTS LEFTEDGE - Move the window to this absolute X position. TOPEDGE - Move the window to this absolute Y position. WIDTH - Change the window's width to this absolute width. HEIGHT - Change the window's height to this absolute height. DELTAX - Move the window horizontally this amount relative to the current or specified absolute X position. DELTAY - Move the window vertically this amount relative to the current position or specified absolute Y position. DELTAW - Change the window's width with this amount relative to the current or specified absolute width. DELTAH - Change the window's height with this amount relative to the current or specified absolute height. CheckAbort ---------- FORMAT CheckAbort , DESCRIPTION This command used to check if CTRL-C has been pressed by the user, if so the user abort error is returned, e.g. RC=~0. If CTRL-C has not been pressed RC will equal 0. NOTE: The state of the CTRL-C flag is cleared by this command. The Menu_PlayNDefMac.edge script uses this command to see if the user wants to abort while playing back the default macro. RESULTS RC~=0 if CTRL-C has been pressed, RC=0 if not. Clear ----- FORMAT Clear FORCE/S,RESTORELS/S DESCRIPTION Clears the current file, flushes the undo-buffer and optionally resets the local settings to default. The FORCE switch suppresses the requester that will pop up if any changes have been made to the file, asking the user to confirm that losing the changes is OK. If the RESTORELS switch is present the local settings will be loaded with defaults; if not present the settings are kept as they are. INPUTS FORCE - Suppresses the requester prompting the user about losing any changes. RESTORELS - Loads the local settings with default values. RESULTS The new name for this file. ClearClip --------- FORMAT ClearClip GC=GLOBALCLIP/S DESCRIPTION Clears the selected clipboard, global if GLOBALCLIP is specified, else the local one, and free all memory used. INPUTS GLOBALCLIP - Flag to select the global clip for clearing. ClearErr -------- FORMAT ClearErr , DESCRIPTION Clears the error list, removes all errors linked and frees all memory used. You should use this command before you start a new assembly/compilation. Close ----- FORMAT Close FORCE/S,FORCEREXX/S,FORCEOK/S,SAVE/S,ICON/S,NOICON/S,BACKUP/S, NOBACKUP/S,NOQUIT/S DESCRIPTION Quits the current file. If the current file is the last one then Edge will either iconify or quit depending on the DORMANTQUIT flag in _GE_Flags. The FORCE switch suppresses the requester that will pop up if any changes have been made to the file, asking the user to confirm that losing the changes is OK. The FORCEREXX switch suppresses the requester that will pop up if any of the file windows have any outstanding ARexx messages (the requester is only visually suppressed - the outstanding messages must return before the editor can be unloaded). The FORCEOK switch suppresses the requester that pops up if no changes are made and no ARexx messages are outstanding, asking if quitting the file is OK. If the SAVE switch is present the file will be saved before it is closed. The ICON, NOICON, BACKUP and NOBACKUP switches are used to force or suppress icon and backup creation when saving. The NOQUIT switch is used to make sure that Edge will not unload/iconify if the last file is force closed. INPUTS BACKUPS - Forces create backups for all files saved. FORCE - Suppresses the requester asking the user about losing any changes. FORECEOK - Suppresses the 'OK to close file..' requester. FORCEREXX - Suppresses the 'ARexx outstanding messages' requester. SAVE - Saves the file before it is closed. ICON - Forces create an icon. NOICON - Suppresses icon creation. BACKUP - Forces a backup to be saved. NOBACKUP - Suppresses backup creation. NOQUIT - Switch to suppress quiting the editor if the last file is force Closed. CloseRexxIO ----------- FORMAT CloseRexxIO , DESCRIPTION When used, CloseRexxIO will tag the ARexx Input/Output (IO) stream so when all outstanding ARexx messages have returned, the ARexx IO stream will be closed regardless of setfont, close delay, etc. INPUTS None CompleteTemplate ---------------- FORMAT CompleteTemplate TEMPLATE DESCRIPTION Searches the template-list for a match to TEMPLATE or the word currently under the cursor. If a match, and only one, is found then if a TEMPLATE was specified the fill-text is returned as the result and if no TEMPLATE was given the fill-text is inserted into the file. NOTE: In order to match a template you need only give enough characters to uniquely separate it from the rest of the templates, i.e. if 'while' is the only template beginning on 'w' you need only give a 'w' in order to get a match. NOTE: You must have loaded a template configuration or created at least one template with the Template command in order for this function to do anything. The fill-text may contain two special characters: '@' Position the cursor on the character after this one when the fill-text has been inserted. '«' Insert a 'backspace'. To include a true '@' or '«' simply type two in a row '@@' or '««'. INPUTS TEMPLATE - Template to match or nothing to use the word under the cursor. RESULTS If a TEMPLATE is given the fill-text is not inserted into the file but returned as the result from this function. On the other hand, if no TEMPLATE is given the fill-text is inserted and the final cursor position is returned as the result. Copy ---- FORMAT Copy GC=GLOBALCLIP/S,SC=SMALLCLIP/S,CHAR/S,WORD/S,BACK/S,LINE/S,SOL/S, EOL/S,APPEND/S,RB=RESULTBUFF/S DESCRIPTION Copies the currenly selected block to one of the clipboards. If GLOBALCLIP is specified the text will be copied to the global clipboard; if SMALLCLIP is specified the text will be copied to the small clipboard; and if RESULTBUFF is specified the text will be copied to the ARexx result buffer, else the text will be copied to the local clipboard. The contents of the small clipboard are found in the Edge environment variable _FE_SmallClip. With normal block operations you must first select or mark the text you wish to copy to a clipboard, but that is not the case with the following switches: CHAR, WORD, LINE, SOL, and EOL. When you specify any of those switches the selected entity will be automatically marked and copied to the selected clipboard. If the APPEND flag is specified the newly copied text is not just put into the specified clip but joined to the end of what is already in the clip - with this switch you can merge text from different places into the clip and then insert it all in one go. INPUTS GLOBALCLIP - Flag to select the globalclip. SMALLCLIP - Flag to select the smallclip. CHAR - Auto mark and copy the character under the cursor. WORD - Auto mark and copy the word beginning under and extending to the right of the cursor plus trailing spaces. BACK - This flag only works together with CHAR and WORD. If given the text to the left of the cursor is copied instead of the text to the right. LINE - Auto mark and copy the whole current line. SOL - Auto mark and copy all characters from the start of the line to the cursor, not including the character under the cursor. EOL - Auto mark and copy all characters from the cursor, including the character under the cursor, to the end of the line. APPEND - Merge mode. RESULTBUFF - Copies to the ARexx result buffer, note that blocks larger than 1k will be truncated. CorrectCase ----------- FORMAT CorrectCase WORD DESCRIPTION Searches the dictionary for a case-insignificant match to WORD or the word currently under the cursor. If a match is found then if a WORD was specified the word found in the dictionary is returned as the result and if no WORD was given the word under the cursor will be replaced with the word found in the dictionary. NOTE: In order to get a match the word must be spelled correctly. NOTE: You must have loaded a dictionary or created at least one entry in the dictionary with the Dictionary command in order for this function to do anything. INPUTS WORD - Word to correct or nothing to use the word under the cursor. RESULTS The word found in the dictionary. CorrectWord ----------- FORMAT CorrectWord WORD DESCRIPTION Searches the dictionary for the best fitting word according to WORD or the word currently under the cursor. If a match is found then if a WORD was specified the word found in the dictionary is returned as the result and if no WORD was given, the word under the cursor will be replaced with the word found in the dictionary. NOTE: You must have loaded a dictionary or created at least one entry in the dictionary with the Dictionary command in order for this function to do anything. NOTE: Edge uses a best fit function to try to correct the given word. If it is spelled too badly Edge will not be able to correct it. However - Edge would rather guess than fail, so if you try to correct a word that is not in the dictionary you may end up with the closest thing Edge could find. This should not be a problem since it is easy to undo changes. NOTE: The first letter must be correct and enough letters typed for the correction to have a chance to be successful; i.e. you can not type 'sewiti' and hope that it will be corrected to 'SetWindowTitles'. INPUTS WORD - Word to correct or nothing to use the word under the cursor. RESULTS The word found in the dictionary. CurrentDir ---------- FORMAT CurrentDir DIRNAME DESCRIPTION Changes the current directory for Edge. If the DIRNAME is not present the user will be prompted with the FileRequester to select a directory. INPUTS DIRNAME - The new current directory, or nothing to prompt the user. RESULTS The old current directorypath. Cursor ------ FORMAT Cursor UP/N,DOWN/N,LEFT/N,RIGHT/N DESCRIPTION Moves the cursor. You may give more than one argument in order to move the cursor both horizontally and vertically with one call. The vertical movement is always executed first. The horizontal movement will not wrap at sol/eol. INPUTS UP - Number of lines to move up, towards sof. DOWN - Number of lines to move down, towards eof. LEFT - Number of characters to move left, towards sol. RIGHT - Number of characters to move right, towards eol. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. Cut --- FORMAT Cut GC=GLOBALCLIP/S,SC=SMALLCLIP/S,CHAR/S,WORD/S,BACK/S,LINE/S,SOL/S, EOL/S,APPEND/S,RB=RESULTBUFF/S DESCRIPTION Cuts the currently selected block from the file to one of the clipboards. If GLOBALCLIP is specified the text will be cut to the global clipboard; if SMALLCLIP is specified the text will be cut to the small clipboard; and if RESULTBUFF is specified the text will be cut to the ARexx result buffer, else the text will be cut to the local clipboard. The contents of the small clipboard is found in the Edge environment variable _FE_SmallClip. With normal block operations you must first select or mark the text you wish to cut to a clipboard, but that is not the case with the following switches: CHAR, WORD, LINE, SOL, and EOL. When you specify any of those switches the selected entity will be automatically marked and cut to the selected clipboard. If the APPEND flag is specified the newly cut text is not just put into the specified clip but joined to the end of that which is already in the clip - with this switch you can merge text from different places into the clip and then insert it all in one go. INPUTS GLOBALCLIP - Flag to select the globalclip. SMALLCLIP - Flag to select the smallclip. CHAR - Auto mark and cut the character under the cursor. WORD - Auto mark and cut the word beginning under and extending to the right of the cursor plus trailing spaces. BACK - This flag only works together with CHAR and WORD. If given the text to the left of the cursor is cut instead of the text to the right. LINE - Auto mark and cut the whole current line. SOL - Auto mark and cut all characters from the start of the line to the cursor, not including the character under the cursor. EOL - Auto mark and cut all characters from the cursor, including the character under the cursor, to the end of the line. APPEND - Merge mode. RESULTBUFF - Cuts to the ARexx result buffer, note that blocks larger than 1k will be truncated. Delete ------ FORMAT Delete CHAR/S,WORD/S,BACK/S,LINE/S,SOL/S,EOL/S DESCRIPTION Delete characters in some different and useful ways. INPUTS CHAR - Delete the character under the cursor; the text to the right of the deleted character is moved to the left. The cursor is not moved. WORD - Delete the word beginning under and extending to the right of the cursor plus trailing spaces; the text to the right of the deleted word is moved to the left. The cursor is not moved. BACK - This flag only works together with CHAR and WORD. If given the text to the left of the cursor is deleted instead of the text to the right. LINE - Delete the whole current line. SOL - Delete all characters from the start of the line to the cursor, not including the character under the cursor. EOL - Delete all characters from the cursor, including the character under the cursor, to the end of the line. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. Dictionary ---------- FORMAT Dictionary WORD/A,ADD/S,FORCE/S,REMOVE/S DESCRIPTION Inquires about, removes or adds a word to the dictionary. If no switches are given the current definition of WORD will be returned, if it exists. INPUTS WORD - The word you wish to affect. ADD - Switch used to add WORD to the dictionary. FORCE - Switch to suppress the 'OK to overwrite' requester that will pop up if WORD already exists. REMOVE - Switch to remove WORD from the dictionary. RESULTS The old definition of WORD. DisableUser ----------- FORMAT DisableUser , DESCRIPTION Inhibit user input in the current window and sets the busy pointer. This function is nested and must be matched by an equal number of EnableUser calls to reenable user input. EnableUser ---------- FORMAT EnableUser , DESCRIPTION Decreases the input lock counter for this window and if zero reenables user input and clears the busy pointer. EnterASCII ---------- FORMAT EnterASCII ASCII/N DESCRIPTION This function is provided so that the user may enter non-printable characters into the text. When the function is called without the argument a requester will pop up to get the ASCII number from the user. The Text function can be used to perform the same function as EnterASCII with an argument. INPUTS ASCII - ASCII value of the character to enter, or if nothing entered, prompts the user. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. Erase ----- FORMAT Erase , DESCRIPTION Delete the currently selected block of text. Fault ----- FORMAT Fault ERRNUM/N,RAW/S DESCRIPTION Get the error string assigned to the given number, if no number is given, the return code from the last function is used. If RAW is specified unprintable characters will be translated to '\\xxx', e.g. LF = '\\010'. INPUTS ERRNUM - The error number to inquire about, or input nothing to find out what went wrong with the command last called. RAW - Switch to inhibit '\\xxx' translation. RESULT An error message. Find ---- FORMAT Find CIRCULAR/N,FIND,FORWARD/N,UCEQLC/N,WILDCARD/N,WORDS/N, DESCRIPTION Finds a string in the text. If the FIND string is not given, prompts the user with the Find requester to enter the string to find. UCEQLC, FORWARD, WILDCARD, WORDS and CIRCULAR are optional flags to define how the search will be made. If not given, the current setting of the flag with the same name in _FE_Flags (displayed in the Find requester) will be used; if the option equals 0, meaning 'not in use', or 'reversed', setting the option equal to any other number will enable the option. Pattern matching will only be enabled if the WILDCARD option is enabled and the string to search for contains wildcard characters. For example if you want to search for a period followed by only one space then you would use the following in the search field @{"#?. ~( )#?" link DosWildCards}. In order to enter non printable characters use backslash and a three digit decimal number e.g. '\\010' for LF, '\\000' for NULL, etc. INPUTS CIRCULAR - Search circular (wrap at sof/eof). FIND - The string to search for, or nothing to prompt the user. FORWARD - Search forward in the file, else backwards. UCEQLC - Treat upper case as lower case. WILDCARD - Use pattern-matching when searching. WORDS - Search only for whole words. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. FindBracket ----------- FORMAT FindBracket , DESCRIPTION Search for a match to the bracket currently under the cursor. Valid brackets are '(', ')', '[', ']', '{' and '}'. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. FindCFunction ------------- FORMAT FindCFunction , DESCRIPTION Search the file for the definition of the C function currently under the cursor. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. FindReplace ----------- FORMAT FindReplace ONCE/S,ALL/S,FIND,REPLACE,UCEQLC/N,FORWARD/N,WILDCARD/N, WORDS/N,CIRCULAR/N Finds a string in the text and replaces it and stops if ONCE is specified; replaces it and all other occurrences without prompting the user if ALL is specified; or prompts the user if neither ONCE nor ALL is given. When prompted the user may select to do the following: (Y)es Replace this occurrence of the find string and search for the next occurrence. (N)o Don't replace, but search for the next. (L)ast Replace and quit searching. (A)ll Replace this and then find and change all occurrences not previously found without further prompting. Quit Don't replace and Stop searching. If the FIND or REPLACE string is not specified, the user will be prompted with the Find/Replace requester to enter the string to search for and the replacement string. UCEQLC, FORWARD, WILDCARD, WORDS and CIRCULAR are optional flags to define how the search will be made. If not given, the current setting of the flag with the same name in _FE_Flags (displayed in the Find/Replace requester) will be used, if the option is 0, it is not in use or reversed, so any other number will enable the option. Pattern matching will only be enabled if the WILDCARD option is enabled and the string to search for contains wildcard characters. Click for more information about wildcards. In order to enter non-printable characters use backslash and a three digit decimal number e.g. '\\010' for LF, '\\000' for NULL, etc. INPUTS ONCE - Replace once without prompting the user, then stop. ALL - Replace every occurrence without prompting the user. FIND - The string to search for, or nothing to prompt the user. REPLACE - The replace string. UCEQLC - Treat upper case as lower case. FORWARD - Search forward in the file, else backwards. WILDCARD - Use pattern-matching when searching. WORDS - Search only for whole words. CIRCULAR - Search circular (wrap at sof/eof). RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. FindReplaceNext --------------- FORMAT FindReplaceNext ONCE/S,ALL/S,BACK/S DESCRIPTION Finds a string in the text and replaces it and stops if ONCE is specified; replaces it and all other occurrences without prompting the user if ALL is specified; or prompts the user if neither ONCE nor ALL is given. When prompted the user may select to do the following: (Y)es Replace this occurrence of the find string and search for the next occurrence. (N)o Don't replace, but search for the next. (L)ast Replace and quit searching. (A)ll Replace this and then find and change all occurrences not previously found without further prompting. Quit Don't replace and Stop searching. The search is made using the contents of the _FE_FindString buffer and the search flags in _FE_Flags, the replacement string used is _FE_ReplaceString. If BACK is specified the search is made backwards in the file, towards sof (start of file). INPUTS ONCE - Replace once without prompting the user, then stop. ALL - Replace every occurrence without prompting the user. BACK - The search will be made backwards, towards sof. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. FindIMark --------- FORMAT FindIMark MARK/A/N DESCRIPTION Searches the file for the specified IMark. First the IMark image is expanded using the supplied argument and then the search is made. In the IMark image a small x specifies the mark number, so '/*x*/' will expand to '/*4*/' if the argument is 4 and '/*-999*/' if the argument is -999. The IMark must be placed at column 1. The search is case-sensitive. INPUTS MARK - The imark number to search for. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. FindLabel --------- FORMAT FindLabel , DESCRIPTION Searches the file for the definition of the label currently under the cursor. The label must be a standard assembler label using characters 'a' - 'z', 'A' - 'Z', '0' - '9', '.' and '_'. It must start on column 1 if not ended with a colon ':'. If ended with a colon ':' it may start on any column if all characters preceding it are spaces and/or tabs. The search is case-sensitive. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. FindNext -------- FORMAT FindNext BACK/S DESCRIPTION Searches for the current contents of _FE_FindString in the text. If BACK is specified the search is made backwards. INPUTS BACK - The search will be made backwards, towards sof. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. Flag ----- FORMAT Flag FIELD/A,FLAG/A,T=TOGGLE/S,S=SET/S,C=CLEAR/S DESCRIPTION Change and/or inquire about the state of a flag. If none of the action switches are specified the flag is left unchanged. INPUTS FIELD - What flag field to affect. FLAG - What flag to change or inquire about. TOGGLE - Toggle the state of the flag. SET - Set the flag. CLEAR - Clear the flag. RESULTS The old state of the flag. Font ---- FORMAT Font NAME,SIZE/N,SCREEN/S,TEXT/S,GADGET/S,BOLD/S,ITALIC/S,UNDERLINE/S, SCALE/S DESCRIPTION Change the font(s). INPUTS NAME - Name of the font to use, with or without .font. SIZE - Size of the font to use. SCREEN - The change will affect the screen font. TEXT - The change will affect the text font. GADGET - The change will affect the gadget font. BOLD - Use Bold style. ITALIC - Use Italic style. UNDERLINE - Use UnderLined style. SCALE - Allow font scaling. EXAMPLES Font GADGET TEXT SCREEN BOLD ; change all fonts to bold style Font SIZE 16 SCREEN ; change size of the screen font Fold ---- FORMAT Fold SHOW/S,HIDE/S,SHOWNESTED/S,HIDENESTED/S,SHOWALL/S,HIDEALL/S DESCRIPTION This command is used to show and hide folds in the text. In order to hide a piece of text by folding it, the text must be enclosed within special foldmarkers, defined by _FE_FoldStart and _FE_FoldEnd, and the cursor positioned within the text you wish to fold, unless HIDEALL is specified. The foldmarkers must appear on column one of the line they are in. The default definition is '/*fs*/' for _FE_FoldStart and '/*fe*/' for _FE_FoldEnd. To show a piece of text, unfold it, the cursor must be positioned on the line just above or below the text you wish to unfold. Normally this is easy since the foldmarkers aren't hidden when folded, so just put the cursor on one of the lines with the foldmarkers enclosing the folded text. If SHOWALL is specified the cursor may be positioned anywhere - all folds are shown anyway. INPUTS SHOW - Unfold the current fold. HIDE - Fold the current fold. SHOWNESTED - Unfold the entire tree of the current fold. HIDENESTED - Fold the entire tree of the current fold. SHOWALL - Unfold all folds. HIDEALL - Fold all folds. Format ------ FORMAT Format LEFT/S,RIGHT/S,CENTER/S,FILL/S DESCRIPTION Formats a paragraph of text, starting at the current line and continuing to the first empty or hard-space indented line. If the first line is hard-space indented, that indent will be used for the entire formatted paragraph. Only one formatting option may be specified at a time. The indent of the first line is kept if the format is LEFT or FILL. Punctuation marks, e.g. end of sentence characters, and the number of spaces to put after, e.g. the number of spaces between end of sentence - start of sentence, are defined by two variables: INPUTS LEFT - Straight left edge, ragged right edge. RIGHT - Straight right edge, ragged left edge. CENTER - Center the lines, ragged left- and right edges. FILL - Straight left- and right edges. GetENVVar --------- FORMAT GetENVVar NAME/A,RAW/S DESCRIPTION Get the value of an Edge environment variable. INPUTS NAME - The name of the variable to read. RAW - Switch to suppress the '\\xxx' translation of 'non-printing' chars. RESULTS The value of the given variable. GlobalSettings -------------- FORMAT GlobalSettings PRINTER/S,SCREEN/S,WINDOWS/S DESCRIPTION Bring up the Global Settings control panel so the user can alter the settings. If no startup switch is given general settings will be displayed. INPUTS PRINTER - Show printer settings when opened. SCREEN - Show screen settings when opened. WINDOWS - Show window settings when opened. Edge Help : GoToAuto FORMAT GoToAuto , DESCRIPTION Moves the cursor to AutoBookMark. The AutoBookMark is a special bookmark automatically set, before the cursor is moved, by the following commands: Find FindNext FindReplace FindReplaceNext FindCFunction FindLabel FindBracket FindIMark Position GoToBookMark GoToLine GoToPage GoToError GoToByte Paste RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. GoToBookMark ------------ FORMAT GoToBookMark MARK/A/N DESCRIPTION Moves the cursor to the given bookmark. The number must be within the valid range 1 - 10 or an error will be reported. INPUTS MARK - Bookmark to move to. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. GoToByte -------- FORMAT GoToByte BYTE/N DESCRIPTION Moves the cursor to the given byte in the file; if no argument is given the user will be prompted for a number. INPUTS BYTE - Byte to move to, or nothing to prompt the user. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. GoToColumn ---------- FORMAT GoToColumn COLUMN/N DESCRIPTION Moves the cursor to the given column on the current line, or if no argument is given prompts the user for a number and uses that. INPUTS COLUMN - Column to move to, or nothing to prompt the user. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. GoToError --------- FORMAT GoToError ERRNUMBER/N,PREVIOUS/S,SHOW/S DESCRIPTION Moves the cursor to the line and column of the next entry in the error-list and displays the error-message in the window title bar. If an ERRNUMBER is given, then this function goes to and displays this error, and if PREVIOUS is specified, then it displays the previous error in the list. If SHOW is specified a window will open, displaying all errors linked, but if the error list is currently empty no window will open. INPUTS ERRNUMBER Go to the error number given, or the last error linked if the number specified is greater than the number of errors linked. PREVIOUS Switch used to move backwards in the error-list. SHOW Switch to open a window in which all linked errors can be viewed. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. GoToLine -------- FORMAT GoToLine LINE/N Moves the cursor to the given line, or if no argument is given prompts the user for a number and uses that. INPUTS LINE - Line to move to, or nothing to prompt the user. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. GoToPage -------- FORMAT GoToPage PAGE/N DESCRIPTION Moves the cursor to the first line of the given page, or if no argument is given prompts the user for a page number and uses that. INPUTS PAGE - Page to move to, or if nothing, prompts the user. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. Help ---- FORMAT Help HELPFILE/K,SECTION,LOADINDEX/S,LOADALL/S,CACHENODE/S,KEEPCACHE/S, QUIT/S DESCRIPTION Activates the Help-system and displays the named section if given, else displays the last visited section. If the help system is activated for the first time and no section is given, the MainMenu will be displayed. The switches are used to control the operation of the help system. INPUTS HELPFILE - The help-file to use, default 'EdgePrg:help/Edge.guide'. SECTION - The section to display at activation. LOADINDEX - Force load index at startup. LOADALL - Force load the entire database at startup. CACHENODE - Cache each section as visited. KEEPCACHE - Hold on to the buffers until purged. QUIT - Tell AmigaGuide to close down and free all buffers. Iconify ------- FORMAT Iconify FORCE/S,FORCEREXX/S,FORCEOK/S,SAVE/S,ICONS/S,NOICONS/S,BACKUPS/S, NOBACKUPS/S DESCRIPTION Makes Edge dormant. If ICONWINDOW, in _GE_Flags, is enabled a small icon-window will be opened in the Workbench screen. To wake up Edge either activate the icon-window and press the right mouse button or press the Edge hotkey, as defined in _GE_CX_PopKey, or send a 'Wakeup' or a 'New' command to the global Edge ARexx port. If you wish to quit Edge when in dormant mode either click the close gadget in the icon-window or use Commodities Exchange to kill it, or send a 'Quit' command to the global Edge ARexx port. The FORCE switch suppresses the requester that will pop up if any changes have been made to any file, asking the user to confirm that losing the changes is OK. The FORCEOK switch suppresses the requester that pops up if no changes are made and no ARexx messages are outstanding, asking if quitting the file is OK. The FORCEREXX switch suppresses the requester that will pop up if any of the windows have any outstanding ARexx messages (the requester is only visually suppressed - the outstanding messages must return before the editor can be unloaded). If the SAVE switch is present all changes will be saved before Edge is iconified. The ICON, NOICON, BACKUP and NOBACKUP switches are used to force or suppress icon and backup creation when saving. Edge will NOT iconify if there are outstanding ARexx messages. All ARexx messages must return before Edge will iconify. INPUTS FORCE - Suppress the requester asking the user about losing any changes. FORCEREXX - Suppress the 'ARexx outstanding messages' requester. FORCEOK - Suppress the 'OK to iconify Edge' requester. SAVE - Save the file(s) before iconifying. ICONS - Force create icons for all files saved. NOICONS - Suppress icon creation for all files saved. BACKUPS - Force create backups for all files saved. NOBACKUPS - Suppress backup creation for all files saved. Include ------- FORMAT Include FILENAME DESCRIPTION Includes the named file in the current file at the current cursor position. If no file is given, prompts the user with a FileRequester for a filename. INPUTS FILENAME - Name of the file to include, or nothing to prompt the user. RESULTS The name of the included file. KeyBoard -------- FORMAT KeyBoard KEY/A,Q=QUALIFIER/K,QM=QUALMASK/K,ASK/S,FORCE/S,COMMAND/F DESCRIPTION Inquire about, remove, change or add a keyboard command. INPUTS KEY - The key to use. QUALIFIER - The qualifiers to test for. QUALMASK - The qualifiers to mask out before the qualifier test is made. ASK - Use this switch to get the current command assigned to KEY. FORCE - Suppresses the requester that will pop up if KEY already exists. COMMAND - The command to be assigned to KEY. EXAMPLES KeyBoard "up" ask ; will normally return "cursor up 1". KeyBoard "up" ; remove the installed command. KeyBoard up cursor down 1 ; add it again. KeyBoard up force cursor up 1 ; make it right this time. RESULTS The old command assigned to KEY Learn ----- FORMAT Learn FILENAME DESCRIPTION Starts/Stops the recording of a macro. If this command is issued and no macro is currently defined, a new macro will be created with the given name, or 'ram:Edge.macro' if no name is given. If this command is issued and a macro is currently defined, then the macro recording is stopped. When macro recording is enabled, the commands executed by the user, menu or keyboard events, and normal typing will also be written to the macrofile as an ARexx script that can later be executed. INPUTS FILENAME - The name of the macro, or nothing for the default name 'ram:Edge.macro' LoadDictionary -------------- FORMAT LoadDictionary FILENAME,FORCE/S,APPEND/S DESCRIPTION Loads a new dictionary configuration from the file with the given name. If no name is given, the default name, either EdgePrg:Edge.dictionary or the name defined by you at startup with the DICTIONARY keyword/tooltype, is used. The FORCE switch is used to suppress the requester that will pop up if a word already exists. If the APPEND switch is present the current dictionary will not be cleared before the new one is loaded, so you can merge different definitions together. INPUTS FILENAME - Name of the file to use, or nothing for the default one. FORCE - Suppress the 'OK to overwrite..' requester. APPEND - Merge mode. LoadENV ------- FORMAT LoadENV FILENAME,GE/S,LE/S,DEFLE/S,PATTERN DESCRIPTION Loads environment variables from a file. Normally the environment variables are stored in two files; Edge.global and Edge.local. However, you may choose to save all environment variables in one file and then use LoadENV to load it all. If no FILENAME is given the user will be prompted with the FileRequester to enter a filename. The Pattern is used to select which variables to load and supports wildcard expansion. If no pattern is given all variables present in the file will be loaded. INPUTS FILENAME - The name of the env-file to load, no name prompts the user. GE - Use this switch to load the Global Environment Variables. LE - Use this switch to load the Local Environment Variables. DEFLE - Use this switch to load the Default Environment Variables. PATTERN - Pattern to select which variables to load, or nothing for all. EXAMPLES LoadEnv 'my_edge.prefs' GE LE DEFLE RESULTS The name of the loaded prefs-file. LoadKeyboard ------------ FORMAT LoadKeyboard FILENAME,FORCE/S,APPEND/S DESCRIPTION Loads a new keyboard definition from the file with the given name. If no name is given, the default name, either EdgePrg:Edge.keyboard or the name defined by the user at startup with the KEYBOARD keyword/tooltype, is used. The FORCE switch is used to suppress the requester that will pop up if a key already exists. If the APPEND switch is present the current keyboard definition will not be cleared before the new one is loaded, so you can merge different definitions together. INPUTS FILENAME - Name of the file to use, or nothing for the default one. FORCE - Suppress the 'OK to overwrite..' requester. APPEND - Merge mode. LoadMenus --------- FORMAT LoadMenus FILENAME,APPEND/S DESCRIPTION Loads a new menu definition from the file with the given name. If no name is given, the default name, either EdgePrg:Edge.menus or the name defined by the user at startup with the MENUS keyword/tooltype, is used. If the APPEND switch is present the current menu definition isn't cleared before the new one is loaded so you can merge different definitions together. INPUTS FILENAME - Name of the file to use, or nothing for the default one. APPEND - Merge mode. LoadMouseButtons ---------------- FORMAT LoadMouseButtons FILENAME,FORCE/S,APPEND/S DESCRIPTION Loads a new mouse button definition from the file with the given name. If no name is given, the default name, either EdgePrg:Edge.mousebuttons or the name defined by the user at startup with the MOUSEBUTTONS keyword/tooltype, is used. The FORCE switch is used to suppress the requester that will pop up if a button already exists. If the APPEND switch is present the current definition will not be cleared before the new one is loaded, so you can merge different definitions together. INPUTS FILENAME - Name of the file to use, or nothing for the default one. FORCE - Suppress the 'OK to overwrite..' requester. APPEND - Merge mode. LoadTexts --------- FORMAT LoadTexts FILENAME,APPEND/S DESCRIPTION Loads a new requester definition from the file with the given name. If no name is given the default name, either EdgePrg:Edge.texts or the name defined by the user at startup with the TEXTS keyword/tooltype, is used. If the APPEND switch is present the current definition isn't cleared before the new one is loaded so you can merge different definitions together. INPUTS FILENAME - Name of the file to use, or nothing for the default one. APPEND - Merge mode. LoadTemplates ------------- FORMAT LoadTemplates FILENAME,FORCE/S,APPEND/S DESCRIPTION Loads a new template configuration from the file with the given name. If no name is given, the default name, either EdgePrg:Edge.templates or the name defined by you at startup with the TEMPLATES keyword/tooltype, is used. The FORCE switch is used to suppress the requester that will pop up if a template already exists. If the APPEND switch is present the current configuration will not be cleared before the new one is loaded, so you can merge different definitions together. INPUTS FILENAME - Name of the file to use, or nothing for the default one. FORCE - Suppress the 'OK to overwrite..' requester. APPEND - Merge mode. LocalSettings ------------- FORMAT LocalSettings , DESCRIPTION Bring up the LocalSettings control panel so the user may adjust the settings, save or load them. LowerCase --------- FORMAT LowerCase CHAR/S,WORD/S,BACK/S,LINE/S,SOL/S,EOL/S,BLOCK/S DESCRIPTION Convert characters to lower case in some different and useful ways. INPUTS CHAR The character under the cursor; the cursor is moved to the right. WORD The word beginning under and extending to the right of the cursor; the cursor is moved to the right. BACK This flag only works together with CHAR and WORD. If given, the text to the left of the cursor is changed instead of the text to the right. The cursor is moved to the left. LINE Change the whole current line. The cursor is moved to the line below. SOL Change all characters from the start of the line to the cursor, not including the character under the cursor. The cursor is moved to SOL. EOL Change all characters from the cursor, including the character under the cursor, to the end of the line. The cursor is moved to EOL. BLOCK Change the currently selected block. MarkBlock --------- FORMAT MarkBlock COLUMNAR/S DESCRIPTION Turn on block mode in order to select a block; if block mode is already engaged it will discontinue. If the COLUMNAR switch is given the block selected will be of columnar type, else normal. INPUTS COLUMNAR - Switch to mark columnar blocks. EdgeToBack ---------- FORMAT EdgeToBack , DESCRIPTION Move the Edge screen behind all other screens. EdgeToFront ----------- FORMAT EdgeToFront , DESCRIPTION Bring the Edge screen in front of all other screens. MouseButton ----------- FORMAT MouseButton BUTTON/A,Q=QUALIFIER/K,QM=QUALMASK/K,ASK/S,FORCE/S,COMMAND/F DESCRIPTION Inquire about, remove, change or add a mouse button command. INPUTS BUTTON - The mouse button click sequence to use. QUALIFIER - The qualifiers to test for. QUALMASK - The qualifiers to mask out before the qualifier test is made. ASK - Use this switch to get the current command assigned to BUTTON. FORCE - Suppresses the requester that will pop up if BUTTON already exists. COMMAND - The command to be assigned to BUTTON. EXAMPLES MouseButton DOUBLELEFT Q="shift" ask ; normally returns "markblock columnar". MouseButton DOUBLELEFT Q="shift" ; remove the installed command. MouseButton DOUBLELEFT Q="shift" markblock ; add it again. MouseButton DOUBLELEFT Q="shift" force markblock columnar ; make it right RESULTS The old command assigned to BUTTON MovePage -------- FORMAT MovePage UP/N,DOWN/N,LEFT/N,RIGHT/N,CENTER/S DESCRIPTION Scrolls the text, but keeps the cursor on the same character. The text can only be scrolled as long as the cursor is within the defined scrollborders. INPUTS UP - Number of lines to scroll up. DOWN - Number of lines to scroll down. LEFT - Number of characters to scroll left. RIGHT - Number of characters to scroll right. CENTER - Try to put the cursor in the middle of the window, the other arguments are ignored if this switch is given. MoveScreen ---------- FORMAT MoveScreen LEFTEDGE/N,TOPEDGE/N,DELTAX/N,DELTAY/N DESCRIPTION Scrolls the Edge screen either to an absolute position or relative to the current one. This is only possible if the screen size is bigger than the actual display size, e.g. an autoscroll screen. INPUTS LEFTEDGE - Move the screen to this absolute x position. TOPEDGE - Move the screen to this absolute y position. DELTAX - Move the screen horizontally this amount relative to the current x position. DELTAY - Move the screen vertically this amount relative to the current y position. New --- FORMAT New PORTNAME/K,LEFTEDGE/N,TOPEDGE/N,WIDTH/N,HEIGHT/N, ZOOMLEFTEDGE/N,ZOOMTOPEDGE/N,ZOOMWIDTH/N,ZOOMHEIGHT/N,PATH,NAME, COPYLS/S DESCRIPTION Creates a new file in Edge. You may specify a custom ARexx-address, the initial window size/position, the initial zoomed size/position and the initial path and name. If you don't supply any arguments defaults will be used, unless the COPYLS switch is present - in which case the local settings will be copied from the file executing the New command. INPUTS PORTNAME - ARexx port's address for this window. LEFTEDGE - Window x position. TOPEDGE - Window y position. WIDTH - Window width. HEIGHT - Window height. ZOOMLEFTEDGE - Window zoomed x position. ZOOMTOPEDGE - Window zoomed y position. ZOOMWIDTH - Window zoomed width. ZOOMHEIGHT - Window zoomed height. PATH - The DOS path to use. NAME - The name for this file. COPYLS - Copies the local settings from the file executing the New command. NOTE The file specified is not loaded. The new file will simply use that name and path. When running from ARexx, the host address is not changed to that of the new window. In order to do so you must 'address value result' using the result from this command. RESULTS The ARexx-address (ARexx port name) for the new window. NewLine ------- FORMAT NewLine NI=NOINDENT/S,I=INDENT/S,TI=TOGGLEINDENT/S DESCRIPTION Inserts a new line in the text below the current one, but doesn't split the current line. If NOINDENT is specified, NewLine will not Autoindent the new line as it usually does if Autoindent is enabled. If INDENT is specified Newlinw will indent the Newline regardless of the state of Autoindent. If TOGGLEINDENT is specified Newline will do the opposite from that specified by the Autoindent flAg I.E If Autoindent is on Newline doesn't Indent and if Autoindent is off, then newline will indent the new line INDENT - Force an indent of the new line. TOGGLEINDENT - Do the opposite as specified by the AutoIndent flag. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. Next ---- FORMAT Next WORD/S,PAGE/S DESCRIPTION Move the cursor to the beginning of the next word or page. INPUTS WORD - Move to next word. PAGE - Move to next page. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. Nop --- FORMAT Nop , DESCRIPTION This command does nothing, which is sometimes useful. Open ---- FORMAT Open FILES/M,FORCE/S,RESTORELS/S,PATH/K DESCRIPTION Loads a new file into the current work area, and if multiple files are specified, opens new work areas and loads those files too. If no names are given, the user will be prompted with the FileRequester. The FORCE switch suppresses the requester that will pop up if any changes have been made to the current file, asking the user to confirm that losing the changes is OK. If the RESTORELS switch is present the local settings will be loaded with the default local settings before the new file is loaded. If not present, the settings used in the old file will be kept, if not overridden by variables saved in the new files icon. The PATH component is used to specify a path for all files not having an absolute path specified within them. INPUTS FILES Name(s) of the file(s) to load. No input here prompts the user to supply name(s). The name(s) may contain wildcard characters. FORCE Suppresses the requester prompting the user about losing any changes (this only applies for the current file). RESTORELS Loads the localsettings with default values before loading the new file (this only applies for the current file). PATH Path for non-absolute file specifications. EXAMPLES Let's assume that the current directory in Edge is 'work:', then open work:source.c source.c path myfiles will open the files 'work:source.c' and 'work:myfiles/source.c' and open work:source.c source.c path dh0: will open the files 'work:source.c' and 'dh0:source.c'. RESULTS The name of the loaded file. OpenClip -------- FORMAT OpenClip FILENAME,GC=GLOBALCLIP/S,APPEND/S DESCRIPTION Loads a new file into one of the clipboards, local or global. If no FILENAME is specified the user will be prompted with a FileRequester. If the APPEND flag is specified, the loaded text is not just put into the specified clip but joined to the end of what is already in the clip. With this switch you can merge different files into the clip and then insert it all in one go. INPUTS FILENAME Path and name of the file to load, or nothing to prompt the user. GLOBALCLIP Switch to select the global clipboard; if not given, the local clipboard is used. APPEND Merge mode. RESULTS The name of the loaded file. Paste ----- FORMAT Paste GC=GLOBALCLIP/S,GCC=GLOBALCLIPCOLUMNAR/S,SC=SMALLCLIP/S DESCRIPTION Inserts the contents of one of the clips at the current cursor position. If no switch is given, the contents of the local clip is inserted. When using the globalclip, i.e. the system clipboard, you yourself must decide how to insert it - Normal or Columnar. INPUTS GLOBALCLIP Switch to select the global clip as a normal block. GLOBALCLIPCOLUMNAR Insert the globalclip as a columnar block. SMALLCLIP Switch to select the small clip. Position -------- FORMAT Position LINE/N,COLUMN/N,CHAR/N,SOF/S,EOF/S,SOL/S,EOL/S,SOW/S,EOW/S,SOP/S, EOP/S DESCRIPTION Positions the cursor absolutely at some useful locations. You can only specify one switch at a time, except if you use LINE you may also use COLUMN or CHAR. INPUTS LINE Line to move to. COLUMN Column to move to. CHAR Character to move to (byte offset from sol). SOF Move to Start of File. EOF Move to End of File. SOL Move to Start of Line. EOL Move to End of Line. SOW Move to Start of Word. EOW Move to End of Word. SOP Move to Start of Page. EOP Move to End of Page. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. Previous -------- FORMAT Previous WORD/S,PAGE/S DESCRIPTION Moves cursor to the beginning of the previous word or page. INPUTS WORD Move to the previous word. PAGE Move to the previous page. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. PrintClip --------- FORMAT PrintClip GC=GLOBALCLIP/S,PROMPT/S DESCRIPTION Prints either the local or global clip, depending on the GLOBALCLIP switch, using the current printer settings. If the PROMPT switch is specified, the Global Settings - Printer requester will be opened to let the user alter the printer settings before printing the contents of the selected clipboard. The changes are only for that print session, however, if the PROMPT keyword is used. INPUTS GLOBALCLIP Switch to select the global clipboard. PROMPT To allow the user to change the printer settings. Print ----- FORMAT Print PROMPT/S DESCRIPTION Prints the current file using the current printer settings. If the PROMPT switch is specified the Global Settings - Printer requester will be opened to let the user alter the printer settings before printing. The changes are only for that print session, however, if PROMPT is used. INPUTS PROMPT To allow the user to change the printer settings. PutENVVar --------- FORMAT PutENVVar NAME/A,VALUE/A DESCRIPTION Puts a new value in an Edge environment variable. INPUTS NAME Name of the variable to affect. VALUE The new value. NOTE: if VALUE starts with an underscore '_', it is assumed to be an Edge environment variable. RESULTS The old value of the given variable. The FORCEREXX Switch suppresses the requester that will pop up if any of the windows have any outstanding ARexx messages (the requester is only visually suppressed - the outstanding messages must return before the editor can be unloaded). The FORCEOK switch suppresses the requester that pops up if no changes are made and no ARexx messages are outstanding, asking if quitting the file is OK. If the SAVE switch is present all changes will be saved before Edge is closed. The ICON, NOICON, BACKUP and NOBACKUP switches are used to force or suppress icon and backup creation when saving. NOTE If any window has outstanding ARexx messages, then Edge will wait for these messages to return before unloading the editor. If there are any Locks/Opens active to the Edge: disk then Edge will refuse to close down and this command will fail. INPUTS FORCE - Suppress the requester asking the user about losing any changes. FORCEREXX - Suppress the 'ARexx outstanding messages' requester. FORCEOK - Suppress the 'OK to quit Edge' requester. SAVE - Save the file(s) before closing down. ICONS - Force creation of icons for all files saved. NOICONS - Suppress icon creation for all files saved. BACKUPS - Force creation of backups for all files saved. NOBACKUPS - Suppress backup creation for all files saved. Redo ---- FORMAT Redo , DESCRIPTION Redo the undos. RequestFile ----------- FORMAT RequestFile%3/ýÍ»\XÕô ^^O;Êî8.9lþ? ¶áâZ<·d)ýÈïbÝíUÇ´NÝÉô6Çä8·¾ú?~éà&,0·ÔùQî§ÌFÓµ'Ô:áýv_7}ôt(½EB4 WØg¹CÀWEc<{qÊqÜ«·îËïûmÑÿ¡W¨ðJ· oÓ¾x±#å©s¿üaAÚ¿ÌB²ìCjùßJkݽ|pqî ½xêÙ¾>0øqOêÀHsnO%Æ|þÍäc¦wS¾ß°iÓ´ÁL¦ÞÝæ¼ç9 MP¦Oe(¹²o}Ç@Ô5ò KgÉż®_õ>²þߧúS@p> ¤ÉM{yé>lÑv¼¯¢hÃö/ò!Úã½ÿ£ýÊ(ã<ð©KÑÒ&uתBï Q;j¶ÑqXÊüG}üÉ"Wÿ§Tµÿ ÿÚã D3xïu7BÑ)÷¾Ám E§Òü&Ö¿q@TJýeVÌü뻺¢ÃÕåD¦ÅÁABVí2Ö>ÔPHZÜ{Ƶ{,íMn©vn:­in1föÂuÆ8tìóq¸²´-:f53'Þêhj\ ¼YBçÆ8ã,ñu¾©22[[ü`¼óyG«cHÕùÜoX¨oP·Ø®Â¥²ùÆ?¥VÙ³w!fãý]ÙRö2}2ì¼"zü%ùξü=¥ºsÆ|±!ËÀc6L²ïñ[[Øg/è\[Á[­ª8ÀZÊÎt"d_äáD¬åü#èYr=®O>ÅÀ¶,ÛìؽÎæ¾¾VèØü÷9X©gf̲çxnÈ ÓËÕY­ØÓKÕ7`_Kù^fS¯1~F°ªìPàB§VÍMvÆN;ÆôiÇÅH5FNÒײºón±ï+'³ìóµåcÄ!¾|\ñc>D¼Þ4Á9+wZËlÇkænø?1Þ²év·v¬¤4Ù±ùäµ`ÄBÜÇa'ÎoWöÅJ[ÁôoM¦µ7T<®\/X;KzA`~é}7k²Re¸u£Z^INÞÄÕª±ÄþdâÞ²[ê<î?6¹_V0ª:Ïæöüc]y³ýc²q\ä!ûÏûE¿9qå¿BÑÇÿEù¥C¼ùeÕyÕù#ÙIßçÏxß3ñºÿùüëU1ò~hvþ^¢éå×çõê«Éw=HêUñªYQ ©ª2¼·cVæ«Â2ÒâÜ£¨Çò³gÿ´q9ø)7ùð¹ ÿV®0ëÀ"ÀjáËþǹϻ%yãFòâ3À£%ÉXÕc RÜsâc#5`Q%ëwÀÁ#x/Na'¤3)ÂR3Ðc#%W¿àÜu$ÝÚRzrɧÓNs6x+Ó®'4ÉÇc·X!ñ¿,'Ö±¯6ìp%Ï2ñS óWDÚ:ÔL½,^#ÌÀ`0eä·#þnø¼jäl¬ls±KlÒk§RüÖbØL+a>9»[ØÎâ´`HîÎD_ÇHöxÆqÃp æIÞbÔÄ<á£Oý&ú¬ZpíeÂw'æK0Þ^[Ís2Y¨¢Í-æa>¨¹®%RçáååÅÝ_MÅ÷óò[QlG6ýxÍæÇ{1+G£b 9úãã..¢ÈöaÎGLÀÓv2ÄÓWê½åpt)õð7«Ý®ÛÞmyXb`±ÆÕDÍÄ7ÝÙ^08ïg¡Ç6åÙÔ<ÒÃÊ;3²;.MøØbew3»Ñ0/°ü;è˺z:@RR)1ôu+à ý¼¹JrDKªíó#øOs[s¿°×ýñõGj'Çïv7eyE"C°(©{ÈãÆL/¸Ba[éÜF¾4$ÿ|{­dF¦Qy£¥lEu!^ <¾|IhacBÞï6¦\<@AªzKç:ì?dr¬wnéÆýSD.^79×ð³Ö.)ÿYÖ¿Ì(.'p£ÂÔ5Ëg]t¾0i¸¢À/>T¸µoÊÐüt£ ø¼P°ØbªU6¶âKO~]éÉWS5L;èn8ÎôÎv6sÅs/7[l7çÛ(NÝÔPÈÅAÌlÌç¼Âc³hgÌÇ£ÓÊ»½èú}¥üã¼füNåᨼ(Î×¥EUGSXüÞZ¥åqÏ.æ¦Á³ªùø+! 0,@Üþ¨_g×e_¢÷è M=ýGBaV¸yp© 9ñx"È¥+dq7å3GG¿?GØs?°=,9~Åá[å_Ô´ÅnÜ7¡jn?|o¿[ËùÚq½Ë§¹±¼Î­Ê-3¶ý7Ñ7ðôáúX×^ÊÞߣk"ÈÑtJØpÐZUú§üDMÄöÓòx½À«IßbyÎ4d°·¡ß(rým)Öq ¦ñÌXEë%âõå­ªßF­QÂÌLZ;XÁgyý%Xÿ¬ï¾ȯD TÒ¶½Æ+ÛÑÚ¸zõCä:%á5)eG/ fHBÀW.®KèÎÜIÜ1L1å r 3CL/YZ "DÔ±ÙñfYö²è´²CHI¼~Ì´låûÃvÂn_PKjjÍ^Û{à¡Ö;Ð_Äý/DB,pÇ;¢{ýN¨£>|u¤¾zI×p&!:Ð*- S+}æ 1$TÉ78]0ë ;[êÀVËkx½Èh ¡pÍ!`×1±áëÕ<1Ã窱 Æ0³iÌKdépÒ"v­éâ?.î·©)ê½l¹ÃÚ-uä¿£è1YUµiôS×YMÓg¯8UR£{Yï¹ßxcu¹Ù£s i¹^]ÐÆ·4FÅ@(´ÕÎ5ÚRvÎwñs¬k-ZEa,qQÙ-¤¤õü¡@ÖÍ}Âd䣤âXÛ×(`ôÁ²·ûÔÞãîa±Z!dŦ«Y^z_3ùk$,\L²ô :õ*x÷bßy!Ä·/x]¡úØ3¬@ÜIVPøíwXeÇG<Ñ%þ¬6WYzw*·õw >.ÚcÊsrÀa1¡­$ëdóG/âZI Ò¸RI0H¨½SBÁCD$é',v äàÞ^Ðã®°IJ{¾%¾h ³²>c¼=Q>nëÑùÝz Ü¥õÀ@~PùCSvÄ[àKöµ§^ °øHDãÞz®ú|x¶¤ ±aBr­G|?Úoõr\ C ¸ÓX+{ÁݹÛñ­¡Osëë~¤ÈözLI3?Ë®Ø^Ö¬9^Ï8E§ëð=4¯®1[×Loãô5õVÿu¢=óWpß>;/Ò.KòÊLnYBö³N_j`äÎyä·6|q]>,½Ù+{ïy^)¼öQîÇQ ÎSC{[ ,$JtyÑV¼¸ªõ'". P/èÜp ©¨Nl°AÀé®ÜØËU*ýù@U\E s¹»¹a".Hkøø!&9G5ôçhèê¬Èãqë8UAÅ ù#eµ[rb&Í2£®²»¾v¨u\zMþ}äGk/ê8Ð e©Íó`Ò±egTS¼0é_¡&·c¦ö'W/oÆ@ H«n`¬[¨LEº¦¤í6añ«[¹I`-k×^[@¢tÁÜ (ï¾µÍôسñ©ÍÅà²xPZ©û´ÓÁV`ZF"µË-Ü£èÅÍË)ÝV f¶ÍµRØPKìsùáÏ7àÕ g@à)õQ¥² `µ9.+fÁ^æâ*JøK5qOíøÔ Èñ©SKaËÛ®/ª PhÁ§)ÎL,fq.KdO¹ºöȧ´ìõ~b×Ön<È2H­è*é°dîÅ9ÎQIhZå#ó®å;V{Ê,uÍýWóP°)1ºJl°>÷E[üIù{Ìb®9QÁÝ4FV­ÚA}ºÎOÆÑÏ0K¾-S÷²¹-Ië4,fê^ù|æíþsãá6(mÃgÔϵ!#üy}dòOGïËd4I÷LÍËR¦.ZNðæôGâµ?ä°ÊXËåË·UzôóѾ_ÚÌ Vkäej|cÖbBl°:ù¿$Ó·Xª6pPìÒ¤ÕmR¤=ÚÂkáàÏjÚ9£ð´Bâ@»U;)våèÃ*Õ©ÄÉéÕÊÅÉÀí`á3¤â)2®&.§8ÃÖ\:ù"à?,þ¾\>aïí|U}>Y¿¤àd¶p¼§SþÖÑä4ô̽*Ep¨¸#cå.¦ó¯é½b]Î̵¨3!Á 7õÛ×®ªê® ½p¢`©1A¯o.q¯PªÜ×^«Ey8»Í[g¡.´2D0<0JuHº«ó²Ùø>ó&qPÔÈH VÂBþ'åô:Îß)òS|-E³D6)3¸¿Êâöå[1æ¬"÷}2m0ûE Àþ·eúú,äW¥N}§-Qu%zSûzC÷Sñ%é-\ ~ªUØ×ø±R¬^«÷¸ðÓ!-¶Üé¯*O¯/qùé4%äO[ê3vaàò¾°þ ÙÔYJ¹ë}8£O èuêkTLD¬`p­£W<- oÎê@CR2¥¯ùt¹LÆðT×ñW¤x:²»xeýݨ¬®c ܤìÌsáJÉR²%$t (ñ{SWaÿeX$3Ö\é5×vd¦D¥Á jÂ<40s[H1̲ÀØÓlþZmdÆñ³IÕ3ð°V³VdZåI¥Ú&Ësh+çjÒòükº$ßÿ\f[M±Ç.°:P4-ÓÛÓ]¥ Æ 0©KIr,ûÿ! Ë"¸³r_1ºú¦ñÄxeBg9ýô¡°Ëæ*zócÚÆeG9zÚåÉÁÅÊÙ[6À+ybɲº9»ìÛÕÍï7 Ü60ö,åð à§2¦xd+8îöùp[²7ôVÐj¶ö¨R(,ê.}¬1ñ¦8Þ8:NÈÿÁ#ÿòt>³âwççÛ¬RX¾¹éøDþ?9DøÓ8ç}H.ÔH´õ´IýÉæUEÏDþ÷C¤®ju|ÿÔý£þÿ{çê£\Æ~ò©QuoQRºæû÷ÐÓrM¬®ýûôi,Y¤ÿûÂCó?sàù¯Á°u²  óÖ,j[~3îËü5ÌRð÷ZÉ*¦[È}Îòø+cú¹\óCD±ï{gâ(÷É?VM[òvÿ#DAXÆÊîñgbJÿ©Äc¥YÂ\Å:rµl¹áeM«<þ#),ßÿ"¨È ö?âpé·`Ú«åñãäØUÊá.UõßÒЭPÃ3w4Ȭ>& X<àÑñÕª·Làâg"»°Ë¤öwÞÓ2ÓµÇÙø¸»WbÞßàg4ñd­_½°5EÑ$âÇñ|w×µ4¨¦¨øêx+w7µN©¯P}JSKÒ¼a*Ç®sªÍ£ eC·0x<þ/l,OÕé£+Äÿ¦X+µÿ(ÐXCÏÉ· r³ó¯ø.Q~vQåÑu/çþ @~ç·D4ù=1HúùÂÏvÁÁô_õÏÀcËÈcXÿ>[åÙüc;ÊÌÆbÅEF|û3zosÓy,'k^z®ËgÄ~%Bá^Ï«ceÏØ\9àôÜÕ]Ï_9ú%tõCHF7?±ìý2EÙHèVñjÜè)£Z?¡gÿòÿ¡ÆW Path specification for the FileRequester. If not specified the last path used is used, initial default is 'Rexx:'. FILE - File specification for the FileReqeuester. If not specified the last file used is used, initial default is nothing. PATTERN - Pattern matching string for the FileRequester. If not specified the last pattern used is used, initial default is .edge. STOP - Stop macro recording. Useful for ARexx scripts that should not be callable from a recorded macro. Save ---- FORMAT Save ICON/S,NOICON/S,BACKUP/S,NOBACKUP/S DESCRIPTION Saves the current file with the current name. INPUTS ICON - Force creation of an icon for the file. NOICON - Suppress icon creation for the file. BACKUP - Force creation of a backup for the file. NOBACKUP - Suppress backup creation for the file. RESULTS The filename used to save the file. SaveAs ------ FORMAT SaveAs FILENAME,FORCE/S,ICON/S,NOICON/S,BACKUP/S,NOBACKUP/S DESCRIPTION Saves the current file with a new name. If the name is not given, the user will be prompted with the FileRequester to enter a filename. The FORCE switch suppresses the requester that will pop up if the file already exists, asking the user if it is OK to overwrite it. INPUTS FILENAME - The new filename, or nothing to prompt the user. FORCE - Suppress the requester asking the user if overwriting is OK. ICON - Force creation of an icon for the file. NOICON - Suppress icon creation for the file. BACKUP - Force creation of a backup for the file. NOBACKUP - Suppress backup creation for the file. RESULTS The filename used to save the file. SaveChanges ----------- FORMAT SaveChanges ICONS/S,NOICONS/S,BACKUPS/S,NOBACKUPS/S DESCRIPTION Saves all files in Edge that have been changed, using their current name. INPUTS ICONS - Force creation of icons for all files saved. NOICONS - Suppress icon creation for all files saved. BACKUPS - Force creation of backups for all files saved. NOBACKUPS - Suppress backup creation for all files saved. SaveClip -------- FORMAT SaveClip FILENAME,FORCE/S,GC=GLOBALCLIP/S,ICON/S,NOICON/S DESCRIPTION Saves either the global or the local clip, depending on the GLOBALCLIP switch, with the given name. If the filename is not present, the user will be prompted with the FileRequester to specify a filename. The FORCE switch is used to suppress the requester that will pop up if the selected file already exists. If no icon switch is given icon creation will take place as defined by the files ICON flag in _FE_Flags. INPUTS FILENAME - The name to use, or nothing to prompt the user. FORCE - Suppress the requester asking the user if overwriting is OK. GLOBALCLIP - Select the global clipboard. ICON - Force creation of an icon for the file. NOICON - Suppress the creation of an icon for the file. RESULTS The filename used to save the clip. SaveDictionary -------------- FORMAT SaveDictionary FILENAME,FORCE/S DESCRIPTION Saves the dictionary to the file with the given name. If no name is given, the default name, either EdgePrg:Edge.dictionary or the name defined by you at startup with the DICTIONARY keyword/tooltype, is used. The FORCE switch is used to suppress the requester that will pop up if the file already exists, asking you if overwriting is OK. INPUTS FILENAME - Name of the file to use, or nothing for the default Dictionary File. FORCE - Suppress the requester asking you if overwriting is OK. SaveENV ------- FORMAT SaveENV FILENAME,GE/S,LE/S,DEFLE/S,FORCE/S,PATTERN DESCRIPTION Saves the Edge environment variables to a file with the given name. If no name is given, the user will be prompted with the FileRequester to enter a filename. The FORCE switch is used to suppress the requester that will pop up if the selected file already exists. You may choose to save Global, Local, Default Local or any mix of variables in the save file. PATTERN is used to select which variables to save and supports @{"wildcard" link DosWildCards} expansion. If no PATTERN is given all variables are enabled. INPUTS FILENAME - The filename to use, or nothing to prompt the user. GE - Save Global environment variables. LE - Save Local environment variables. DEFLE - Save the Default Local environment variables. FORCE - Suppress the requester asking the user if overwriting is OK. PATTERN - Pattern to select which variables to save, or nothing for all. RESULTS The filename used to save the preferences. SaveKeyboard ------------ FORMAT SaveKeyboard FILENAME,FORCE/S DESCRIPTION Saves the keyboard definition to a file with the given name. If no name is given, the default name, either EdgePrg:Edge.keyboard or the name defined by the user at startup with the KEYBOARD keyword/tooltype, is used. INPUTS FILENAME - Name of the file to use, or nothing for the default one. FORCE - Suppress the requester asking the user if overwriting is OK. SaveMenus --------- FORMAT SaveMenus FILEANME,FORCE/S DESCRIPTION Saves the menu definition to a file with the given name. If no name is given, the default name, either EdgePrg:Edge.menus or the name defined by the user at startup with the MENUS keyword/tooltype, is used. INPUTS FILENAME - Name of the file to use, or nothing for the default one. FORCE - Suppress the requester asking the user if overwriting is OK. SaveMouseButtons ---------------- FORMAT SaveMouseButtons FILENAME,FORCE/S DESCRIPTION Saves the mouse button configuration to the file with the given name. If no name is given, the default name, either EdgePrg:Edge.mousebuttons or the name defined by you at startup with the MOUSEBUTTONS keyword/tooltype, is used. INPUTS FILENAME - Name of the file to use, or nothing for the default one. FORCE - Suppress the requester asking the user if overwriting is OK. SaveTexts --------- FORMAT SaveTexts FILENAME,FORCE/S DESCRIPTION Saves the text table configuration and Edge texts to the file with the given name. If no name is given, the default name, either EdgePrg:Edge.texts or the name defined by the user at startup with the TEXTS keyword/tooltype, is used. INPUTS FILENAME - Name of the file to use, or nothing for the default one. FORCE - Suppress the requester asking the user if overwriting is OK. SaveTemplates ------------- FORMAT SaveTemplates FILENAME,FORCE/S DESCRIPTION Saves the template configuration to the file with the given name. If no name is given, the default name, either EdgePrg:Edge.templates or the name defined by you at startup with the TEMPLATES keyword/tooltype, is used. The FORCE switch is used to suppress the requester that will pop up if the file already exists, asking if overwriting is OK. INPUTS FILENAME - Name of the file to use, or nothing for the default one. FORCE - Suppress the requester asking you if overwriting is OK. ScreenMode ---------- FORMAT ScreenMode MONITOR,WIDTH/N,HEIGHT/N,DEPTH/N,DETAILPEN/N,BLOCKPEN/N, TEXTPEN/N,SHINEPEN/N,SHADOWPEN/N,FILLPEN/N,FILLTEXTPEN/N, BACKGROUNDPEN/N,HIGHLIGHTTEXTPEN/N,BARDETAILPEN/N, BARBLOCKPEN/N,BARTRIMPEN/N DESCRIPTION Changes the Edge screen mode. You may alter the width, height, depth, display mode and the 'pens' of the screen. Pen numbers should be color register numbers consistent with the palette depth (number of colors): A depth of 2 results in 4 colors in registers 0 - 3; A depth of 3 results in 8 colors in registers 0 - 7; A depth of 4 results in 16 colors in registers 0 - 15; NOTE: The Background pen is always color 0. INPUTS MONITOR - Display to use e.g. 'PAL:Hires' or 'NTSC:Hires-Interlace', or the name of a public screen, e.g. 'Workbench:Use'. WIDTH - The width of the screen, -1 for default. HEIGHT - The height of the screen, -1 for default. DEPTH - The number of bitplanes to use (1 - 3). DETAILPEN - Compatible Intuition rendering pens BLOCKPEN - Compatible Intuition rendering pens TEXTPEN - Text on background SHINEPEN - Bright edge on 3D objects SHADOWPEN - Dark edge on 3D objects FILLPEN - Active-window/selected-gadget fill FILLTEXTPEN - Text over FILLPEN BACKGROUNDPEN - Always color 0 HIGHLIGHTTEXTPEN - Special color text, on background NOTE: These pens are only available under Kickstart v39 or better BARDETAILPEN - Text/detail in screen-bar/menus BARBLOCKPEN - Screen-bar/menus fill BARTRIMPEN - Trim under screen-bar Select ------ FORMAT Select FILENAME,FULLNAME,TOP/S,BOTTOM/S,NEXT/S,PREVIOUS/S DESCRIPTION Selects a new current file to work with. Activates the first window in the specified file for USER input. Take care when using this function from ARexx, since the host address doesn't change. If you wish to change the host address to that of the activated window you must 'address value result' using the result from this function. If no filename and no switches are given the user is prompted with a requester to enter a filename. Edge maintains a history of the Select (global) string gadget. To cycle through the list, simply use the Cursor Up/Down keys. Shift Cursor Up will move to the top of the list; Shift Cursor Down will move to the bottom of the list. Shift Cursor Down will move to the start of the list and clear the gadget. Shift Cursor Up will search the list for the string currently in the gadget (just like the shell). None of the history files can be saved. INPUTS FILENAME - Activate the first window in the given file; the search is made ignoring the Edge path components. FULLNAME - Activate the first window in the given file; the search is made taking into account the Edge path componets. TOP - Activate the first window in the first file. BOTTOM - Activate the last window in the last file. NEXT - Activate the next window in the window list. PREVIOUS - Activate the previous window in the window list. NOTE NEXT and PREVIOUS are circular, which means that if the current window is the last one and you specify NEXT you will activate the first window in the first file, and if the current window is the first one and you specify PREVIOUS you will activate the last window in the last file. You may only specify one of the switches at a time. RESULTS The ARexx-address of the activated window. SetBookMark ----------- FORMAT SetBookMark MARK/A/N DESCRIPTION Sets a bookmark in the text. The mark number must be within the valid range 1 - 10. INPUTS MARK - Bookmark number to use. SwapCase -------- FORMAT SwapCase CHAR/S,WORD/S,BACK/S,LINE/S,SOL/S,EOL/S,BLOCK/S DESCRIPTION Swaps case on characters, to upper if lower; and to lower if upper, in some different and useful ways. INPUTS CHAR - Change the character under the cursor. The cursor is moved to the right. WORD - Change the word beginning under and extending to the right of the cursor. The cursor is moved to the right. BACK - This flag only works together with CHAR and WORD. If BACK is used, the text to the LEFT of the cursor is changed instead of the text to the right. The cursor is moved to the left. LINE - Change the entire current line. The cursor is moved to the line below. SOL - Change all characters from the start of the line to the cursor, not including the character under the cursor. The cursor is moved to SOL. EOL - Change all characters from the cursor, including the character under the cursor, to the end of the line. The cursor is moved to EOL. BLOCK - Change the currently selected block. Template -------- FORMAT Template TEMPLATE/A,ASK/S,FORCE/S,FILL/F DESCRIPTION Inquires about, removes or adds a template to the template configuration. INPUTS TEMPLATE - The template you wish to affect. ASK - Switch used to inquire about the fill-text currently assigned to the given TEMPLATE. FILL - The fill-text you wish to assign to the given TEMPLATE. To include non-printing characters use decimal codes: '\\xxx' e.g. '\\169' = '-' '\\065' = 'A', '\\010' = LF, etc. FORCE - Switch to suppress the 'OK to overwrite' requester that will pop up if TEMPLATE already exists. EXAMPLES Template ff ask ; inquire about template 'ff' Template ff force ; remove template 'ff'; i.e. assign it a fill-text ''. RESULTS The old fill-text assigned to TEMPLATE. Text ---- FORMAT Text TEXT/A,RAW/S DESCRIPTION Inserts or overwrites characters in the file at the current cursor position. The characters to be written must be quoted, and in order to use non-printable characters use backslash and a three digit decimal number, e.g. "\\010" for LF, "\\009" for TAB, "\\065" for A, etc. Normally the characters are inserted one by one and are affected by AUTOINDENT, CORRECTCASE and WORDWRAP. However - if the RAW switch is specified, then the text is inserted as a block in one go which is much faster, but AUTOINDENT, CORRECTCASE and WORDWRAP are bypassed. INPUTS RAW - Switch to bypass AUTOINDENT, CORRECTCASE and WORDWRAP. TEXT - The characters to be inserted. RESULTS The new position will be returned with the format: Line Offset Column ASCII All fields are decimal numbers. Undo ---- FORMAT Undo , DESCRIPTION To undo changes made to the file. UpperCase --------- FORMAT UpperCase CHAR/S,WORD/S,BACK/S,LINE/S,SOL/S,EOL/S,BLOCK/S DESCRIPTION Converts characters to upper case in some different and useful ways. INPUTS CHAR - Change the character under the cursor. The cursor is moved to the right. WORD - Change the word beginning under and extending to the right of the cursor. The cursor is moved to the right. BACK - This flag only works together with CHAR and WORD. If BACK is used, the text to the LEFT of the cursor is changed instead of the text to the right. The cursor is moved to the left. LINE - Change the entire current line. The cursor is moved to the line below. SOL - Change all characters from the start of the line to the cursor, not including the character under the cursor. The cursor is moved to SOL. EOL - Change all characters from the cursor, including the character under the cursor, to the end of the line. The cursor is moved to EOL. BLOCK - Change the currently selected block. Wakeup ------ FORMAT Wakeup , DESCRIPTION Uniconifies Edge, if iconified; else does nothing. Window ------ FORMAT Window SV=SPLITVERTICAL/S,SH=SPLITHORIZONTAL/S,CLOSE/S,FORCE/S, FORCEREXX/S,FORCEOK/S,SNAPSHOT/S,MIN/S,MAX/S,FRONT/S,BACK/S, ZOOM/S,UNZOOM/S,ZIP/S DESCRIPTION This is a powerful window manipulating command. It will allow you to split a window into two windows, vertically or horizontally, close a window, snapshot a window so that the next time you load the file the window will have the same size and position (providing you have elected to save the local settings with the file), resize, zip, zoom, unzoom and move a window in front of all windows or behind all windows. INPUTS SPLITVERTICAL - Split the current window in two, vertically. SPLITHORIZONTAL - Split the current window in two, horizontally. CLOSE - Close the current window. FORCE - Suppress the requester that will pop up if this window is the last one in the file and the file contains changes, asking if losing the changes is OK. FORCEREXX - Suppress the 'ARexx outstanding msg' requester that will appear if running this command from ARexx, or if any other scripts are still out there. FORCEOK - Suppress the 'OK to quit file 'xx'' requester that will pop up if this window is the last in the file and no changes are made. SNAPSHOT - Snapshot the current window. MAX - Resize the current window to its maximum size. MIN - Resize the current window to its minimum size. FRONT - Bring the current window in front of all other windows. BACK - Move the current window behind all other windows. ZOOM - Zoom the current window. UNZOOM - UnZoom the current window. ZIP - Either Zoom or UnZoom the current window depending on its current state (zoomed or unzoomed). NOTE If a window is Zoomed when you make a snapshot, the size/position will be stored in the zoom size/position variables. The result returned from this command is the state the window was in BEFORE it was changed, zoomed, min, max, etc. RESULTS The window position, size and ARexx-address is returned with the format: X x, Y y, W w, H h, ARexx-address, ZoomFlag ('Zoomed' or 'UnZoomed') x, y, w and h are decimal numbers. X, Y, W, and H are the actual letter. EXAMPLE Here is a typical result string returned: X 0, Y 0, W 640, H 200, EDGE1.1.1, UnZoomed WindowTitle ----------- FORMAT WindowTitle MESSAGE/A,DISPLAYTIME/N DESCRIPTION Displays a message in the title bar of the current ARexx command host's text window, and shows it for DISPLAYTIME seconds. If no DISPLAYTIME is given the message will be displayed for 4 seconds. INPUTS MESSAGE - Message text to show. DISPLAYTIME - How long to show it, no entry uses default which is 4. Environment ----------- The Edge environment variables and flags. Edge has one global environment that contains settings used by all files, and then each file has its own local environment as well. The local environment is actually divided into 2 parts, one large section, the File environment, and then for each window in the file a small section known as the Window environment. NOTE: There is no file for window environment variables since they are dynamic and depend on the opened window conditions. The window variables are accessible through GetEnvVar and PutEnvVar. Actual Environment Files These environment, or prefs, files may also contain an INCLUDE directive to include another prefs file into the current one. INCLUDEs may be nested up to 8 levels deep before an error is reported. GlobalEnvVars ------------- Global Environment Variables _GE_ASLHeight Read Write The ASL Requester height stored here. _GE_ASLWidth Read Write The ASL Requester width stored here. _GE_AutoSaveTimer Read Write Time between autosaves. (minutes) _GE_BarHeight Read Only Window title bar height, calculated as: WBorTop + RastPort.TxHeight + 1 _GE_ClipUnit Read Write 'clipboard.device' unit number use by the global clip, normally this is 0, system default clipboard, so that you may exchange data with other programs. Should you wish to create a 'private' global clip just change this variable. _GE_ClockLeftEdge Read Write The pixel X position for the Edge clock. _GE_CloseDelay Read Write Close delay for the ARexx console, in seconds. _GE_CurrentDir Read Only Current directory path. _GE_CX_PopKey Read Write Hotkey description, 31 chars. _GE_CX_Priority Read Write Hotkey priority. _GE_Date Read Only String containing current time and date. _GE_DevName Read Only The editor device name, e.g. "EDGE" _GE_DictionaryFile Read Only Filename of the dictionary file. _GE_DirInk Read Write Text pen for FileRequester directories. This option is only available with Kickstart v39 or higher. _GE_ErrLevel Read Write Threshold for errors reported to the user. _GE_ErrListX Read Write X coordinate for the Error list window in GotoError. _GE_ErrListY Read Write Y coordinate for the Error list window in GotoError. _GE_FileInit Read Write Init string for printing file, 127 chars. _GE_FileInk Read Write Text pen for FileRequester files. This option is only available with Kickstart v39 or higher. _GE_Files Read Only Number of files in Edge. _GE_FindX Read Write X coordinate for Find/FindReplace. _GE_FindY Read Write Y coordinate for Find/FindReplace. _GE_Flags Read Write General flags, see Global Environment Flags - General _GE_FontFlags Read Only Soft Style flags, see Global Environment Flags - Font _GE_FootInit Read Write Footer init string, 127 chars. _GE_FootTitle Read Write Footer title, 127 chars. _GE_GadgetFontName Read Only Name of the gadget font, use empty string "" for system default font, max 31 chars. _GE_GadgetFontSize Read Only Size of the gadget font, 6 to 64, values out of range will be set to the nearest limit. _GE_GlobalFile Read Only Filename of the global settings prefs file. _GE_GlobalPattern Read Write GlobalSettings FileReq pattern, 31 chars. _GE_GlobalX Read Write X coordinate for GlobalSettings. _GE_GlobalY Read Write Y coordinate for GlobalSettings. _GE_HeadInit Read Write Header init string, 127 chars. _GE_HeadTitle Read Write Header title, 127 chars. _GE_IconWindowX Read Write Left edge for iconified Edge window. _GE_IconWindowY Read Write Top edge for iconified Edge window. _GE_InfoInk Read Write Text pen for status line. _GE_InfoPaper Read Write Background pen for status line. _GE_ItemInk Read Write Text pen for menu items. _GE_KeyboardFile Read Only Filename of the keyboard config file. _GE_LeftMargin Read Write Printer left margin. _GE_ListInk Read Write Text pen for lists-view gadgets. This option is only available with Kickstart v39 or better. _GE_LocalFile Read Only Filename of the local settings prefs file. _GE_LocalLoadMask Read Write Pattern for variables to be loaded from the files icon, 1023 chars. _GE_LocalSaveMask Read Write Pattern for variables to be saved in the files icon, 1023 chars. _GE_LockCount Read Only Locks made to 'EDGE:'. _GE_LocalX Read Write X coordinate for LocalSettings. _GE_LocalY Read Write Y coordinate for LocalSettings. _GE_MaxLast Read Write Max entries in the Last-Used list. _GE_MemPoolPudSize Read Write The size of the memory pool puddle value: minimum size 4096 bytes, no maximum value. _GE_MenusFile Read Only Filename of the menus config file. _GE_MessageInk Read Write Text pen for messages. _GE_Monitor Read Only Name of the monitor to use, 255 chars. _GE_MouseButtonsFile Read Only Filename of the mousebuttons config file. _GE_Palette Read Write The Edge custom screen palette. The palette is made up of hexadecimal RGB values, starting at pen 0. e.g. pen 0 R,G,B, pen 1 R,G,B, ... pen 15 R,G,B _GE_PaperLen Read Write Printer paper length. _GE_Printer Read Write Printer device, e.g. 'PRT:', 31 chars. _GE_Priority Read Write Edge process priority. _GE_PrtFlags Read Write Printer flags, see @{"Global Environment Flags - Printer" link globalenvflags} _GE_PunctuationMarks Read Write String of characters that marks the end of a sentence, used by Format. Defaults to "!.?", max 31 characters. _GE_RealGadgetFontName Read Only Actual name of the gadget font. _GE_RealGadgetFontSize Read Only Actual size of the gadget font. _GE_RealScreenFontName Read Only Actual name of the screen font. _GE_RealScreenFontSize Read Only Actual size of the screen font. _GE_RealScreenHeight Read Only The actual screen height in pixels. _GE_RealScreenWidth Read Only The actual screen width in pixels. _GE_RealTextFontName Read Only actual name of the text font. _GE_RealTextFontSize Read Only actual size of the text font. _GE_ReqChoiceX Read Write X coordinate for RequestChoice. _GE_ReqChoiceY Read Write Y coordinate for RequestChoice. _GE_ReqFile Read Only Filename of the req config file. _GE_ReqKeyX Read Write X position of RequestKey window when not pointer relative. _GE_ReqKeyY Read Write Y position of RequestKey window when not pointer relative. _GE_ReqFileX Read Write X coordinate for RequestFile (and ASL). _GE_ReqFileY Read Write Y coordinate for RequestFile (and ASL). _GE_ReqNotifyX Read Write X coordinate for RequestNotify. _GE_ReqNotifyY Read Write Y coordinate for RequestNotify. _GE_ReqNumberX Read Write X coordinate for RequestNumber. _GE_ReqNumberY Read Write Y coordinate for RequestNumber. _GE_ReqStringX Read Write X coordinate for RequestString. _GE_ReqStringY Read Write Y coordinate for RequestString. _GE_RexxConsole Read Write ARexx IO name, e.g. "con:...", 127 chars. _GE_RexxMsgOut Read Only Total number of ARexx messages sent. _GE_RightMargin Read Write Printer right margin. _GE_ScreenDepth Read Only Edge screen depth, 2 to 4, values out of range will be set to the nearest limit. _GE_ScreenFontName Read Only Name of the gadget font, use empty string "" for system default font, max 31 chars. _GE_ScreenFontSize Read Only Size of the screen font, 6 to 64, values out of range will be set to the nearest limit. _GE_ScreenHeight Read Only Edge screen height. _GE_ScreenName Read Only Name of the screen Edge is using. _GE_ScreenPens Read Only The Edge custom screen dri pens, defaults to 2,1,1,2,1,3,1,0,3,1,2,0. The pens are in the same order as the arguments to ScreenMode. _GE_ScreenWidth Read Only Edge screen width. _GE_ScreenX Read Only Screen relative x offset. _GE_ScreenY Read Only Screen relative y offset. _GE_ScrollJumpH1 Read Write Scroll smoothness for 1 char left/right. A value of -1 indicates the width of the current font. _GE_ScrollJumpHn Read Write Scroll smoothness for n chars left/right. A value of -1 indicates the width of the current font. _GE_ScrollJumpV1 Read Write Scroll smoothness for 1 line up/down. A value of -1 indicates the height of the current font. _GE_ScrollJumpVn Read Write Scroll smoothness for n lines up/down. A value of -1 indicates the height of the current font. _GE_SpacesAfterPunctuation Read Write Holds the designated number of spaces between the punctuation at the end of a sentence and the start of the next sentence to the given number during paragraph formatting. Default = 2. Min 1, Max 10 _GE_StartupFile Read Only Filename of the startup script. _GE_TabDistance Read Write Printer tab distance. _GE_TemplatesFile Read Only Filename of the templates file. _GE_TextFontName Read Only Name of the text font, use empty string "" for system default font, max 31 chars. _GE_TextFontSize Read Only Size of the text font, 6 to 64, values out of range will be set to the nearest limit. _GE_TextInk Read Write Text pen for text. NOTE: The number of bitplanes used when scrolling, etc, the text depends only on the color used, so for best speed and look you should select a pen that is a 2^n number; i.e. 1, 2, or 4. NOTE: The colors used to mark blocks are located in one of the planes not used by the text, so if you specify a text color that uses all bitplanes, you will not be able to see the block marking. _GE_ToolName Read Write The project-icon toolname, 127 chars. _GE_User0 Read Write User variable - 127 chars. _GE_User1 Read Write User variable - 127 chars. _GE_User2 Read Write User variable - 127 chars. _GE_User3 Read Write User variable - 127 chars. _GE_User4 Read Write User variable - 127 chars. _GE_User5 Read Write User variable - 127 chars. _GE_User6 Read Write User variable - 127 chars. _GE_User7 Read Write User variable - 127 chars. _GE_User8 Read Write User variable - 127 chars. _GE_User9 Read Write User variable - 127 chars. _GE_UserFlags Read Write User Flags, ignored by Edge. This field contains 32 flags 'F1 - 'F32', all available to the user. _GE_VisualScreenHeight Read Only Pixel height of visual screen area. _GE_VisualScreenWidth Read Only Pixel width of the visual screen area. _GE_WakeupFile Read Only Filename of the wakeup script. _GE_Windows Read Only This holds the number of windows opened. _GE_WndActComm Read Write Command to execute when a text window goes active, 127 chars, default "". _GE_WndCloseComm Read Write Command to execute when the user clicks on a textwindow closegadget, 127 chars, default "window close". _GE_WndDeActComm Read Write Command to execute when a text window goes inactive, 127 chars, default "". _GE_WndFlags Read Write Window flags, see Global Environment Flags - Window _GE_WordDelimiters Read Write The word-delimiter list. The string is 256 digits long, one digit for each character, consisting of '0', '1' and '2'. If the digit is a '1' the character is a 'word' character ('a', 'b', etc), if the digit is a '2' the character is a 'space' character (' ','\\t' and '\\n') and if the digit is a '0' then the character is neither a 'word' nor a 'space' ('.',':', etc). GlobalEnvFlags -------------- Global Environment Flags - General ( _GE_Flags ) AltSame In RequestKey both Alt keys the same; no left or right. AppIcon Puts an application icon on Workbench. ASLReq Use the ASL filerequester. AutoClock Enable clock if an Edge window is active, disable clock when no Edge window is active and not blocked by a requester. AutoDir Auto 'GetDir' when the FileRequesters directory attributes (path name and date) don't match with those of the specified directory. AutoSaveAll Save all files in the editor. AutoSaveChng Save only if any changes have been made. AutoSaveOn Auto save is active. AutoSaveReq Prompt the user before auto-saving. CacheDir The FileRequester caches directories. Clock Enable clock always. DornamtQuit Iconify instead of quit when the last window is closed. Edge will NOT iconify if there are any outstanding ARexx messages. All ARexx messages must return before Edge will iconify. GlobalIcon Create icon for GlobalSettings file. IconWindow Open a window on workbench when iconified. LoadLocal Load LocalSettings from icons. LocalIcon Create icon for LocalSettings file. MouseBlanker Enable the Edge mouse pointer blanker. QMAlt In RequestKey both Alts keys ignored as qualifiers. QMShift In RequestKey both Shift keys ignored as qualifiers. SaveLocal Save LocalSettings in icons. ShiftSame In RequestKey both Shift keys the same; no left or right. ShowDir Show dir/files during directory reads. CutRepeat Cut off overflowing 'REPEAT' keys. Global Environment Flags - Window ( _GE_WndFlags ) ---------------------------------------------------- AutoFront Auto move the window in front at activation. AutoUnZoom Auto unzoom window at activation. AutoZoom Auto zoom window at deactivation. ChoicePRel RequestChoice is pointer relative. ErrListPRel Error list, GoToError, is pointer relative. FilereqPRel RequestFile or ASL is pointer relative. FindPRel Find/FindReplace is pointer relative. GlobalPRel GlobalSettings is pointer relative. InfoTop Put status line at top of window. KeyPad Use 'KEYPAD' qualifier. KeyPRel RequestKey is pointer relative. LocalPRel LocalSettings is pointer relative. NotifyPRel RequestNotify is pointer relative. NumerPRel RequestNumber is pointer relative. ScrScroll Autoscroll the screen when the cursor moves beyond the visible part of the screen. This feature works only on Kickstart v39 or better. SnapSize Auto snap window size to even chars. StringPRel RequestString is pointer relative. Global Environment Flags - Printer ( _GE_PrtFlags ) ---------------------------------------------------- FootDate Put date in footer. FootName Put filename in footer. FootPage Put page # in footer. HeadDate Put date in header. HeadName Put filename in header. HeadPage Put page # in header. SpacesToTabs Convert spaces to tabs using internal tabs. TabsToSpaces Convert tabs to spaces using internal tabs. Global Environment Flags - Font ( _GE_FontFlags ) ------------------------------------------------- GadgetBold Bold style on gadget font. GadgetItalic Italic style on gadget font. GadgetScale Allow font scaling for gadget font. GadgetUnderline Underline gadget font. ScreenBold Bold style on screen font. ScreenItalic Italic style on screen font. ScreenScale Allow font scaling for screen font. ScreenUnderline Underline screen font. TextBold Bold style on text font. TextItalic Italic style on text font. TextScale Allow font scaling for text font. TextUnderline Underline text font. FileEnvVars ------------ File environment variables _FE_BackDir Read Write Backup directory path, max 95 chars. _FE_BackFile Read Write Backup file. If this field is blank the default backup file, *{#}, will be used, max 31 chars. * = the name of the file. # = current backup counter for this file. _FE_Changes Read Only Number of changes made to this file. _FE_ClipPath Read Write Path for the FileRequester used by the clip commands, 95 chars. _FE_ClipPattern Read Write Pattern for the FileRequester used by the clip commands, 31 chars. _FE_DosName Read Write Full name, e.g. "dh0:work/mysource.c", 126 chars. _FE_FindString Read Write The current find-string, 1023 chars _FE_Flags Read Write Flag field, see File Environment Flags. _FE_FoldEnd Read Write Fold end marker, max 31 chars, default '/*fe*/'. _FE_FoldStart Read Write Fold start marker, max 31 chars, default '/*fs*/'. _FE_Height Read Write Window height, -1 for default. _FE_IMark Read Write IMark image, used by FindIMark, max 31 chars. _FE_IncludePath Read Write Path for Include FileRequester, max 95 chars. _FE_IncludePattern Read Write Pattern for Include FileRequester, max 31 chars. _FE_LeftEdge Read Write Window left edge, -1 for default. _FE_LeftSB Read Write Left scroll border. _FE_Lines Read Only Number of lines in the file. _FE_LockCount Read Only Locks made to this file. _FE_LoweSB Read Write Lower scroll border. _FE_LocalPath Read Write Path for the FileRequester used by the LocalSettings command, 95 chars. _FE_LocalPattern Read Write Pattern for the FileRequester used by the LocalSettings command, 31 chars. _FE_MarkChar1 Read Write Bookmark 1, character offset. _FE_MarkChar10 Read Write Bookmark 10, character offset. _FE_MarkChar2 Read Write Bookmark 2, character offset. _FE_MarkChar3 Read Write Bookmark 3, character offset. _FE_MarkChar4 Read Write Bookmark 4, character offset. _FE_MarkChar5 Read Write Bookmark 5, character offset. _FE_MarkChar6 Read Write Bookmark 6, character offset. _FE_MarkChar7 Read Write Bookmark 7, character offset. _FE_MarkChar8 Read Write Bookmark 8, character offset. _FE_MarkChar9 Read Write Bookmark 9, character offset. _FE_MarkLine1 Read Write Bookmark 1, line number. _FE_MarkLine10 Read Write Bookmark 10, line number. _FE_MarkLine2 Read Write Bookmark 2, line number. _FE_MarkLine3 Read Write Bookmark 3, line number. _FE_MarkLine4 Read Write Bookmark 4, line number. _FE_MarkLine5 Read Write Bookmark 5, line number. _FE_MarkLine6 Read Write Bookmark 6, line number. _FE_MarkLine7 Read Write Bookmark 7, line number. _FE_MarkLine8 Read Write Bookmark 8, line number. _FE_MarkLine9 Read Write Bookmark 9, line number. _FE_MaxBackups Read Write Maximum number of backup copies to be cycled. _FE_Name Read Write Name of the file, e.g. "mysource.c", max 31 chars. _FE_OpenCount Read Only Opens made to this file. _FE_PageLen Read Write Page length for this file, minimum 1. _FE_Path Read Write Path for this file, e.g. "dh0:work/", max 95 chars. _FE_Pattern Read Write Pattern for Open/Save FileRequester, max 31 chars. _FE_ReplaceString Read Write The current replace-string, max 1023 chars _FE_RequestFilePath Read Write Path for the FileRequester used by the RequestFile command, 95 chars. _FE_RequestFilePattern Read Write Pattern for the FileRequester used by the RequestFile command, 31 chars. _FE_RightSB Read Write Right scroll border. _FE_RXName Read Write File for the FileRequester used by the RX command, 31 chars, default "". _FE_RXPath Read Write Path for the FileRequester used by the RX command, 95 chars, default "Rexx:". _FE_RXPattern Read Write Pattern for the FileRequester used by the RX command, max 31 chars, default #?.edge DosWildCards. _FE_RXString Read Write Current string in the RX buffer, max 1023 chars _FE_SavedChar Read Write Cursor offset when file was saved. _FE_SavedLine Read Write Cursor line when file was saved. _FE_Size Read Only Byte-size of the file. _FE_SmallClip Read Write The small clipboard buffer string, max 1023 chars. _FE_SmallClipType Read Write Type of clip, 0==normal, 1==columnar. _FE_TabList Read Write Tab stop list, 254 chars. _FE_TopEdge Read Write Window top edge, -1 for default. _FE_TopPtr Read Only Pointer to the first line. _FE_UndoBuff Read Write Byte-size of the undo buffer. _FE_UpperSB Read Write Upper scroll border. _FE_User0 Read Write Ten user variables, these are ignored _FE_User1 Read Write by Edge, max 127 chars. _FE_User2 Read Write _FE_User3 Read Write _FE_User4 Read Write _FE_User5 Read Write _FE_User6 Read Write _FE_User7 Read Write _FE_User8 Read Write _FE_User9 Read Write _FE_UserFlags Read Write User flags, these are ignored by Edge, contains 32 flags 'F1' - 'F32'. _FE_Width Read Write Window width, -1 for default. _FE_Windows Read Only Number of open windows in this file. _FE_WrapBorder Read Write Right border for Word Wrap and Format. _FE_ZoomHeight Read Write Window initial zoomed height, -1 for default. _FE_ZoomLeftEdge Read Write Window initial zoomed left edge, -1 for default. _FE_ZoomTopEdge Read Write Window initial zoomed top edge, -1 for default. _FE_ZoomWidth Read Write Window initial zoomed width, -1 for default. FileEnvFlags ------------ File Environment Flags ( _FE_Flags ) AutoIndent Auto indent enabled. Backup Make a backup when saving. Circular Search circular. CorrectCase Case correction enabled. Editable The file is editable. Forward Search forward in the file. Icon Create icon for this file. Insert Insert mode. (else overwrite mode) Layout Layout enabled. LineWrap Cursor wrap at line end/start. SafeSaves Do safe saves. ShowSpaces Show white spaces as '·' = space, '°' = tab and '¶' = LF. TabsToSpaces Convert tabs to spaces. UCEqlc Upper case is equal to lower case. Wild Use wildcards in search. Words Search only for whole words. WordWrap Word Wrap enabled. WindowEnvVars ------------- Window environment variables These variables are dependent upon the open window in Edge and are not kept in a file like the Global Enviroment variables '_GE_xxx', and the local environment variables named '_FE_xxx'. Instead they are dynamic and accessible whenever a window is open. Use the GetEnvVar and PutEnvVar commands to change these. _WE_ASCII Read Only Ascii value of the character under the cursor. _WE_ByteColumn Read Only Byte offset from start of line to the current cursor position. _WE_ByteOffset Read Only Byte offset from start of file to the current cursor position. _WE_CLine Read Only The raw contents of the current line. _WE_Column Read Only Current column number, first column is 0. _WE_Columns Read Only Number of chars that will fit in the window. _WE_CursorX Read Only Current cursor X position, 1st column is 0. _WE_CursorY Read Only Current cursor Y position, first line is 0. _WE_Line Read Only Current line number, first line is 0. _WE_Lines Read Only Number of lines that will fit in the window. _WE_Page Read Only Page number, first page is 1. _WE_RexxMsgOut Read Only The number of ARexx messages sent from this window. _WE_RexxPort Read/Write Name of this window's ARexx port, max 15 chars. Dos Wildcards ------------- The Amiga's Pattern Matching Wildcards... ? Matches any single character. For example, FI?E would match FILE, FINE and FIRE but not FIE. # Matches the following expression 0 or more times. For example, FRE#D would match FRE, FRED, FREDD, FREDDD, etc. #? will match anything. (a|b|c) Matches any one of the items seperated by '|'. For example, (D#?G|C#?T) would match DOG, CAT, DIG, COT, etc. ~ The tilde, the upper left key on most keyboards, negates the following expression. It matches all strings that do not match the expression. For example, F~(ROG)#? will match FROM but not FROG. ~J#? will match anything not starting with the letter J. [abc] A character class: matches only the characters in the class. For example, a[bcd] will match ab, ac and ad but not ae. [~abc] The tilde here indicates a negated character class: matches only the characters not in the class. For example, a[~bc] will match ad and ae but not ab and ac. [a-z] Character range (only within character classes). For example, [a-z] represents all the lowercase letters from a to z. [a-cx-z]#? would match any name starting with the letters a, b, c, x, y or z. % Matches the null string. For example, CA(M|%)P will match CAMP and CAP. ' The apostrophe, found on most keyboards just to the left of the return key. This character is used to declare the following character to be a literal character, instead of a possible wildcard symbol. This permits you to use the characters #, ?, |, %, (, ), [, ], *, ~ and even an apostrophe as themselves. For example, YEAR#?'% will match YEAR1989%, YEAR1990% but not YEAR1989 or YEAR1990 as would normally be the case NOTE: The term "expression", above, means either a single character (ex: "#?"), or an alternation (ex: "#(ab|cd|ef)"), or a character class (ex: "#[a-zA-Z]"). More Pattern Matching Examples: A?B Matches any three letter names beginning with A and ending with B, such as AcB, AzB and alb. A#BC Matches any name beginning with A, ending with C and having any number of Bs in between, such as AC, ABC, ABBC, ABBBC and so on. A#(BC) Matches any name beginning with A and followed by any number of BC combinations, such as ABC, ABCBC, ABCBCBC and so on. A(B|C)D Matches ABD or ACD. ABC#? Matches any name beginning with ABC, reqardless of what follows, such as ABCD, ABCDEF.info or ABCXYZ. #?XYZ Matches any names ending in XYZ, requardless of what precedes it, such as ABCXYZ and ABCDEFXYZ. [A-D]#? Matches any name beginning with A, B, C or D. ~(XYZ) Matches anything but XYZ. ~(#?XYZ) Matches anything not ending in XYZ. A(B|D|%)#C Matches ABC, ADC, AC (% is the null string), ABCC, ADCC, ACCC and so on. ARexx Help ---------- ARexx specific information... The ARexx Cookbook, by Merrill Callaway WHITESTONE, 511-A Girard SE, Albuquerque, NM 87106 (505) 268-0678 ($54.90 book & two example disks postage paid). Amiga Programmer's Guide to ARexx, by Eric Giguere Commodore-Amiga, Inc., 1991 Using ARexx on the Amiga, by Chris Zamara and Nick Sullivan Abacus, 1991 ISBN 1-55755-114-6 There are ARexx forums on BIX, CompuServe, GENIE and PORTAL. Rexx scripting information... Practical Usage of REXX, by Anthony S. Rudd Ellis Horwood/Simon & Schuster, 1990 ISBN 0-13-682790-X Programming in REXX, by Charles Danny McGraw Hill, 1992 ISBN 0-07-15305-1 The REXX Handbook, edited by Gabe Goldberg and Phil Sullivan McGraw Hill, 1991 ISBN 0-07-023682-8 The Rexx standard... The REXX Language, 2nd edition, by M.F. Cowlishaw Prentice-Hall, 1985 ISBN 0-13-780651 This book is considered the current standard for the REXX language. It is often just referred to as either "TRL" or "The Red Book". Until ANSI, committee X3J18, releases its standard, this book is IT. Copyright Information --------------------- Edge v1.70 (c) Copyright 1992-93, Thomas liljetoft, All Rights Reserved ALL SOFTWARE PROGRAMS AND DOCUMENTATION PROVIDED HEREIN, WITH THE EXCEPTION OF AMIGA INSTALLER AND AMIGAGUIDE PROGRAMS, ARE ENTIRELY COPYRIGHT 1993 BY THOMAS LILJETOFT. ALL RIGHTS ARE RESERVED. YOU MAY NOT COPY, MODIFY, OR TRANSFER THE PROGRAMS OR DOCUMENTATION BY ANY MEANS WHATSOEVER. THE PROGRAMS AND DOCUMENTATION ARE SOLD "AS IS" AND SUBJECT TO CHANGE; NO WARRANTIES ARE MADE. ALL USE IS AT YOUR OWN RISK. NO LIABILITY OR RESPONSIBILITY IS ASSUMED. The following copyright and licensing information refers only to Amiga Installer and AmigaGUIDE files contained in this package. Installer Version 2.17 (c) Copyright 1991-93 Commodore-Amiga, Inc. All Rights Reserved Reproduced and distributed under license from Commodore. AmigaGuide and AmigaGuide.info Version 34.3 AmigaGuide.Library Version 34.11 (c) Copyright 1991-93 Commodore-Amiga, Inc. All Rights Reserved. Reproduced and distributed under license from Commodore. INSTALLER AND AMIGAGUIDE SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE; NO WARRANTIES ARE MADE. ALL USE IS AT YOUR OWN RISK. NO LIABILITY OR RESPONSIBILITY IS ASSUMED. Technical Support Information ----------------------------- Technical support is only available to registered users, so don't forget to send in your registration card. Feel free to write/fax to the USA address with suggestions and comments about Edge. Technical support is available on these telecom services: We have conference areas on... BIX inovatronics CompuServe AMIGAVEND, area 8 Portal inovatronics Electronic mail addresses... BIX inovatronics CompuServe 75300,361 Portal inovatronics Internet inovatronics@bix.com Our various addresses around the world: INOVAtronics, Inc. Tel: (214) 340-4991 8499 Greenville Ave. Suite 209B FAX: (214) 340-8514 Dallas, TX 75231 USA Orders: (800) 875-8499 (North America Only!) Hours: 9:00am-5:30pm CST/CDT Tech Support: (214) 340-4992 Hours: 11:00am-3:00pm CST/CDT BBS: (214) 342-1930 Inovatronics GmbH Tel: 49-2241-40 68 56 Lütticher Straße 12 FAX: 49-2241-40 67 73 D-53842 Troisdorf-Spich Germany Inovatronics, Ltd. Tel: 44-707-662861 Unit 11, Enterprise Centre FAX: 44-707-660992 Cranborne Road Potters Bar, Hertfordshire EN6 3DQ England