Hall of Fame

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

/ Hall of Fame / HallofFameCDROM.cdr / wp3 / jedit.lzh / JEDIT.DOC < prev

Wrap

Text File | 1986-09-15 | 20.7 KB | 595 lines

@ EJEditF EThe ultimate editorF Eversion 1.00F Eby John BernsteinF ECopyright 1986F Jedit is a Shareware product. We encourage you to copy and share this program and its documentation, unmodified with others. If you find that you use the program, please support the Shareware marketing concept by registering with us. Thank you EIntroductionF Ever tried to edit BAT files with EDLIN? Ever used a program requiring data input but didn't have editing capabilities? Ever do any programming? If you answered yes to any of these questions, you will love JEdit. JEdit is a full screen editor for use with any Ascii text file. JEdit allows you to edit files as big as your memory (minus about 60k for JEdits use), you can have lines as long as you want (no more 254 column limit). JEdit includes all the most commonly used editing features found in editors costing hundreds more, such as block movement and deleting, windowing, and a slew of other features. EHow to get started--Setting up JEditF Generally, JEdit will be located in it's own directory, but this isn't necessary. When you pick a home for JEdit, make sure that these two files are in the directory: EJEDIT.COMF the program EEDITERR.MSG Fthe error message file It is possible to use JEdit without the error message file, but if JEdit runs into any problems, you won't be able to figure out what exactly that problem is. Once JEdit is in its new home, all that is left to do is to run JEdit. You can start JEdit two ways: EJEDIT <filename>F EJEDITF The first example tells JEdit to load itself and also load the file <filename> and get it ready to be edited. The second example just loads JEdit and gets ready to edit a new file. EThe JEdit screenF When JEdit is finished loading, the JEdit screen will be displayed. This is where you will do your editing. The top line displays the name of the file you are currently editing and also what will happen when you press the Esc key. The bottom of the screen contains some more useful information. On the left side is the indicator box. This will tell you if you are in insert mode (indicated by Ins), if you are in word wrap mode (indicated by Wrap) or if you are in smart tab mode (indicated by Tab). In the middle of the bottom line is the cursor position indicator. These numbers tell you exactly where the cursor is located within the file. These can be used for lining up tables, figuring out centering....or you could just ignore them! EEditing with JEdit--Cursor MovementF Cursor movement in JEdit is just like in any other program. The arrow keys move in the appropriate direction. PgUp and PgDn move a page up or down in the file. Home and End move the cursor to the beginning and end of the current line. If you hold down the Ctrl key while pressing the forward or backward arrow key, the cursor skips a word at a time in the appropriate direction. Ctrl plus the PgUp or PgDn jumps to the beginning or the end of the current file. EEditing with JEdit--Block CommandsF JEdit allows you to perform functions on large areas of text called blocks. When a block of text is selected it can be deleted, moved, or copied. To select a block, move the cursor onto the line where you want the block to start and press F3. Next move the cursor to the last line of the block you want to mark and press F4. The block is now highlighted telling you that you can now perform any of the block commands. Pressing Shift-F2 deletes the highlighted block. EWARNING:F as of this time there is now way to recover a deleted block. If you want to make a duplicate (a copy) of the block in another place, simply move the cursor to where you want the block and then press F5. The block is now copied to the new location, but also leaving the original block where it was. Instead of making a second copy of a block of text, you can move the text to a new location. A move is a copy and a delete in one. First JEdit copies your block to the new location and then deletes it from its original location. This is handy for re-organizing programs. After working with a block, you should turn it off (un-highlight it). To do this press Shift F5. Now when you press any of the block function keys nothing will happen. You can turn the block on again by pressing Shift F5. EExiting and SavingF When you are finished editing a file, it is usually a good idea to say that file. This is accomplished by pressing Ctrl S. JEdit now prompts you for the name of the file to save to. If you started JEdit with a file name on the command line, this file name is given to you as a default. If you wish to save your file to this file name, just press return. If you want to change the file name, use the arrow keys to backup and re-type any file/path information. If a file already exists with the name you are saving to, JEdit makes a copy of that file, but changes the extension to BAK. This prevents any accidental data loss. After editing a file, one usually wants to return to DOS. Just press the ESC key and you will be back in DOS. If JEdit senses that you changed something in your file and didn't save it, JEdit will warn you and ask if you really wish to quit. This also prevents any accidental data loss. EDeleting textF Ever wanted to delete some text from a file? You could always use the block command to delete a big section. But if you want to "zap" only a few lines you could use the delete-a-line command. Just press F2 to delete a line. EWARNING:F as of this time there is now way to recover a deleted line. If a character is all you want to delete, the Del key will delete the character under the cursor and then move all text to the right of that space one notch to the left. ETabsF JEdit treats tabs in two ways; regular tabs and smart tabs. You can switch between the modes by pressing Shift Tab. In smart tab mode (indicated by TAB in the indicator box), JEdit remembers where you had last tabbed to and each new line automatically tabs to that spot. This is useful when programming in structured languages, such as Pascal, which require a large amount of indentation. In stupid tab mode (indicated by the absence of TAB in the indicator box) no automatic tabbing is performed; each new line it placed at the far left side. In either tab mode, the Tab key moves the cursor a set number of spaces to the right. ETwo more modesF Besides the Smart tab mode, there are two others: word wrap and insert mode. With word wrap turned on, by pressing F1, every word which goes beyond the 80th column is carried or wrapped over to the next line. This comes in handy when editing letters or memos. Insert mode is turned on with the Ins key. In insert mode everything you type pushes previously type text to the right on the line. When not in insert mode previously written text is just written over. EIn case of emergency!F If JEdit ever appears to be thinking too long (which it can't do) or takes an extra long lunch--in other words, appears to hang-- press Ctrl U until JEdit comes back to life. Ctrl U is the "abort and return control" command. You can use this anywhere to stop a function JEdit is performing. If after repeated presses if Ctrl U nothing happens, you're out of luck...just reboot. On the brighter side, I have never had JEdit lock up on me. ECommand summaryF Command Function ---------------------------------------- F1 Toggle word wrap F2 Delete a line F3 Mark beginning of a block F4 Mark end of a block F5 Copy a block F6 Move a block Shift F2 Delete a block Shift F5 Hide a block Ctrl S Save file to disk Ctrl U Abort current function Home Move to beginning of line End Move to end of line PgUp Move up a screen page PgDn Move down a screen page Ins Toggle insert mode Del Delete character under the cursor Ctrl arrow key Move forward or backwards a line Shift Tab Toggle smart tab mode ETechnical informationF JEdit was written using Borland International's Turbo Pascal version 3.01a and Borland's Turbo Editor Toolbox. JEdit was written by John Bernstein to aid the development of other programs (and anything else requiring editing). JEdit consists of over 120k of source code, all of which is Pascal and finely tuned inline machine code. JEdit can edit files up to the amount of memory you have--a maximum of 640k (JEdit cannot currently use extended memory). JEdit was written with the hard drive in mind. Because of JEdit's size, about 60k, it loads slowly from a floppy drive. As a result of this it is suggested that JEdit be used from a hard drive; though this isn't necessary. JEdit, runs properly on both monochrome and color monitors. Because many CGA cards create "snow" when being written to, JEdit uses a technique to get around this. JEdit watches for the vertical retrace on CGA monitors and writes to them only during this time. This method slows down the operation of the monitor drastically compared to the monochrome, but prevents the annoying "snow". When using a CGA card, it is recommended to use a PC which operates faster than the standard 4.77 mHz PC. EWarranty and License agreementF This program and documentation are provided "as is", with out any warranty of any kind, either expressed or implied. If the program should function improperly you assume the entire cost of any and all damages caused by the program. Now with that out of the way... A license is granted to the user of this program to use copy and distribute this program on the following conditions: You the user may: Copy and give this program, in its original form with all documentation in original form. Use this program in commercial environments for commercial purposes providing each computer running JEdit has been registered. Site licenses are available, ask for details. You the user may not: Sell the program and/or documentation without written permission from John Bernstein. Distribute the program or documentation in any altered form, including modifications, translations, etc.. Modify the program in any way without written permission from John Bernstein. This license is effective from the time you receive JEdit and all related files. The license may be broken by the user at any time by destroying (deleting) all JEdit related files including documentation (disk or printed). EShareware SoftwareF JEdit is being distributed as a shareware program. Shareware is a method of distributing software to users. It allows users to try out new software without paying for it first. If the program is used, the user is encouraged to register with the programmer for a small price. Shareware is an effort to fight the high cost of software by providing quality software at a low price. If you use JEdit, we ask that you register by filling out the form on the next page. The basic registration fee of $10 entitles you to: Support through GEnie Notification via US Mail of new versions of JEdit One free update upon request (we provide the disk). If a $15 registration fee is received, you are entitled to: Laser printed manual Support through GEnie Notification of updates via US Mail Two free updates upon request (we provide the disk) Additional updates will be available for free if a disk is sent to me with a postage paid mailer. If an update request is made without a disk or mailer, please include $4.00 to cover the cost of the disk, label, mailer, and shipping charges. EOther products...Coming soon!F Very soon a custom menu system will be release called Pacific Menu. Pacific Menu will allow the user to set up the functions keys to perform any DOS task. For example, F1 could be defined to load the mouse driver and run Microsoft Word. When you are finished with Word, Pacific Menu is back, ready for your next command. Installation is all menu driven, and only takes about 10 minutes to get going. Pacific Menu will be marketed as shareware, for the same low price. ETrademarksF Turbo Pascal is a registered trademark of Borland International Inc. Microsoft and Microsoft Word are registered trademarks of Microsoft Corporation. GEnie is a registered trademark of General Electric. ERegistration FormF Program:EJEditF Version:E1.00F Name:_______________________________________________ Company:____________________________________________ Street:_____________________________________________ City:________________ State:______ Zip:_____________ Telephone:(____)-____-______ Product QTY. Price Total ------------------------------------------------------------ Basic registration ____ $10.00 $______ Extended registration ____ $15.00 $______ Additional Laser printer ____ $ 3.50 $______ manuals ____________________________________________________________ TOTAL $______ Please send either a check or money order to: John Bernstein 1330 Hudson Way Livermore, CA 94550 Comments: ECommand summaryF Command Function ---------------------------------------- F1 Toggle word wrap F2 Delete a line F3 Mark beginning of a block F4 Mark end of a block F5 Copy a block F6 Move a block Shift F2 Delete a block Shift F5 Hide a block Ctrl S Save file to disk Ctrl U Abort current function Home Move to beginning of line End Move to end of line PgUp Move up a screen page PgDn Move down a screen page Ins Toggle insert mode Del Delete character under the cursor Ctrl arrow key Move forward or backwards a line Shift Tab Toggle smart tab mode