Programmer 7500

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

/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / ONEACH.ZIP / EDITOR.MAN < prev next >

Wrap

Text File | 1987-07-07 | 35.4 KB | 928 lines

'ONE-EACH EDITORS' Version 1.03 Users Guide Written and compiled in TURBO PROLOG* v1.1 (c) Copyright 1987 Brad Perkins All Rights Reserved *TURBO PROLOG is a trademark of Borland International ***** CONTENTS ***** INTRODUCTION ....................................................... 1 REQUIREMENTS ....................................................... 1 LIMITATIONS ....................................................... 1 GETTING STARTED .................................................... 2 Printing this users guide ..................................... 2 Hard Disk Systems ............................................. 2 Floppy Systems ................................................ 2 Starting One-Each ............................................. 2 THE MENU SYSTEM .................................................... 3 Edit .......................................................... 3 THE PRINT MENU ................................................ 3 Print Editor ............................................... 3 External File .............................................. 3 Headers .................................................... 3 Doublestrike ............................................... 3 Margin Indent .............................................. 3 THE FILES MENU ................................................ 4 Load text .................................................. 4 Saving Text ............................................. 4 Delete File ................................................ 4 File Directory ............................................. 4 Rename ..................................................... 4 Operating System ........................................... 4 Zap Editor ................................................. 4 View File .................................................. 4 Wild Card .................................................. 4 THE SETUP MENU ................................................ 5 Directories (path) ......................................... 5 Printer Port ............................................... 5 Save Setup ................................................. 5 QUIT .......................................................... 5 USING ONE-EACH ..................................................... 6 THE ONE-EACH EDITOR ................................................ 6 THE EDITOR FUNCTION KEYS ...................................... 6 F1 Help .................................................... 6 F2 Goto Line ............................................... 7 F3 Search .................................................. 7 F4 Substitute .............................................. 7 Block Functions(F5-F7) ..................................... 8 F8 External Edit ........................................... 8 F9 External Copy ........................................... 8 F10 End .................................................... 8 Escape Abort ............................................... 8 WORDSTAR COMPATIBLE COMMANDS ....................................... 9 THE SHAREWARE CONCEPT ............................................. 10 DISCLAIMER ........................................................ 10 REGISTRATION FORM ................................................. 11 DEALER REGISTRATION ............................................... 12 CUSTOMIZE FORM PAGE 1. ............................................ 13 COMMENT FORM ...................................................... 14 INTRODUCTION 'ONE-EACH EDITORS' Is a virtual screen editor for use by anyone who wishes to create or modify existing text files. It's not a word- processor but it can be used for simple letters and notes. One-Each is especially useful to programmers because of the features included specifically for programmers. Some of these features are as follows: 1: An auxillary editor window from which you may edit or copy from an external file. This is actually part of Turbo Prolog's built in editor. 2: Several file handling utilities. a. Delete file b. Rename file c. Display directory d. Change logged drive and directory e. Jump to DOS (and return) f. View file g. Copy file 3: Printer support: a. Print editor b. Print external file c. Select printer port d. Page header on/off 4: User interface: a. Pull down, pop up menus and windows b. Editor status line c. Menu and editor command line d. Instant help windows from the editor 5: Last file autoload: One-Each will automatically load the last file saved from the previous session. ***** REQUIREMENTS ***** HARDWARE: IBM pc, xt, at or compatible with 256K ram memory, and one floppy disk drive. Epson or equivalent printer. 'ONE-EACH should work with any ascii printer. SOFTWARE: COMMAND.COM must reside in the same directory with One-Each in order for the DOS shell (Operating System) feature to work. The setup files should also be in the same directory. ***** LIMITATIONS ***** As of this writing One-Each can handle ascii files no larger than 64K. This is due to limits imposed by Turbo Prolog on its string handling predicates. Page 1. ***** GETTING STARTED ***** ************************************************************** * << IMPORTANT >> * * * * Make a backup copy of 'ONE-EACH' and store the original in * * a safe place. * ************************************************************** PRINTING THIS USERS GUIDE: Go to the "Setup" menu and select the correct printer port, then select "External file" from the "Print" menu. Type in "EDITOR.MAN" at the prompt, ready your printer and press return. HARD DISK SYSTEM: Create a directory called ONE-EACH (or whatever you wish). Copy all of the files into the directory. Copy "COMMAND.COM" from your DOS directory or DOS diskette into the One-Each directory. SINGE OR DOUBLE FLOPPY SYSTEMS: The following files are not necessary for the operation of One-Each on a color system: MED.EXE MONO.SYS EDITOR.MAN READ.ME MAKE.EXE The following files are not necessary for the operation of One-Each on a mono (black and white or singe color) system: ED.EXE EDITOR.SYS EDITOR.MAN READ.ME MAKE.EXE You may remove these files from your "WORKING COPY" after you have made a backup of the original diskette. STARTING 'ONE-EACH': If you have a color system type "ED" to start One-Each. If you have a monochrome monitor type in "MED" to start One-Each. One-Each immediatly loads "editor.sys" ("mono.sys" for monochrome systems) and then "editor.dba". "Editor.sys" contains information on the 'help' window and command line color attributes and is not necessary in order for One-Each to function. "Editor.dba" on the other hand must be present otherwise One-Each will not run. Page 2. ***** THE MENU SYSTEM ***** One-Each contains a top line, pulldown and pop-up menu system. These menu functions are arranged in a convienient, "use" priority order. This may change in future versions depending on user feedback. EDIT: Takes you directly to the edit window and calls the edit status and command lines. The status line indicates if auto indent and the insert key is on or off. It also tracks the cursor position. The command line indicates the Function key actions. LEAVING THE EDITOR: Pressing the escape key while in the editor aborts ANY changes you have made in the editor and places the cursor in the top line menu. Pressing the F10 key exits the editor and saves any text changes into the file. You are given the option of saving the file under a different name. Pressing the escape key at the filename prompt aborts the editor and places the cursor in the top line menu. ***** THE PRINT MENU ***** Pressing return at the "Print" option of the top line menu will "Pull down" a sub-menu of print options. We will cover all of these options in this section. The print driver should work with any ascii printer. One-Each relies mostly on you already having your printer correctly configured for your DOS system. The skip perforation is "hard wired" for 11" page length. NOTE: Before attempting to print the editor or an external file make certain you have selected the correct printer port from the "Setup" menu. PRINT EDITOR: Outputs the current file text to the user selected printer port. EXTERNAL FILE: Allows the user to select an external file to be output to the printer. If you press return at the first prompt you will get a directory from which you can make a file selection. This will not Affect any text that may be in the editor. HEADERS: Toggles page headers on and off. The status is indicated in the bottom command line. When headers are on, a line of text will be printed at the top of each page. The header line contains the days' date, time, the file name, and the page number in the right margin. The default is off. DOUBLESTRIKE: Toggles doublestrike mode on and off. The status is indicated in the bottom command line. This will give darker print but also doubles print time. The default is off. MARGIN INDENT: Moves the text to the right on the page during printing. Page 3. ***** THE FILES MENU ***** LOAD TEXT: Loads a text file into the editor window. A window pops up with "File name (EXT)______". Hitting the return key at this point calls a directory containing files with the .EXT extension. You may select a file with the cursor keys and press return at the highlighted file. SAVING TEXT: Pressing F10 from the editor overwrites the original file with the contents of the editor. The original file is saved in a file with the same name and a ".BAK" extension. DELETE: Calls a directory and allows the user to highlight a file for deletion. Use this with caution. There are no "ARE YOU SURE" prompts. It simply deletes the file. FILE DIRECTORY: Calls the file directory. RENAME: Calls a directory and allows the user to select a file for renameing. OPERATING SYSTEM: Jumps to the DOS system. Typing "exit" returns to One-Each. The DOS file 'COMMAND.COM' must reside in the same directory with One-Each. ZAP EDITOR: Clears any text that may be in the editor and refreshes the top line menu. There are no "ARE YOU SURE" prompts. It is immediate and permanent. VIEW FILE: Allows user to view contents of an external file. This is nondestructive to the editor contents. WILD CARD (.*): Resets the file extension default to the wildcard value for the "Load File" function directory. COPY FILE: Allows the user to copy a file from one drive/directory to another. First set the current directory from the setup menu to the drive/directory you wish to copy from. Type in the file name or select from the directory list. You will then be prompted for the drive/directory to copy to. Another prompt will appear with the file name. At this point you have the option of changing the name or pressing return to keep the original name. Only text files may be copied with this function. Page 4. ***** SETUP MENU ***** The setup file "Editor.dba" contains a database that One-Each uses in its initial start up. This database also keeps a copy of the last file name "saved". The next time you run One-each, it will automatically load the editor with the last file you worked on. DIRECTORIES: Allows user to change logged drive or directory. PRINTER PORT: You may select from the centronics parallel (prn), serial 1 (com1) or serial 2 (com2) printer ports. Select the port your printer is connected to and then select the "Save Setup" menu item. The next time One-Each is loaded your printer will be the default. SAVING THE SETUP FILE: Quiting One-Each automatically saves the new con- figuration file. ***** THE QUIT MENU ***** QUIT: Saves the setup file and exits One-Each. Page 5. ***** USING 'ONE-EACH' ***** This section may be used as a short "Do as you read" tutorial. I recommend you load One-Each into your computor, load this manual into One-Each, read the manual right off the screen and do the actions as you go. In this way you can become very familiar with One-Each in a matter of minutes. ***** THE 'ONE-EACH' EDITOR ***** THE EDITOR FUNCTION KEYS: Placing the cursor at "edit" and pressing return (enter) or pressing the 'e' key places the cursor into the editor window. The editor status line at the top of the editor window will appear and the command line at the very bottom of the screen will change. The command line now indicates that the function keys are active and a short description of what each F-key does. The funcion keys operate by pressing the desired F-key, typing in the requested information, or in the case of block functions, moving the cursor around to mark the appropriate text. To execute the action press the F-key again (THE RETURN OR ENTER KEY DOES NOT WORK). REPEATING FUNCTIONS: Multiple function key operations may be repeated by pressing shift key/F-key combination. For example, after copying a block of text (F5), moving the cursor to a different location, pressing shift-F5 will copy the text block again to the new location. F1 HELP: Pressing the F1 key (help) causes a little window to pop up labeled "Main Menu" with a list of editor subjects. Pressing return at the first menu item "help information" brings the help file from the disk drive and places it in another window. Notice also that the command line at the bottom of screen has changed to reflect functions for the help window. You can use the cursor arrow keys to scroll through the help window text. The F2 & F3 keys function the same as in the editor window. Pressing Ctrl(control)-F10 zooms the window to full screen size. It should be noted here that this also works in the editor window. The shift-F10 combination brings up another command line with instuctions on moving and resizing the help window. This function does not work in the editor window. Press Esc(escape) or F10 to exit the help window. If you are at the main help menu you must press Esc to exit. Now would be a good time to bring up the main help menu and explore the rest of the help functions. The sub-menus will actually execute the assigned function for you. The escape key will always abort these functions if you change your mind. Page 6. F2 GOTO LINE: While in the editor the status line at the top of the editor window keeps track of cursor position by line and column number. If you move the cursor up the screen you will see the line number decrease. Moving the cursor to the right increases col position. Line 1 - column 1 does not necessarily begin at the first line of text. It does begin at the very first line and column of the editor. Pressing F2 allows you jump to any line number as long as it is within the Text boundaries. In other words if you have a short file that ends on editor line number 42 you cannot jump to line 600. User action: press F2 key Editor response: F2: goto line:_ User action: type in '25' (or any line number) User action: press F2 key Editor response: places cursor at line 25 F3 SEARCH: This function allows the user to search for the first occurrence of a text string. The string may be a single character, word, or string of words. The search begins at the current position of the cursor and works forward. Any occurrences of the search string behind the cursor will not be found. User action: press F3 key Editor response: F3: Search text, text:_ User action: Type in string you wish to find User action: Press F3 key Editor response: Moves cursor to first matching string User action: Press Shift-F3 combination Editor response: Moves cursor to next matching string F4 SUBSTITUTE: Allows you to replace any or all occurrences of a string with another string. This function first asks for the string that you wish to replace and then asks for the new string value. You have the choice of local (visable screen area) or global replacement. Global begins at the current cursor position and works down to the end of the text. If you wish to replace every occurrence of a string it's a good idea to move the cursor to the very top (beginning) of the text. You are then asked if you wish a prompt at each string to be replaced. If not One-Each will replace every occurance of the string without stopping. User action: Press F4 key Editor response: F4: Replace Text, Old Text:_ User action: Type in text you wish to replace User action: Press F4 key Editor response: F4: Replace Text, Old Text:<Text> New Text:_ User action: Type in replacement text User action: Press F4 key Editor response: F4: Global/Local replace (g/l): User action: Type in 'g' for global or 'l' for local User action: Press F4 key Page 7. ******BLOCK FUNCTIONS ***** BLOCK FUNCTIONS: One-Each includes the three common block functions. Block copy, Block move and Block delete. You may mark "Blocks" or portions of text for copying, moving or deletion. You simply place the cursor at the beginning of the text you wish to move, copy or delete, and press the corresponding F-key. You then move the cursor across the line or down the screen to mark whole lines or paragraphs of text. The text attribute changes as you move and mark the blocks. When you finish marking your text then press the appropriate function key again. In the case of Block Move and Block Copy you move the cursor to the position you wish the text to be moved or copied to then press the function key once more and you are done. For Block Delete you press F7, mark the text press F7 again and the text is gone. OOPS, OH-NO, & AH-@#$%^&!: Some pointers on errors are in order. Always save your work frequently. I save mine at about every page I type in. I also save right before taking a break. This way I always have a file that is nearly up to date when : a: The electricity goes out b: I just accidently deleted 43 pages of text c: I take a break and the cat takes a nap on the keyboard. Another thing to do when you scramble the contents of the editor is to press the escape key to abort any changes you have made in the session. F8:EXTEDIT: Calls the external file editor. Pressing F8 causes another editor window to be created so you can edit another file this auxillary editor works just like the main editor. The small edit window may be zoomed to full size by pressing the Ctrl F10 combination. F9:EXTCOPY: Works just like F6 except it allows you to mark and copy text into the main editor from an external file. F10:END Pressing F10 saves the editor contents to the current drive and directory, exits the editor and places the cursor into the top line menu system. ESC:ABORT (From the editor) Aborts and exits the editor and "undoes" any changes you have made in the CURRENT edit session. Page 8. ***** WORDSTAR COMPATIBLE COMMANDS ***** ============================ WORDSTAR PC CURSOR MOVEMENTS: COMMAND KEY Character left Ctrl-S Character right Ctrl-D Word left Ctrl-A Ctrl - Word right Ctrl-F Ctrl - Line up Ctrl-E Line down Ctrl-X Page up Ctrl-R PgUp Page down Ctrl-C PgDn To left on line Ctrl-Q-S Home To right on line Ctrl-Q-D End To top of page Ctrl-Q-R Ctrl - Home To bottom of page Ctrl-Q-X Ctrl - End To top of file Ctrl-Q-R Ctrl - PgUp To end of file Ctrl-Q-C Ctrl - PgDn To beginning of block Ctrl-Q-B To end of block Ctrl-Q-K To last cursor position Ctrl-Q-P INSERT & DELETE COMMAND KEY Insert mode on/off Ctrl-V Ins Insert line Ctrl-N Delete line Ctrl-Y Delete to end of line Ctrl-Q-Y Delete right word Ctrl-T Delete char under cursor Ctrl-G Del Delete left character Ctrl-H BLOCK COMMANDS COMMAND KEY Mark block begin Ctrl-K-B F7 Mark block end Ctrl-K-K F8 Hide/display block Ctrl-K-H Copy block Ctrl-K-C Move block Ctrl-K-V Delete block Ctrl-K-Y Read block from disk Ctrl-K-R Write block to disk Ctrl-K-W Print block Ctrl-K-P MISC. COMMANDS COMMAND KEY Tab Ctrl-I Repeat last find/replace Ctrl-L Find Ctrl-Q-F Find & replace Ctrl-Q-A Auto tab on/off Ctrl-Q-I Page 9. ***** THE SHAREWARE CONCEPT ***** Shareware is a means of distributing a software product. the product is passed around and shared by individuals, BBS's, users groups and so on. The concept places much trust in you, to be honest and pay for the product once you have tried it and decided to keep it. There are many shareware products that exceed comparable commercial packages in both quality and usefulness. One of the greatest benifits is the difference in cost. This difference is in the hundreds of dollars in savings to you, depending on the product. But why does the commercial product cost so much? The resources required in development time, research and dedication are no less for the shareware product. The most popular answer is that the large software companies must spend billions in marketing, distribution and advertising. I do not agree that this is the primary reason for inflated software prices. In recent years software piracy has stripped these companies of much more than advertising costs. In other words when you see someone illegally copy a software product you must pay for his copy the next time you purchase a program. Other shareware authors and myself are offering quality products at extremely reasonable prices. If our efforts are not rewarded with your support, then all of us will have lost. We will stop producing and you will have to purchase your software from the large companies. I believe most of you have high personal integrety. If I did not believe that, I would not have produced One-Each for you. If you purchase this product I will reward you with the next enhancement to One- Each. You will also recieve a lot of admiration from me. 'ONE-EACH' is a shareware product. It is not free. The registration fee is not optional. It is required beyond a reasonable "test" period not to exceed 30 days. If after that period you feel that this product does not meet your needs then please pass it on to someone else so that they may try it. ******************************************************************** DISCLAIMER ******************************************************************** 'ONE-EACH' and its associated files and documentation are distributed without any expressed or implied warranty of any kind. The author, supplier or distributor shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, peformance, use or misuse of these materials. Page 10. ******************************************************************** REGISTRATION FORM ******************************************************************** Your name:___________________________________________________ Street address:______________________________________ City, state, Zip:______________________________________ Your company name:___________________________________________ Street address:______________________________________ City, state, Zip:______________________________________ ******* Quantity and dealer discounts available ******* See Dealer Registration Form (_) Enclosed is my check/money order for the minimum registration fee of $20.00. This entitles me to use 'ONE-EACH' on one (1) computor at any given time. I will also recieve the next enhancement to 'ONE-EACH'. California residents add 6% sales tax. (_) I wish to purchase the source code to 'ONE-EACH' to modify for my own personal use. I understand I'm not to sell or distribute the source code or any modified versions of 'ONE- EACH'. Enclosed is $75.00 in check or money order. PLEASE MAKE CHECKS PAYABLE TO : Brad Perkins 250 touchstone Pl. #80 West Sacramento, CA 95691 Page 11. ********************************************************************** DEALERS, DISTRIBUTORS, CORPS AND COMPANYS ********************************************************************** If you wish to be a distributor of 'ONE-EACH' please fill out the following registration. Distributors are required to pay the initial registration fee of $20.00 and then only $15.00 Per copy thereafter. Every sixth copy therafter is free to the dealer distributor. It's the dealers responsibility to make certain that the customer gets registered for tech support reasons. Please send the original registation (with the payment) and make certain that the customer knows how to contact me for support. Companies, schools, government agencies may be their own dealers and follow the same guidelines as stated above. For A $50.00 one time fee (This includes the initial registration fee!!) you may also have your distribution copy customized with your company name and phone number or whatever across the top of the editor window where the 'ONE-EACH' logo normally resides. You may then distribute as many of these copies as you wish using the dealer/distributor guidelines above. It's a business card your customer is not likely to throw away. Individual users are also invited to have their copy customized. See the customize form. (_) Yes I wish to be a dealer/distributor of One-Each. Enclosed is $20.00 check or money order. (_) Yes I wish to be a dealer/distributor of One-Each. Enclosed is $50.00 check or money order and the customize form. Please mail my custom copy to the address below. Name/Company:_______________________________________________________ Street Address:_____________________________________________________ City/state/zip:_____________________________________________________ Mail Payment To: Brad Perkins 250 Touchstone Pl. #80 West Sacramento, Ca. 95691 <<NOTE>> Money orders ensure immediate turnaround. Personal checks must await bank clearance. Page 12. ********************************************************************** CUSTOMIZE FORM ********************************************************************** You may have the One Each editor window (the largest window directly below the menu window) Title changed to your Company name, slogan or whatever. Exceptions are the following: 1. Profanity 2. Comments, statements or Jokes that could be construed as derogatory to any particular race, class or religious group. 3. Any other comment, statment or slogan that the author feels is degraded or lacking in good Taste. Your text is limited to 72 characters (including spaces), and limited to standard IBM ascii characters that can be TYPED from the keyboard. All text will be centered on the screen unless you specify otherwise. Please type your text exactly as you wish it to appear on the screen if possible, otherwise print very clearly. Make it clear which characters are upper and lower case. Make certain your monitor supports all of the characters you have selected. Please fill out the following text field or make some copies in case of errors. 1 2 3 4 5 6 7 123456789012345678901234567890123456789012345678901234567890123456789012 (________________________________________________________________________) You will be sent both a color and monochrome version. Customizing beyond what is on this form may cost more or may not be feasable at all. For further customizing please write your requests addressed to me with a phone number, name and time I may contact you. Page 13. ******************************************************************** USER COMMENT FORM ******************************************************************** << THIS FORM MUST BE FILLED OUT WITHIN 30 DAYS OF REGISTERING >> Please make any comments/suggestions not covered on this form on the back or on another piece of paper. User name:(not required)__________________________________________ Address _________________________________________________________ _________________________________________________________ _________________________________________________________ Date:_________________ ------------------------------------------------------------------- How often do you use One Each? ------------------------------------------------------------------- What do you like about it? ------------------------------------------------------------------- What do you dislike about it? ------------------------------------------------------------------- How would you like it changed? (added, deleted, rearranged...). ------------------------------------------------------------------- Which features are missing? ------------------------------------------------------------------- Which features are useless? ------------------------------------------------------------------- Is the documentation adequate? ------------------------------------------------------------------- SEND TO: Brad Perkins 250 Touchstone Pl. #80 West Sacramento, Ca 95691 Page 14.