POINT & SHOOT EDITOR 1.0 Copyright (C) 1988 -- All Rights Reserved Applied Micro Systems Technology Kurt H. Diesch Member - Association of Shareware Professionals Revised: February 27, 1988 Point & Shoot Editor is a text file editing program designed for IBM Personal Computers and 100% compatibles. Applied Micro Systems Technology reserves the COPYRIGHT to this program and all related materials. The user is granted a non-exclusive license to use the program and is encouraged to pay for the program if it is found to be useful. A $15 registration fee will entitle the user to full registration including one free update, support, and input to product improvements. Government and business entities may not use the program without paying the registration fee. If you received the Point & Shoot Editor bundled with another AMST shareware product and have registered that program with AMST, you need not pay the registration fee for your copy of the Point & Shoot Editor. Whether or not you are submitting a registration fee, please register your program with the form included at the end of the documentation. REMEMBER: Shareware is not free! Send payments to: Applied Micro Systems Technology P.O. Box 1596, Welch Ave. Station Ames, Iowa 50010 The user is also granted permission to make unlimited copies of the program and to distribute those copies as long as no fee is charged for the program. A duplication charge not to exceed $5 may be collected. Applied Micro Systems Technology specifically disclaims all warranties, expressed or implied, including but not limited to, implied warranties of merchantability and fitness for any particular purpose. In no event shall Applied Micro Systems Technology be liable for any loss of profit or any other commercial damage, including but not limited to special, incidental, consequential or other damages. MEMBER - ASSOCIATION OF SHAREWARE PROFESSIONALS The author of this program is a member of ASP and has agreed to comply with its standards: Programming standards- - The program meets ASP's definition of Shareware. - The program has been thoroughly tested by the author and should not be harmful to other files or hardware if used properly (although ASP cannot warrant this; therefore, the user should take normal precautions in trying new software). Documentation standards- - Sufficient documentation is provided to allow the average user to try all major functions of the program. - The program author has explained the Shareware concept in a professional and positive manner. Support standards- - The program author will respond as described in the documentation to people who send registration payments. At a minimum, the author will send an acknowledgement of payment. - The author will respond to written bug reports from registered users when the user provides a self-addressed, stamped envelope (some authors will respond by phone, but this is not an ASP requirement). - Incompatibilities with other software or hardware, major or unusual program limitations, or known problems are noted in the documentation that comes with the shareware version of the program. General- - The author keeps his/her membership in ASP current. - The author recognizes that any user may appeal to ASP for any unresolved dispute that arises. If you feel that the author has not complied with these standards in some manner or if you register the program with the author and subsequently have any disputes with the author which cannot be resolved, please write the ASP at: Association of Shareware Professionals 325 118th Ave SE, Suite 200 Bellevue, WA 98005 While ASP cannot warrant programs nor the actions of members, ASP will do what it can to assure that all authors who claim membership comply with ASP standards. These standards are the assurance of quality and support that you will get when you register Shareware produced by ASP members. SHAREWARE To promote better understanding of the shareware concept, ASP has developed the following official definition of shareware: Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to register. Individual programs differ on details -- some request registration while others require it, some specify a maximum trial period. With registration, you get anything from the simple right to continue using the software to an updated program with printed manual. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. SO, Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee -- if you don't use the product, you don't pay for it. TABLE OF CONTENTS ----------------- INTRODUCTION .................................... 1 INSTALLATION .................................... 2 STARTUP OPTIONS ................................. 3 EDITOR COMMANDS ................................. 4 Overview & Command Summary .................... 4 The Editing Screen ............................ 5 Options ....................................... 5 Cursor Movement ............................... 6 Editing Commands .............................. 7 Search Commands ............................... 8 Block Commands ................................ 9 Miscellaneous Commands ........................ 10 REGISTRATION FORM ............................... 11 INTRODUCTION ------------ The Point & Shoot Editor supports the following functions: o Full-screen editing of text files up to 64K o Autoindentation o Fixed or smart tabs (tab to previous line words) o Block operations o Find and replace operations o Printing o Pop-up directory list o On-line help o Full integration with Point & Shoot, the hard disk menu and file manager program I am more than willing to enhance the program to meet the needs of you, the user. I have many enhancements to the program in mind, and suggestions for program improvement are welcome. As you are well aware, part of the reward for writing well-received software is monetary. If you like the Point & Shoot Editor, I would appreciate a $15 payment to support my programming habit. This registration fee entitles you to receive notices of future upgrades, the first upgrade free, and support. Please use the registration form in this manual when sending registering your copy of the program. NOTE: If you received your copy of the Point & Shoot Editor as part of a bundled shareware package of AMST products, then the registration fee is not required. Please send in the registration form whether or not you are paying the registration fee. The Point & Shoot Editor requires the following hardware and software: o IBM or 100% compatible computer with 128K minimum memory o MS-DOS version 2.0 or greater o Color/graphics, monochrome, EGA or VGA display adaptor - 1 - INSTALLATION ------------ Installation of this program is as simple as operating the program itself. If any problems are encountered, first check your computer. If you still have problems, enlist the aid of your local computer guru. A third, but slower alternative, is to drop me a line and I will try to give you some assistance (note that registered users will receive highest priority!). The only file required to use the Point & Shoot Editor is PASE.EXE. Simply copy PASE.EXE to the desired disk or directory. If you would like to run the Point & Shoot Editor from any directory on a hard disk, make sure the PATH command in your AUTOEXEC.BAT file points to the directory containing the PASE.EXE file. The only other file included with the Point & Shoot Editor is this documentation file, PASEDOC.TXT. - 2 - STARTUP OPTIONS --------------- STARTUP OPTIONS There are three startup options available with the Point & Shoot Editor. Each of these options is invoked at the DOS command prompt when starting the program. 1) STARTUP FILE: The name of the file you want the program to load for initial editing. For example: C> PASE TEXTFILE.TXT In the example, the Point & Shoot Editor would immediately load the file named TEXTFILE.TXT. If the named file does not exist, a new file is assumed. 2) BACKUP FILES: The Point & Shoot Editor can optionally make backup files (.BAK) whenever the current edit file is saved. To invoke this command, use the /B parameter: C> PASE /B 3) SNOW REMOVAL: Some older CGA monitors may display snow on the screen. To correct this problem, use the /S command line parameter. C> PASE /S The startup options may be given in any order. If you are executing the Point & Shoot Editor via the POINT & SHOOT (the file manager) FILE EDIT command, the parameters are automatically transferred to the Point & Shoot Editor. - 3 - EDITOR COMMANDS --------------- OVERVIEW & COMMAND SUMMARY The Point & Shoot Editor is a full-screen text editor very much like WordStar's non-document mode the program editors found in Borland products such as Turbo Pascal, Turbo C, or SideKick. If you are familiar with any of these editors, you should need little help in using the Point & Shoot Editor. You enter text in the Point & Shoot Editor similarly to the way you type on a typewriter. However, there are a few important differences. The cursor (a flashing underscore) always indicates where new text will be entered, and you can move the cursor throughout the current file in many different ways as described later. You can quickly correct mistakes using the delete commands. You can copy and move text with the block commands. You can locate text strings with the Find command and optionally replace that text with new text using the Find and Replace command. Each command for the editor is described in detail in the following sections, and a brief summary of commands is shown below. Note: the ^ character indicates a Ctrl-key combination. To execute a Ctrl-key function, hold the Ctrl key and press the letter shown. CURSOR MOVEMENT EDITING COMMANDS ------------------- -------------------------------------------- Word left ^F Find Options Word right ^G Find F5 or ^Q F ------------------ Line up Up Find/replace F6 or ^Q A B=Backwards search Line down Down Find next ^L G=Global search Page up PgUp L=Limit to block Page down PgDn Insert line F7 N=Replace w/o ask Top screen Home Delete line F8 or ^Y U=Ignore case End screen End Delete word ^T W=Whole words only Top of file ^Home End of file ^End BLOCK COMMANDS Left line ^left -------------------------------------------- Right line ^right Begin ^K B Copy ^K C Read ^K R Top block ^Q B End ^K K Move ^K V Write ^K W End block ^Q K Delete ^K Y Print ^K P OPTIONS MISCELLANEOUS COMMANDS -------------------- ------------------------------------------ Toggle indent ^O I Help screen F1 Save/resume F2 Toggle tabs ^O T Directory F3 Abandon F9 or ^K Q New File F4 Save/quit F10 or ^K D - 4 - THE EDITING SCREEN When you start the Point & Shoot Editor, the main program screen will appear. The top line of the screen displays the name and version of the program and a copyright notice. The center portion of the screen is the text editing area, and the bottom section of the screen displays the quick function key commands. The top line of the text editing window shows the editor status line. The status line provides the following information: o Command Echo: When the first key of a Ctrl-key command is pressed, the keystroke is echoed at the left edge of the status line. o Line n: Shows the number of the line containing the cursor. o Col n: Shows the column number containing the cursor. o Insert: Indicates that Insert mode is in effect. o Indent: Indicates that Autoindent mode is in effect. ^Q I toggles the autoindent mode on and off. o Tab: Indicates that fixed tabs are in effect. ^O T toggles fixed tabs on and off. o X:FILENAME.EXT: The drive, name, and extension of the file begin edited. If the current file has not been named, only the current drive letter will be shown. Also, even though you can specify a complete path specification for file editing, the path will not be shown on the status line. OPTIONS Toggle insert mode (Ins) Selects Insert or Overwrite mode. In Insert mode, text to the right of the cursor is moved to the right as new text is entered. In Overwrite mode, any text at the cursor position is overwritten when the new text is entered. Toggle autoindent (^O I) When Autoindent mode is in effect, pressing Enter will move the cursor to the next line and to the same column as the first character of the previous line. Toggle fixed tabs (^O T) With fixed tabs, tab stops start at column 1 and occur every 8 columns thereafter. With smart tabs, tab stops are set at the first character of each word on the previous line. - 5 - CURSOR MOVEMENT The simplest commands in the Point & Shoot Editor are the cursor movement commands. Following is a description of these commands. Character left (Left arrow) Moves the cursor one character to the left. Character right (Right arrow) Moves the cursor one character to the right. Word left (^F) Moves the cursor to the beginning of the word to the left. Word right (^G) Moves the cursor to the beginning of the word to the right. Line up (Up arrow) Moves the cursor up one line. If the cursor is at the top line of the screen, the window scrolls down one line. Line down (Down arrow) Moves the cursor down one line. If the cursor is at the bottom line of the screen, the window scrolls up one line. Page up (PgUp) Moves the cursor up one screen. Page down (PgDn) Moves the cursor down one screen. Top of screen (Home) Moves the cursor to the top of the screen. End of screen (End) Moves the cursor to the bottom of the screen. Top of file (^Home) Moves the cursor to the beginning of the file. End of file (^End) Moves the cursor to the end of the file. Left on line (^Left arrow) Moves the cursor to column 1 of the current line. Right on line (^Right arrow) Moves the cursor to the end of the current line. Top of block (^Q B) Moves the cursor to the block-begin marker set with ^K B. End of block (^Q K) Moves the cursor to the block-end marker set with ^K K. - 6 - EDITING COMMANDS The editing commands allow you to insert and delete characters, words, and lines. A related command (Delete block) is discussed later in the Block Commands section. New line (Enter) In Insert mode, this command inserts a line break at the current cursor position. If Autoindent mode is on, the cursor moves to the new line and to the same column as the first character of the previous line, otherwise the cursor moves to column 1 of the new line. In Overwrite mode (Insert off), the cursor will move to column 1 of the next line without creating a new line. Insert Line (F7) Inserts a new line at the current cursor position. Tab (Tab) Moves the cursor to the next tab stop. In Insert mode, any text to the right of the cursor is moved along with it. If Insert mode is off, only the cursor will be moved. The location of the next tab stop depends on whether fixed tabs or smart tabs are in effect as discussed previously. Delete current character (Del) Deletes the character at the current cursor position and moves any characters to the right of the cursor one position to the left. Delete left character (Backspace) Deletes the character to the left of the cursor and moves the cursor to the left one position. Any characters to the right of the cursor are moved to the left one position. If the cursor is at column 1, the cursor is moved to the end of the previous line and the current and previous lines are joined together. Delete word (^T) Deletes the word to the right of the cursor. Delete line (F8 or ^Y) Deletes the current line and moves any lines below it up one line. The cursor moves to column 1 of the next line. - 7 - SEARCH COMMANDS The search commands allows you to find and replace text strings. Find (F5 or ^Q F) Lets you search for a string of up to 30 characters. When you select this command, you will be asked for a search string. The last search string entered (if any) will be displayed. You can select it again by pressing ENTER, edit it, or enter a new search string. To edit the search string, BACKSPACE deletes the previous character, ^R restores the previous string, and ^U or ESC cancels the command. After the search string is entered, you will be prompted for search options. Any previously entered options will be shown. Again, these may be edited or accepted. The following options are available for the Find command: B Searches backwards from the current cursor position toward the beginning of the file. L Limits the search to the current block. n Find the nth occurrence of the search string. U Ignore the case of the target string. W Searches for whole words only Find and Replace (F6 or ^Q F) This command works the same as the Find command, except you can replace the "found" string with any other string up to 30 characters in length. After entering the search string, you will be asked for a replacement string. The last used replacement string will be shown, and you can edit or accept it. Like the Find command, you can enter options for the Find and Replace command. The options available are the same as the Find command except for the following additions: G Searches globally through the entire file for the search string. N Replaces any matches without confirmation. Find next (^L) Repeats the last Find or Find and Replace command. - 8 - BLOCK COMMANDS A block of text is any contiguous unit of text that you define. A block can be as small as a single character or as large as the entire file that you are editing. A block is defined (marked) by placing a begin-block marker at the first character in the desired block and an end-block marker just beyond the last character in the desired block. Once you have marked a block, that block may be copied, moved, deleted, written to a file, or printed. When you mark a block, the marked text will appear in a different color that the rest of the text. A defined block will remain in effect unless the Block Delete command is issued or you define a new block. Begin block (^K B) Marks the beginning of a block. The marker itself is not visible, and the block itself will not be marked until the End block command is given. End block (^K K) Marks the end of a block. Like the begin-block marker, the end block marker is not visible and the block itself will not be displayed unless both markers are set. Copy block (^K C) Creates a copy of a marked block of text at the current cursor position. The original block is left unchanged and the block-begin and block-end markers are placed around the new copy of the block. Move block (^K V) Moves a marked block of text from it's current position to the current cursor position. The block markers remain around the block at it's new position. Delete block (^K Y) Deletes a marked block of text. After using this command, there will be no marked block of text. Read block (^K R) Reads a file into the editor at the current cursor position. The file is read in marked as a block. When you use this command, you are prompted for the name of the file to read. If you have used this command earlier, the last file name entered is displayed. You may enter a new file name (even a different disk or subdirectory), make changes to the file name currently displayed using BACKSPACE, or accept it by pressing ENTER. You may cancel the command by pressing ^U. - 9 - Write block (^K W) Writes the currently defined block to a file and the block remains unchanged. You are prompted for a filename, just like the Read block command. If the file already exists, you will be asked whether you want to overwrite it. If you press N (for No), you can enter a new file name, make changes to the current name using the BACKSPACE key, or cancel the command using the ^U command. If no block has been defined, the Write block command is ignored. Print block (^K P) Prints the currently marked block on the printer. If no block is marked, the entire file is printed. MISCELLANEOUS COMMANDS Help (F1) A screen showing the editor commands is shown. Pressing any key returns to editing mode. Save (F2) Saves the current file (if it is named) and resumes editing. Directory (F3) Displays the files that match the current search string. You will be prompted for a search string. You may enter a complete pathname specification or use the standard DOS file filters. ^R restores the previous search string, and BACKSPACE allows editing. ESC aborts the command. New file (F4) Loads a new file into the editor. If the current file has been modified, you will be asked whether you wish to save the file before a new one is loaded. After confirmation of the save, you will be prompted for a new file name. You may enter a complete pathname specification for the file. ^R restores the previous file name, and BACKSPACE allows editing. ESC aborts the command. If the specified file cannot be found, the current file will be left in the editor. Abandon (F9) The current file is abandoned (after confirmation if changes have been made) and the program is terminated. Save/done (F10) The current file is saved and the program is terminated. - 10 - REGISTRATION FORM ----------------- PROGRAM: Point & Shoot Editor VERSION: 1.0 Applied Micro Systems Technology P.O. Box 1596, Welch Ave. Station Ames, Iowa 50010 Name __________________________________________________ Company __________________________________________________ Address __________________________________________________ __________________________________________________ __________________________________________________ Phone ( ) _______________________ Payment $_______ ($15 for full registration, no cash) OR No payment enclosed, I already registered __________________ Where did you hear about the Point & Shoot Editor? ____________________________________________________________ Comments __________________________________________________ __________________________________________________ __________________________________________________ __________________________________________________ __________________________________________________ __________________________________________________ - 11 -