ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º WELCOME TO THE VEDIT PLUS 4.1 DEMO/TUTORIAL º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ To run the demo/tutorial, you must first copy the demo files to your hard disk and de-compress them. While logged onto your hard disk, follow these steps: MD \VEDIT Alternatively, you can use the supplied MD \VEDIT\DEMO INSTALL.BAT file, where 'a' is the floppy CD \VEDIT\DEMO drive containing this disk and 'c' is COPY a:*.* your hard disk: DEMOFILE INSTALL a: c: To run the demo/tutorial, run the TUTOR.BAT file: TUTOR To print this file of additional instructions, give the DOS command: VDEMO -Z -X PRINT READ-ME.TXT Feel free to copy the demo disk! Make copies for your friends, etc. Please copy the entire disk, so that all files are intact. To Install under Microsoft Windows ---------------------------------- Although VEDIT is not a Windows graphical application, it is designed to work well in Windows and can be run from the Windows "Program Manager" via its own icon in the supplied VEDIT.ICO file. We recommend running VEDIT from within Windows using a ".PIF" file. A ".PIF" file supplies information to Windows on how to optimally run an application, e.g. how much memory to give it and how to share time slices. We supply the file VEDIT.PIF with all Windows parameters preset for good performance. When running Windows in Enhanced mode, you can directly access the clipboard to exchange data with other programs. VEDIT can be run in Windows as either a full screen DOS program or in a "window". *** To install VEDIT into Program Manager with an icon: 1. From inside Microsoft Windows, select the "Program Manager". 2. Select the Group to which you want to add the VEDIT icon. The "Main" group is a good choice. 3. Select {FILE, New}. Then select "Program Item". 4. Fill in the dialog box: For "Description" enter the program name you want to see under the icon, e.g. "VEDIT DEMO". For "Command Line" enter the full pathname to the VEDIT.PIF file. E.g. enter "c:\vedit\demo\vdemo.pif". For "Working Directory" enter the full pathname of the "VEDIT Home Directory", e.g "c:\vedit\demo". Leave "Shortcut Key" set to "None". 5. Select the "Change Icon" button. Windows will warn you that no icon is available for VEDIT. Select the "OK" button. 6. For "File name" enter the full pathname to the VEDIT.ICO file. E.g. enter "c:\vedit\demo\vedit.ico". The VEDIT icon should be displayed. Select the "OK" button. 7. You should now be back at main dialog box. The VEDIT PLUS icon should be displayed. Select the "OK" button. You should now see the VEDIT PLUS icon displayed in your current Windows group with the name "VEDIT DEMO" below it. NOTES: If you need any VEDIT invocation options, such as "-m" to force monochrome colors, you can either set the options with the "VEDIT" environment variable, or as the "Command Options" in the VEDIT.PIF file. You can also run VEDIT from within Windows after first selecting the "MSDOS" icon, but its response to the keyboard may be sluggish. To Run the Compiler Support --------------------------- Follow the steps above to copy the files to your hard disk. Run VCSD.EXE which creates the necessary additional files. VCSD You will be able to compile and link the two supplied example programs ADDER.C and EGA43.ASM; each purposely contains several obvious syntax errors for you to experiment with. The Compiler Support is initially set up for Microsoft C (5.x - 7.x), and MASM. If you prefer to use Borland's Turbo C and Turbo Assembler, run the batch file BORLAND.BAT: BORLAND Print the file COMPILE.DEM which gives detailed instructions on the Compiler Support portion of the demo. You can use VEDIT for this: VDEMO -Z -X PRINT COMPILE.DEM To start up the Compiler Support, you can use the batch file "COMPILE.BAT": COMPILE ADDER.C Alternatively, if you have installed the V-SWAP program described below, you can start up the Compiler Support while editing by selecting {MISC, Compiler support} in the menu system. The default "hot-key" for this is . Follow the instructions printed from COMPILE.DEM. VEDIT and VEDIT PLUS include modules to support these and other compilers: Microsoft: C++, C, Quick C, Quick Basic, Fortran, Cobol, MASM Assembler Borland: C++, Turbo C, Turbo Pascal, Turbo Assembler Avocet: All Compilers, Assemblers and Cross-compilers Lahey: Fortran 77, Personal Fortran 77 Metaware: High C Micro Focus: Cobol Microrim: RBase Compiler Nantucket: Clipper Compiler Realia: Cobol Watcom: C Compiler Zortech: C++ Others: 2500 AD, Acucobol, Microtec, SVS, etc. The modules to support these compilers are available on our BBS. See below. The V-SWAP Program ------------------ V-SWAP is a small TSR program with which VEDIT can completely swap itself and any desired TSRs out of memory in order to run the largest compilers and debuggers. V-SWAP is normally run from your AUTOEXEC.BAT file, but for this demo you can run it manually: VSWAP /E:1024 (If your environment is larger than 1024 bytes, increase the "/E:nnn" parameter.) Now edit the file ADDER.C: (you may need the "-M" option with B/W monitors) VDEMO ADDER.C or VDEMO -M ADDER.C To start up the Compiler Support, you now only need to press ALT-I. If desired, you can remove V-SWAP from memory after completing the demo: VSWAP /R To fully utilize V-SWAP, it should be run from within your AUTOEXEC.BAT file. Place the command "VSWAP /E:1024" before other TSRs such as desktop utilities. All TSRs following the VSWAP command will be swapped out of memory. In most cases, V-SWAP can even swap network drives out of memory. (However, the VSWAP command must follow any disk cache programs.) If you want to run VDEMO from other directories, and you have copied the files to your hard disk, add the following line to your AUTOEXEC.BAT file: SET VEDPATH=C:\VEDIT\DEMO (where "C" is your hard disk) After modifying your AUTOEXEC.BAT, you must re-boot for the changes to take effect. When VEDIT shells out to DOS (runs DOS programs), V-SWAP will swap VEDIT and other TSRs out of memory. This can give you more available memory than you had before you entered VEDIT! For a summary of all V-SWAP options, give the command: VSWAP /? Description of Files on Disk ---------------------------- VDEMO.EXE The demo version of VEDIT PLUS. It is limited to 1000 keystrokes before it exits. Alternatively, with the "-D" option, you have unlimited keystrokes, but can only save very small files. Disk sector editing only permits browsing, not modifying the disk. Configuration changes cannot be saved. VDEMO.PIF Files for installing the demo version of VEDIT PLUS under VEDIT.ICO Microsoft windows. They are described above. VSWAP.EXE A small TSR with which VEDIT can completely swap itself and any desired TSRs out of memory in order to run large compilers and debuggers. The command "VSWAP /?" displays all VSWAP options. VPHELP.HLP The on-line help file for VEDIT PLUS. You can print the this file for more information about VEDIT. WHATS.NEW A summary of enhancements made to VEDIT PLUS since version 3.70. Primarily oriented towards previous VEDIT PLUS users. HELP.BAT A very simple Help system that uses the DISPLAY.VDM macro. It displays the file HELP.TXT. PRINT.VDM Simple "macro" for printing files. It prints the filename date and page number on each page and is a nice alternative to the DOS "PRINT" command. To print the file "myfile" give the DOS command: VDEMO -Z -X PRINT myfile DISPLAY.VDM Simple macro for displaying files. Uses a window to give instructions and is a nice alternative to the DOS "TYPE" command. To display the file "myfile" give the DOS command: VDEMO -Z -X DISPLAY myfile Alternatively, you can create a batch file "D.BAT" containing "VDEMO -Z -X DISPLAY %%1". Then use the simpler command: D myfile CFUNC.VDM This macro is a C program outliner that permits viewing and navigating a C program via its subroutine declarations. It can be run from the {MISC, Load/execute macro} function. COLOR.VDM Simple macro for selecting a different color scheme. It can be run from {MISC, Load/execute macro}, COLORKEY.VDM Simple macro for changing the text color using a color chart. It can be run from {MISC, Load/execute macro}. DBASE.VDM This macro sets VEDIT "record size" and "header size" according to the currently loaded .DBF file. Also displays the table structure in an easy-to-read format with all field names, types and sizes identified. SALLBUFF.VDM This macro is automatically loaded by the {SEARCH, Search buffers macro} function. It permits searching all files currently being edited. VEDITSAV.VDM This macro is automatically loaded by VEDIT when the option to enable the edit session restore has been selected. WILDFILE.VDM This macro is automatically loaded by the {MISC, WILDFILE macro} function. It permits performing a search/replace on an entire group of files, e.g. all files in a directory. It can also be run from DOS with the supplied WILD.BAT file: WILD KEY-MAC.LIB Library of useful keystroke macros that be added to VEDIT and assigned to a "hot key". It includes duplicating characters and lines, moving the cursor by sentence, listing lines containing a text string, transposing characters, counting words, finding the longest line, and much more. USER.MNU This "menu" is loaded by the demo/tutorial as an example of a {USER} menu that can be added to the main menu system. ANSI.TBL This translation table can be loaded into VEDIT to replace the default EBCDIC table. BRIEF.KEY These files are alternate keyboard layouts which emulate WORDPERF.KEY Brief, Word Perfect and WordStar. The emulations are WORDPERF.KEY described in the corresponding ".DOC" files. Instructions for using the ".KEY" files are given below. EXAMPLE.DB Example database type file using "fixed-length" records. It is used during the demo. DEMO.VDM The DEMO.VDM and DEMOxx.VDM are the demo "macro" files. DEMOxx.TXT Text files and instruction files which make up the demo. Automatically loaded by DEMO.VDM. VCSD.EXE When you run this program, it expands into all the files needed to run the Compiler Support portion of the demo. This should be done on a hard disk. Editing Your Own Files ---------------------- After running this demo/tutorial, you can try out the demo version of VEDIT PLUS on your own files with the command: VDEMO filename (also multiple files, e.g. "VDEMO *.C *.H") This will let you edit files of any size, but limits you to 1000 keystrokes - it will then exit after letting you save or abandon your changes. Alternatively, you can run the demo with an unlimited number of keystrokes, but cannot save files greater than 2K in size. The command is: VDEMO -D filename Browsing Files -------------- VEDIT has a special mode for browsing files; this prevents accidental alterations. In browse mode you can instantly jump to the beginning or end of the file, or to a relative position in the middle when using a mouse. VDEMO lets you browse and perform searches in files up to 2 Gigabytes in size with the command: VDEMO -D -B filename Disk Sector Editing ------------------- The demo version VDEMO can open the disk for browsing and searching, but cannot modify sectors. This prevents you from corrupting your disk while experimenting with the disk sector editing capabilities. Other Invocation Options (Troubleshooting) ------------------------------------------ If you have a B/W monitor, e.g. a "Monochrome VGA", you may need the "-M" option; otherwise the pull-down menus may be blank. Use the command: VDEMO -M filename VEDIT normally increases the typematic (repeat) rate of the keyboard. This causes problems (slow exiting, hanging) on some machines. Use the "-K" option to have VEDIT leave the typematic rate unchanged: VDEMO -K filename If you are using a Microsoft or Logitech mouse, VEDIT will start up faster (by a few seconds) if you use the "-P" option. (It skips the time consuming "hardware" mouse reset.) However, "-P" will prevent the Mouse Systems and possibly other mouse drivers from working properly. VDEMO -P filename (VEDIT can be configured so that these invocation options aren't needed.) For a summary of all VEDIT invocation options, give the command: VDEMO /? Notes: For the on-line help to work, the VPHELP.HLP" files must be in the current directory, or in "\VEDIT\DEMO" of the current drive. VEDIT can be configured to find its help files in any desired directory of any drive. (See also the "SET VEDPATH=..." command above.) Changing the Keyboard Layout ---------------------------- The {MISC, Keyboard layout} sub-menu lets you change the keyboard layout as desired. Let the on-line help guide you. The "Save to disk" function lets you save the entire keyboard layout as a .KEY file. "Load from disk" lets you load a complete new keyboard layout at any time. The .KEY files are easily edited; this gives you another (preferred) method of changing the layout. However, this demo version does not let you permanently save any layout changes. To setup VEDIT to emulate Brief, Word Perfect or Wordstar, load the files BRIEF.KEY, WORDPERF.KEY or WORDSTAR.KEY by selecting {MISC, Keyboard layout, Load from disk}. The files BRIEF.DOC, WORDPERF.DOC and WORDSTAR.DOC document these emulations. Note: The instructions during the demo are set up for the default keyboard layout. Therefore, we suggest finishing the demo before changing the keyboard layout. Reach us on CompuServe or our BBS --------------------------------- We provide customer support and sales information on both CompuServe (GO VEDIT) and on our 24-Hour Bulletin Board System (BBS). You can use either CompuServe or our BBS for: * The latest version of our demo/tutorial disk and shareware VEDIT Jr. * Sales and update information; news of recent and upcoming versions. * Access to all VEDIT PLUS supplemental files. This includes all compiler support, help and macro library files. Additional services only on CompuServe: * User forum for sharing application notes and macros. Additional services only on our BBS: * Registered users can download minor updates at no charge. * Any product can be downloaded within a few hours after contacting our sales department with your ordering information. Additional VEDIT PLUS and Compiler Support Files ------------------------------------------------ The demo version does not include all supplemental files supplied with the VEDIT PLUS product. In particular, the compiler support modules for other compilers and several macro libraries are not supplied. If desired the additional supplemental files can be downloaded from either CompuServe or our BBS. The files to download are VP-FILES.EXE and DISTCOMP.EXE. When you run them, they will expand into all VEDIT PLUS files, except of course the "live" VEDIT.EXE. To download these files from our BBS, logon and select "F" (File library) from the main menu. Then specify the files to be downloaded - VP-FILES.EXE and DISTCOMP.EXE. Enjoy the demo and be sure to contact us if you have any questions. ------------------------------------------------------------------- Greenview Data Inc. P.O. Box 1586 Ann Arbor, MI 48106 Toll Free: (800) 45-VEDIT (U.S. and Canada) Telephone: (313) 996-1300 Fax: (313) 996-1308 24-Hour BBS: (313) 996-1304 (14,400/9600/2400/1200 baud, 8 Data bits) (Supports MNP, V.32, V.42bis) CompuServe: GO VEDIT (71333,3656) Notes: To print this file, give the DOS command: VDEMO -Z -X PRINT READ-ME.TXT If you notice letters missing from the pull-down menus when running on a monochrome display, you may have the contrast control on your monitor adjusted too low or may need to use the "-M" invocation option described above.