═══ 1. Help file version. ═══ This information is for ZED 1.0s , shareware version. ═══ 2. ZED Registration Information ═══ Please read all registration information. Registering ZED To register, send a check or money order for $10.00 US currency to: E. Bruce Shankle III 6126 Bushmills Street Raleigh, NC 27613 USA Please include your name and address or email address. You will receive confirmation of your registration along with your serial number. This entitles you to support, free upgrades and notices of other new products. If you have any questions or comments, I can be reached at the above address or one of the following email addresses: ivisoft@cybernetics.net Bruce_Shankle@msn.com ZED text editor for OS/2 is Copyright (C) E. Bruce Shankle III. ALL RIGHTS RESERVED ZED is shareware. Please read the ZED Shareware Agreement below. ZED Shareware Agreement You are allowed to use ZED and evaluate it for a period of thirty (30) days from the date of installation. The original install date is displayed in the status bar along the lower edge of the main window. After using ZED for thirty days, you must decide if it's something you want to keep. If you wish to keep ZED, you must register. If not, you must discontinue use of ZED. When you register you will be assigned a serial number that you can use to obtain support via email, free upgrades, and notices of new products. I've put many long hours of coding and testing into ZED. My goal is to provide an editor for OS/2 that is easy to use and more functional than those supplied with the system. The shareware concept only works if you do your part to support the authors. If you find ZED useful and do not register, you're hurting me and other shareware developers. ZED will continue to function after the 30-day trial period, as I do not believe in cripple-ware, but you are violating this agreement and hurting yourself and me if you don't register. What is shareware? Shareware applies to software products you are allowed to try before you buy, like ZED. That way, you will know if the product is of use to you. If you find the product useful and wish to continue using it beyond the trial period, you must pay for the product. This is usually called registration. If you don't find the product useful, you must delete it from your computer. It is also nice to contact the author of the shareware and tell them why you don't want it and things they could do to improve the product. Shareware helps keep the software market competitive, and prices lower for everyone. The shareware concept does not work when someone decides to keep and use a product without registering it. This hurts the shareware author, and eventually shareware users. So please register the shareware that you like and use on a regular basis. Distribution You are encouraged to distribute ZED free of charge to ftp sites, friends, co-workers, and BBS systems. Corporate users and those using ZED in any for-profit organization or business may contact me and establish a licensing agreement for your site. I can be reaced at: Bruce Shankle 6126 Bushmills St. Raleigh, NC 27613 USA or ivisoft@cybernetics.net Bruce_Shankle@msn.com You may not distribute the files that you have installed on your system. Distribute pre-installation files only. If you wish to distribute ZED, distribute the file ZED_10S.ZIP. This file should be on the original ZED distribution floppy, or it is the file you downloaded. ZED_10S.ZIP contains: ZED.EXE ZED.HLP ZED.ICO README.TXT INSTALL.EXE You are not allowed to make any changes to any of the original files. You are not allowed to sell ZED for profit unless it is part of a shareware-only archive like Walnut Creek's HOBBES CD-ROM. Disclaimer General Help ═══ 2.1. Disclaimer ═══ Although every effort has been made to insure ZED is a stable program, the author, E. Bruce Shankle III, may not be held liable for any damages caused by, related to, or coinciding with the use of ZED. Use ZED at your own risk. If you don't agree with the the above, then you may not use ZED. Delete it now. General Help ═══ 3. General Help ═══ ZED is an easy-to-use text editor for OS/2. It is designed for editing plain text files. ZED Registration Information Keys help Menus Settings ═══ 4. Settings ═══ The following settings are located in the "Settings" menu. To toggle a setting select it from the menu or use the appropriate keys. If a setting is checked that setting is enabled. If it is not checked then it is disabled. Auto-indent - Ctrl+A Enable or disable auto-indent. Auto-indent automatically inserts spaces or tab characters after the enter key is pressed to align it with the previous text. If the previous line contains no text then the new line is not indented. Case-sensitive filenames - Ctrl+E Enable or disable case-sensitive file names. This setting determines whether or not ZED oberves case in file names. If enabled, ZED will not convert the case of file names. If disabled, ZED will convert all filenames to upper case. If you have a file system that supports case sensitive file names, such as HPFS, you may wish to enable this setting. Status bar - Ctrl+S The status bar contains useful information: current line and column, key-states, text modification status, and current time. When editing very large files, performance will be increased by disabling the status bar. Word wrap - Ctrl+W When word wrap is enabled, all text is truncated to fit within the edit window. This does not add or removed characters from the text. When word wrap is disabled, text may extend beyond the current window. Auto-save... Using auto-save Color... Changing colors Font... Changing fonts Tabs... Tab Settings Menus General Help ═══ 5. Using auto-save ═══ ZED provides auto-save features to help insure your text is not lost in the event of a power outage or system failure. Auto-save can be configured to save based on elapsed time and/or based on the number of modifications to the text. Auto-save can also generate a file name for an untitled document or prompt for a file name, depending on how you configure the auto-save settings. ZED does not auto-save text that has not been modified. ZED Auto-save settings are configured in the ZED AutoSave dialog window. To activate this window, select "Auto-save..." from the "Settings" menu. Automatic save every XX minutes Check this option to automatically save your document every time the specified time passes. The time interval, represented by the "XX" above, is in minutes and can be from 1 to 60. Automatic save every XXXX modifications Check this option to automatically save your document after the specified number of modifications. The number of modifications, represented by the "XXXX", is the number of key presses that modifiy text in ZED's edit window. This value can be from 1 to 5000. Prompt for name if untitled Check this option if you want ZED to prompt you for a file name when it needs to auto-save untitled text. If this option is not checked, ZED will automatically generate a file name for the text: i.e. AUTOSAVE.001. Automatically generated file names will range from AUTOSAVE.001 to AUTOSAVE.999 and will be located in the directory where ZED.EXE is located. If the maximum number of auto-generated file names is reached, ZED will issue a warning and the auto-save operation will fail. If this happens, it is best to delete some of the auto-saved files or enable this option. When you are done, click the "OK" button. The settings will be saved when you exit ZED or select "Save settings" from the "Settings" menu. Click the "Cancel" button to cancel any changes. If auto-save fails, insure that you enough free storage space to save the text. Also make sure that you are not running ZED from read only media like CD-ROM or a network server where you don't have write permission. Settings menu General Help AutoSave message box - prompt for file name AutoSave message box - Warning ═══ 5.1. AutoSave message box - prompt for file name ═══ A message box is displayed when AutoSave is configured to prompt for a filename. Clicking the "OK" button in this message box will bring up the "Save" dialog window to allow you to give the current text a file name. Auto-save help ═══ 5.2. AutoSave message box - Warning ═══ If you fail to supply a file name in the "Save" window when AutoSave prompts for one, you will be issued this warning. This is just a warning, but you will recieve this warning each time auto-save activates and you don't supply a file name when it prompts for one. Auto-save help ═══ 6. Changing colors ═══ Changing colors in ZED is simple and takes advantage of OS/2's "Color Palette". To change colors, select "Color..." from the "Settings" menu. This will bring up a color palette. Click on a color with the right mouse button and hold the right mouse button down. Then move the mouse pointer over ZED's edit window. The mouse pointer will change to an icon that represents a color. (In OS/2 Warp, this is a paint bucket.) Release the mouse button when the pointer is over ZED. When you have dragged a new color to the edit window a dialog window will ask if you wish to apply the new color to the text or to the window background. You may cancel the color change by selecting the "Cancel" button. You may also undo the color change by selecting "Undo" from the "Edit" menu just after you have made the color change. ZED will save the color settings in it's profile when you exit ZED or when you select "Save settings" from the "Settings" menu. Settings menu General Help ═══ 7. Changing fonts ═══ Changing fonts in ZED is simple and takes advantage of OS/2's "Font Palette". ZED supports all OS/2 fonts, but only one font at a time may be used. To change fonts, select "Font..." from the "Settings" menu. This will bring up a font palette. Click on a font with the right mouse button and hold the right mouse button down. Then move the mouse pointer over ZED's edit window. The mouse pointer will change to an icon that represents a font. (In OS/2 Warp, this is a pencil.) Release the mouse button when the pointer is over ZED. When you have dragged a new font to the edit window, the font will be applied to all text. You may undo the font change by selecting "Undo" from the "Edit" menu just after you have made the font change. ZED will save the font setting in it's profile when you exit ZED or when you select "Save settings" from the "Settings" menu. Settings menu General Help ═══ 8. Keys help ═══ ZED provides keyboard accelerators for most options. General window keys. ┌──────────┬────────────────────┐ │Alt+F5 │Restore - Restore │ │ │window state after a│ │ │maximize or │ │ │minimize. │ ├──────────┼────────────────────┤ │Alt+F7 │Move - Move window. │ ├──────────┼────────────────────┤ │Alt+F8 │Size - Change window│ │ │to be sized. │ ├──────────┼────────────────────┤ │Alt+F9 │Minimize - Minimize │ │ │window. │ ├──────────┼────────────────────┤ │Alt+F10 │Maximize - Maximize │ │ │window. │ ├──────────┼────────────────────┤ │Alt+F4 │Close - Close ZED. │ ├──────────┼────────────────────┤ │Ctrl+Esc │Window list - │ │ │Display active │ │ │program list. │ └──────────┴────────────────────┘ ZED file menu accelerator keys. ┌──────────┬────────────────────┐ │Ctrl+O │Open - Open a file. │ │ │Display file open │ │ │dialog window. │ ├──────────┼────────────────────┤ │Ctrl+I │Import - Import a │ │ │file. Display file │ │ │import dialog │ │ │window. │ ├──────────┼────────────────────┤ │F2 │Save - Save current │ │ │text. │ ├──────────┼────────────────────┤ │F4 │Save and exit - Save│ │ │current text and │ │ │exit ZED. │ ├──────────┼────────────────────┤ │F3 │Exit - Exit ZED. │ ├──────────┼────────────────────┤ └──────────┴────────────────────┘ ZED edit menu accelerator keys. ┌──────────┬────────────────────┐ │Ctrl+Z │Undo - Undo last │ │ │text or color change│ │ │operation. │ ├──────────┼────────────────────┤ │Ctrl+X │Cut - Remove │ │ │selected text and │ │ │place in clipboard. │ ├──────────┼────────────────────┤ │Ctrl+C │Copy - Copy selected│ │ │text to clipboard. │ ├──────────┼────────────────────┤ │Ctrl+V │Paste - Insert text │ │ │from clipboard at │ │ │current cursor │ │ │location. │ ├──────────┼────────────────────┤ │Del │Delete - Remove │ │ │selected text. │ ├──────────┼────────────────────┤ │Ctrl+F │Find - Activate find│ │ │dialog window. │ ├──────────┼────────────────────┤ │F5 │Find next - Find │ │ │next instance of │ │ │search text. │ ├──────────┼────────────────────┤ │Ctrl+R │Replace - Activate │ │ │replace dialog │ │ │window. │ └──────────┴────────────────────┘ ZED settings menu accelerator keys. ┌──────────┬────────────────────┐ │Ctrl+A │Auto-indent - Toggle│ │ │autoindent. │ ├──────────┼────────────────────┤ │Ctrl+E │Case-sensitive │ │ │filenames - Toggle │ │ │use of │ │ │case-sensitive │ │ │filenames. │ ├──────────┼────────────────────┤ │Ctrl+S │Status Bar - Toggle │ │ │status bar. │ ├──────────┼────────────────────┤ │Ctrl+W │Word wrap - Toggle │ │ │word wrap. │ └──────────┴────────────────────┘ ZED miscellaneous keys. ┌───────────────┬────────────────────┐ │F1 │Help - Activate │ │ │help. │ ├───────────────┼────────────────────┤ │Ctrl+Insert │Copy - Copy selected│ │ │text to clipboard. │ ├───────────────┼────────────────────┤ │Shift+Insert │Paste - Insert text │ │ │from clipboard at │ │ │current cursor │ │ │location. │ ├───────────────┼────────────────────┤ │Escape │Escape - Pressing │ │ │escape on a dialog │ │ │window will close │ │ │that window. │ └───────────────┴────────────────────┘ Edit window keys The behavior of the edit window, when typing, depends on whether it is in insert or overtype mode, and whether the selection is empty or not. When a character is typed, it replaces the current selection. If the selection is empty, the character is viewed as replacing nothing, so the character is effectively inserted into the text. If one or more characters are selected, those characters are deleted from the text and replaced by the typed character. If the edit window is in insert mode, the cursor is moved to follow the typed character. If the edit window is in overtype mode, the cursor is moved to immediately follow the newly typed character and characters after it are over typed. If the typing causes the cursor to go off the screen in any direction, the display is automatically scrolled. If word-wrap is on, text continues on a new line, otherwise, the screen is scrolled horizontally. Scrolling of the text in the window is independent of cursor movement. The cursor and selection remain unaltered at the same location within the text during all scrolling but the converse is not true. Any movement of the cursor causes auto-scrolling, if necessary, to ensure that the text location of the cursor is visible within the window. Return: Return (ASCII newline) causes a hard line-break, and the following text begins on a new line. A line-break character is inserted in the text, which is drawn as a few pels of white-space (for selection purposes). Keystroke commands: For all the following keys, unless otherwise noted, the display is scrolled, if necessary, to keep the cursor point visible. Where noted, the cursor setting behaves differently in insert mode than in overtype mode. This is subject to the boundary conditions noted above. Del Causes the contents of the selection region to be deleted. If the selection region contains no text, it causes the character to the right of the cursor to be deleted. Shift+Del Causes the contents of the selection region to be cut to the clipboard. Insert Toggles between insert and overtype mode. The edit window ignores the Insert key when it occurs without a modifier. Shift+Ins Causes the contents of the clipboard to replace the selection region. Ctrl+Ins Causes the selection region to be copied to the clipboard. The selection region is not otherwise affected. Backspace Functions similar to Del. If the selection is not empty, Backspace deletes the selection. If the selection is empty, Backspace deletes the character to the left of the cursor point. If the edit window is in overtype mode, the anchor point is set, and the cursor point is moved to be one character previous in the text. If no such character exists (because the anchor is set to the beginning of the text) the cursor is set to the anchor point. If the edit window is in insert mode, the cursor and anchor points are set, as defined at the start of this chapter. Down Arrow Sets the cursor point to the closest insertion point on the following line, then sets the anchor point to the cursor point (insertion mode) or one character following (overtype mode). Shift+Down Arrow Causes the cursor point to be moved to the closest insertion point on the following line. The anchor point does not move. Up Arrow Sets the cursor point to the closest insertion point on the preceding line, then sets the anchor point to the cursor point (insert mode) or one character following (overtype mode). Shift+Up Sets the cursor point to the closest insertion point on the preceding line. The anchor point is not moved. Right Arrow Sets the cursor point to the insertion point one character following the cursor point. The anchor point is set to the cursor point (insert mode) or one character following (overtype mode). Shift+Right Causes the cursor point to be set to the insertion point immediately following the previous cursor point. The anchor point is not moved. Left and Shift+Left Work analogously. Ctrl+Right Moves the cursor point to the insertion point immediately preceding the next word in the text including trailing spaces, and sets the anchor point to be equal to (insert mode) or one character following (overtype mode) the cursor point. The EOL (hard line-break) and tab characters are treated as words. Ctrl+Shift+Right Moves only the cursor point in the same way as Ctrl+Right, but leaves the anchor point unmoved. Ctrl+Left Moves the cursor point to the preceding insertion point at the beginning of a word, and sets the anchor point to be equal to (insert mode) or one character following (overtype mode) the cursor point. The EOL (hard line-break) and tab characters are treated as words. Ctrl+Shift+Left Moves only the cursor point in the same way as Ctrl+Left but leaves the anchor point unmoved. Pagedown and Pageup Cause the display to be scrolled one screen at a time in either direction. This behavior is the same as would be encountered during a page-down or page-up caused by the scroll-bar. Ctrl+Pagedown and Ctrl+Pageup Cause the display to be scrolled one screen at a time to the right or left respectively. This behavior is the same as would be encountered during a page-right or page-left caused by the scroll-bar. Home Sets the cursor point to the insertion point at the beginning of the line containing the cursor point, and sets the anchor point equal to (insert mode) or one character following (overtype mode). Shift+Home Moves the cursor point to the insertion point at the beginning of the line. The anchor point is not moved. End Sets the anchor point to the insertion point at the end of the line containing the cursor point. If the last character on the line is a line-break character, the anchor is positioned just before it. The cursor is set equal to (insert mode) or one character previous to (overtype mode) the anchor. Shift+End Moves the cursor point to the insertion point at the end of the line, as above. The anchor point is not moved. Ctrl+Home Moves the cursor point to the insertion point at the beginning of the document. The anchor point is set equal to (insert mode) or one character following it (overtype mode). Ctrl+End Moves the anchor point to the insertion point at the end of the document. The cursor point is set to be equal to the anchor point (insert mode) or one character preceding it (overtype mode). Ctrl+Shift+Home Moves the cursor point in the same way as Ctrl+Home, but leaves the anchor point unmoved. Ctrl+Shift+End Moves the cursor point in the same way as Ctrl+End, but leaves the anchor point unmoved. General Help ═══ 9. Menus ═══ ZED's menu structure is organized for efficient editing using a mouse or the keyboard. File Menu Edit Menu Settings Menu General Help ═══ 9.1. File Menu ═══ The following selections are available in the "File" menu. New - edit new of different file. Clear text from edit window and close current file. If the current text is modified and not saved, ZED will ask if you want to save it. This menu item is disabled if the current text is empty. Open - Ctrl+O - open a file. Bring up file open dialog window. Select a file, and ZED will open it and you can edit it. Import - Ctrl+I - import a file. Bring up file import dialog window. Select a file to import into the current text. The text in the file will be inserted at the current cursor location. Save - F2 - save current text. Save the current text in a file. If the text is untitled, open save dialog window to assign the file a directory and name. This menu item is disabled if the current text has not been modified. Save as - save current text in a new or different file. Save and exit - F4 - save current text and exit. Save the current text in a file and exit. If the text is untitled, open save dialog window to assign the file a directory and name. If the text has a file name, save text to that file and then exit. This menu item is disabled if the current text has not been modified. Select printer... - select target print object. Select printer object to recieve printed text. Optionally set job properties. Printer information... - view detailed printer information. Show detailed information about each installed printer object. Print... - print text. Send text to printer. This opens a dialog window that allows you to set priority, copies, and job properties before actually printing. If a line of text exceeds the width of the print area, it is truncated. Spawn ZED - start another program instance. Start a new copy of ZED. Recent file list - quickly open a previously opened file. ZED allows up to 9 file names in the recent file list. These file names are stored in when you exit ZED or select "Save settings" from the settings menu. When you open a file it's name is added to the recent file list. If the file is already in the list, it is brought to the top of the list. If the file list is full, ZED removes the last entry to make room for the new entry. Exit - F3 - exit ZED. Close ZED. Prompt to save any modified text. Menus General Help ═══ 9.2. Edit Menu ═══ The following selections are available in the "Edit" menu. Note: Some options are not always available. For example, "Paste" is disabled if there is not text in the clipboard. Undo - Ctrl+Z - undo last operation. This allows most text changes to be undone, such as deleting or inserting something. It also allows color and font changes to be undone. The undo operation, cannot undo some operations, such as deleting a large amount of text. Undo only undoes the last operation. Cut - Ctrl+X - cut selected text and place in clipboard. This menu item is disabled if no text is selected. Copy - Ctrl+X - copy selected text to clipboard. This menu item is disabled if no text is selected. The Ctrl+Insert key sequence also activates this function. Paste - Ctrl+V - insert text from clipboard at current cursor location. This menu item is disabled if no text is in the clipboard. The Shift+Insert key sequence also activates this function. Delete - Del - delete selected text. This menu item is disabled if no text is selected. Find... - Ctrl+F - show find dialog window. When the find dialog window is displayed, text can be entered and ZED will search for that text. If the text is found, it will be selected and scrolled into view. If it is not found, ZED will issue a message. This menu item is disabled if there is no text. Find next - F5 - find previously searched text again. Search for the next instance of the previously searched text, automatically wrapping to the beginning if it reaches the end of the text. If the text is found, it will be selected and scrolled into view. If it is not found, ZED will issue a message. This menu item is disabled if there is no text. Replace - Ctrl+R - show replace dialog window. When the replace dialog window is displayed, search and replace text can be entered. ZED will replace the search text with the replace text. You have the option to verify each replace operation or allow ZED to replace all instances of the search text. If the text cannot be found, ZED will issue a message. This menu item is disabled if there is no text. Menus General Help ═══ 9.3. Settings Menu ═══ For help with the settings menu, please refer to "Settings". Settings ═══ 10. Tab Settings ═══ ZED allows the tab key functionality to be configured for inserting a certain number of spaces or the tab character. ZED tab settings are configured in the ZED Tabs dialog window. To activate this window, select "Tabs..." from the "Settings" menu. Spaces Click the "Spaces" radio button for ZED to insert spaces instead of the tab character. The number of spaces inserted can range from 1 to 20. This is useful for when working with technical documents where the tab character may be interpreted differently by different editors or where indentation spacing is critical ( i.e. C Source code). Use a mono-spaced font for best results with this setting. Tab character Click the "Tab character" radio button for ZED to insert the tab character instead of spaces. This is useful for formatting columns of text when using a proportional font. When you are done, click the "OK" button. The settings will be saved when you exit ZED or select "Save settings" from the "Settings" menu. Click the "Cancel" button to cancel any changes. Settings menu General Help