Power-Programmierung

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

/ Power-Programmierung / CD2.mdf / c / library / mslang / glide1 / disk1.exe / GLIDE.DOC < prev next >

Wrap

Text File | 1993-08-01 | 23.5 KB | 554 lines

'The Glide' Generic Language Integrated Developement Environment Version # 1.00.02 (c) Copyright 1993, Russell A. Powell All Rights Reserved. Revision date: August 1993 DISCLAIMER OF WARRANTY ---------------------- USERS OF THE GLIDE MUST ACCEPT THIS DISCLAIMER OF WARRANTY: THIS SOFTWARE AND DOCUMENTATION ARE PROVIDED AS IS WITHOUT ANY WARRANTIES AS TO PERFORMANCE, MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. GOOD DATA PROCESSING PROCEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED WITH NON-CRITICAL DATA BEFORE RELYING ON IT. THE USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM. ANY LIABILITY OF THE AUTHOR/SELLOR WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF THE PURCHASE PRICE. IF YOU DO NOT ACCEPT THE ABOVE STATEMENTS, DELETE 'THE GLIDE' AND ALL OF ITS ASSOCIATED FILES NOW !! LICENSE AGREEMENT ----------------- 'The Glide' IS NOT FREE !! The Glide is a user-supported "shareware program". You may use 'The Glide' for 30 days free of charge for the purpose of evaluating it to see if it meets your needs. If after 30 days you continue to use 'The Glide', YOU MUST REGISTER YOUR COPY. Feel free to share it with your friends, but please do not give it away altered or as part of another system. The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you find this program useful and find that you are using 'The Glide' and continue to use 'The Glide' after the 30 day trial period, you must make a registration payment of $49 to the author at the address listed below. The $49 registration fee will license one copy for use on any one computer at any one time. You must treat this software just like a book. An example is that this software may be used by any number of people and may be freely moved from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another. Just as a book cannot be read by two different persons at the same time. Site-License arrangements may be made by contacting the author. You are encouraged to pass a copy of 'The Glide' along to your friends for evaluation (see the list of Glide System files below). Please encourage them to register their copy if they find that they can use it. All registered users will receive a copy of the latest version of the 'The Glide' system and any utilities for 'The Glide' that are available at the time of registration. Registered users will also get support on Delphi by leaving E-mail to POWELLR@Delphi.Com, or by postal mail sent to the address on the registration form. About "The Glide" ================== The Glide is designed to provide an Integrated Development Environment (IDE) that is fully configurable, allowing you, the programmer, to develop programs in any language, and use any tool you currently have within a consistent, stable, and easy to use interface shell. Features -------- All Aspects Completely Configurable. Menu driven and Mousable with Complete Internal Help System. Internal file Viewer supports: Text, *.DBF, *.LZH, Compressed Glide Projects (*.GLA), *.PCX Swap to Expanded memory, High memory, or Disk. Supports 25, 43, or 50 column screen modes. Globally Find and Replace Character Strings throughout multiple files. Define up to 6 Tools / Utilities with each Language Environment. Internal or External Screen Saver. Internal On-Screen Clock, pop-up Calculator, and Calendar. Print files with user Defined Printer Initialization and Reset Strings. Execute DOS Commands or Completely Shell out to DOS Setup DOS Environment Variable(s) for each Language Environment or Project Creates your Make and Link utility Script files for you. Currently supported script formats include: RMake, RTLink, RTLink Overlayed, MS-Link, Blinker, Blinker Overlayed Remembers and reloads your last project. Archive/Unarchive all project files ( Registered users only ). Glide System Files ------------------- If all of the following files are not included with your copy of 'The Glide'. Please do not use it. It may be corrupt, and at best unpredictable results may occur. File Name File Description ------------------ ------------------ drive:\glide\+- glide.exe Glide System Loader | glide-x.exe Main Glide Executable | glide1.pcx Glide Opening Screen | glide2.pcx " " " | glide.dbf Glide Loader Information Data file | glide.dbt " " " " " | glide.cfg Glide Configuration File | glide.ico Windows Icon for 'The Glide' | glide.pif Windows Program Information file | glide.doc Glide External Documentation file | readme.doc Glide Quick Documentation | twhelp.dbf Glide Internal Help Data | twhelp.dbt " " " " | twhelp1.ntx " " " " | invoice.doc Glide invoice / order form | shr-ware.doc What is Shareware ? Documentation | revision.doc Glide revision information file +- \env\clipper.env Clipper Sample Environment file | msc.env Microsoft C/C++ " " +- \gfr\gfr.doc Global Find & Replace - Documentation | gfr.exe Global Find & Replace - Executable +- \lha\history.eng LHA Compression - History File lha.exe LHA Compression - Executable File lha.hlp LHA Compression - Help File lha213.doc LHA Compression - Documentation File Starting the The Glide ----------------------- The easiest way to run the Glide, is to put the glide directory in your DOS path, and just type: GLIDE [RETURN]. This however, is not strictly necessary, you may call the glide without it being in your path, by simply using the entire drive, directory and filename. Such as, "C:\GLIDE\GLIDE [RETURN]". This method will work just as well. The Glide will accept a parameter of /P=<PROJECT NAME>, which will force it to load the specified project. If you do not pass it a project parameter, it will attemp to load the last project that you worked on. General Operation Information =============================== The Glide allows you to define information about nearly all aspects of a programming task. First, you need to define information about the particular language that you are using and its associated programs. Such as, the Language compiler executable, link utility, make utility, etc. This information, I have termed as your operating environment or simply your environment. Next, you need to define the information that is associated with a particular project. This includes such things as your master source file, secondary support source files, object files, libraries, data files, etc. Once this information has been defined, everything that you need to do when developing a program is right at your finger tips. You can edit your source code, the Glide will generate generic make and link scripts for you which you can use directly or modify to suite your purposes. You can compile and link your code and the Glide will inform you if there was errors by monitoring the errorlevel returned by your compiler, linker, or make utility. You can run your debugger, to find all those nasty little errors ( but I guess you won't really need that, because you never write code with bugs in it, do you ? :-). You can run your project, and when everything is complete you can archive all of its associated files into an LHA Compressed format and store them safely out of harms way. If you ever need to modify it, you can simply unarchive the project and it will recreate all your files exactly the way they were including the directory structure. The Glide will swap itself out of Base memory to whenever it need to run another program leaving only about 12k of itself resident. You may configure the Glide to swap to either Expanded memory, High memory, or disk depending upon your needs. Basic Overview of Menu Options ------------------------------ File - The "FILE" Menu provides you with Global Services and Setup Options. File Menu Options > Open - Open and View a dBase, LHA Compressed Project, Standard Text File, or PCX Graphics file in an internal window. Currently supported PCX Formats include: VGA 320 x 200 x 256 VGA 640 x 480 x 16 EGA 640 x 350 x 16 (PCX Files must be less than or equal to 64k in size) > Global Find - GFR is a freeware utility that when given a file spec, & Replace will search and replace all occurrences of a particular string within all files that match the specification. > Execute - Run a single DOS Command. > DOS Shell - Exit to DOS to Run multiple commands. > Setup - Provides access to the Global and Environment setups, Utilities, Default Colors. > Register - What is Shareware? Print an invoice. Enter Registration number. > Exit - Quit "The Glide" Edit Menu Options The "EDIT" Menu enables you to use your preferred editor to edit several predefined project work files or project support files or to enter a filename of your choice to edit. Project Menu Options The "PROJECT" Menu allows you to load, edit, save, and erase pertinent information about a particular project. Once this information has been entered, the internal glide Script Creation utility will automatically create your make file in a RMake Style format, and your Linker script file in a RTLink/Plink, BLINKER, or Microsoft Link style format depending upon which one of them is selected in the project setup information. If you select the overlayed option for your link script, the Glide will create a script that attempt to overlay all project support files, objects, and library files. If you do not wish this to happen then you should select the non-overlayed option or edit and change the overlayed script to you liking. * NOTE * Library files defined in the environment setup will not be overlayed. Language Menu Options The Language menu allows you to shell out and compile, link or make the program source code that have been setup in your project. Debug Menu Options The "Debug" option shells out and runs your Debug utility with the name of your executable output file. You must have compiled and linked your application with the correct parameters specifying you want debug information included in the applications executable. Run Menu Option The "RUN" Option will Shell out and run the Output executable file specified in your project setup. Tools Menu Each Glide Environment file has an associated utility file that you may define up to 6 of your own utilities, and have them selectable from the Tools menu. The "Tools" Menu is a dynamically changing menu. This menu will change every time you change the utility setup information within the File setup menu. Glide Environment Setup ----------------------- Compiler Executable and Parameters - These fields define the name of your Compiler executable and the associated parameters that will be setup every time you load "The Glide". DO NOT put in any program source code names, they will be setup within the project information section of "The Glide". You may also use the browse button to select a file. Linker Executable and Parameters - These fields define the name of your Linker executable and the associated parameters, that will be set up every time you load "The Glide". As with the Compiler, DO NOT enter any source code filenames here. Make Executable and Parameters - Same as above. Debugger Executable and parameters - Same as above. Editor Executable and parameters - Same as above. Standard Libraries - Enter your default libraries or any libraries that cannot be dynamically overlayed. These libraries will be linked in at the root level during the linking process if you use the Make and Link script files created by the Glide. ( Use the spacebar to mark your selected files. They need not all be in the same directory as your master source file. ) Global Utilities Setup ---------------------- You may add up to six executable utilities to the glide menu system. They will appear within the "Tools" sub menu after they are defined in the utilities setup section. Menu Prompt - Enter in an 8 character prompt that will display under the "Tools" section of the main menu for this utility. Utility Description - Enter an extended description of the Utility you are adding. This description may be up to 78 character long. Executable Filename - Use the Alt-E keys to pull up a file selection screen, from there select the executable filename of any program you would like to add to the system. Utility Parameters - Enter any parameters that will be needed for this utility to operate properly. This field will also accept a predefined set of macros that when called will translate into project information. The macros are defined below: /master => Master source file name /support => Comma delimited list of support files /objs => Comma delimited list of object files /libs => Comma delimited list of Library files /cs => Compiler script name /ms => Make script name /ls => Link script name /exe => Executable output filename /cp => Compiler parameters /lp => Link parameters /mp => Make parameters /dp => Debugger parameters /ep => Editor parameters /? => Pop up a box and allow you to enter parameters at runtime Glide Color Setup ----------------- This option will allow you to configure the appearance of the Glide system. You may select any and all system colors through this process. Glide Project Setup ------------------- Workfile #1 - This is the primary program file you are working on. If it is not in the default directory you must specify a full path name or use the browse button to select a file. Project Support file(s) - These are secondary program file(s) that will be compiled and linked to create the final project executable. ( Use the spacebar to mark your selected files. They need not all be in the same directory as your master source file. ) ( Project Setup Continued ) Object Files - Enter all object files (*.OBJ) that need to be linked into your application. ( Use the spacebar to mark your selected files. They need not all be in the same directory as your master source file. ) Library files - Enter your project specific Library files for this application. They must be able to be overlayed if you are going to use the Overlayed scripts created by 'The Glide'. If they cannot be overlayed you must put them in the Standard libraries section of the Environment setup screen. ( Use the spacebar to mark your selected files. They need not all be in the same directory as your master source file. ) Supporting Data Files - Select any other file(s) that needs to be included with this particular project. These could include Database files, index files, documentation files, Icons, PCX Files, etc. Virtually any file can be linked with the project, and therefore, included in the projects archive file. ( Do not include project script files, they are included by default. ) ( Use the spacebar to mark your selected files. They need not all be in the same directory as your master source file. ) Project Environment - Select the language environment to be used for this project. Link Script Style - Define in what format you want the Link script to be created. The choices are: RTLink, RTLink Overlayed, Blinker, Blinker Overlayed, and Microsoft Link. Project Information - Enter descriptive information about this project. The project name and creation date are include automatically. You may enter a version number, and an extended description of the project. Project Specific Parameters - This is were you may enter project specific parameters for your compiler, linker, make utility, etc. These should be parameters that you normally don't use but are required for this application or are temporary in nature. Glide Internal Script Generator ------------------------------- This is a feature that will automate the creation of Link and Make utility script files for the your compiler and its associated Link and Make utility programs. These scripts are fairly general in nature in that they will definitely work with the following utilities: RMake, RTLink, Blinker, and Microsoft Link. If you are using something else, you should be able to modify them to work with your utility fairly easily. The scripts will use all the information in the Environment and project setup files, including all defined parameters for your Compiler, and Link utilities. ( Glide Internal Script Generator Continued ) The make file will use your selected compiler in its script to create the object files for your application. The link script will be created to conform to style that you select ( RTLink, Blinker, or Microsoft Link ). You may also tell the script generator whether or not you want a script that will allow your code to be overlayed. If you select the overlayed option, all supporting source, object, and library files will be overlayed. -*- NOTE -*- If you have a library that dictates that it may not be overlayed, you may define it in the Environment setup ( Standard Libraries ), any libraries defined here will be linked in at the root and will not be overlayed. Windows Usage ------------- I have provided a Windows PIF file, and a Windows Icon that you may use to call the Glide from within the Windows Environment. I personally have not had a whole lot of luck with them, it seems that the Glide wants more than windows is willing to give, but you may use them if you like. Future Enhancements ------------------- In the future, some of the things that I would like to see happen to the Glide are: Support for Microsoft's NMake Program Make Utility Scripts. Support for WarpLink Scripts. Ability to get a Print out of your Project and Environment setups. Support for all PCX File types and sizes. Maybe Some sort of Version Control System. I am also open for suggestions from registered users. Just jot some things down in the comments section of the Registration Invoice, and I will see what I can do. Acknowledgments --------------- I would personally like to thank and acknowledge the following people for their efforts and generosity in providing the following quality software to the general public as freeware. I have incorporated there programs into my own, and feel they deserve some of the credit as well. LHA Compression Software, Version 2.13 Copyright 1991, Haruyasu Yoshizaka GMUtant Find & Replace, Version 1.00 Copyright 1992, Clyde W. Grotophorst I would also like to thank the following software vendors for providing quality programming languages and environments, without which, this program would have never come into existence. Microsoft C/C++ (R), Versions 7 & 8 Copyright 1992-1993, Microsoft Corporation Microsoft Segmented Executable Linker (R), Version 5.5 Copyright 1984-1993, Microsoft Corporation Microsoft Windows (R), Version 3.1 Copyright 1985-1992, Microsoft Corporation Clipper (R), Versions 5.01a Copyright 1985-1992, Computer Associates International, Inc. RMake, Version 1.3 Copyright 1989-1992, Computer Associates International, Inc. RTLink, Version 3 Copyright 1988-1991, Pocket Soft Inc. Blinker, Version 2.0 Copyright 1991, Blink, Inc. 'The Glide' Version #1.00.02 REGISTRATION Quan Item Cost ___ 'The Glide' Registration............. @ $49.00 ea $________ (includes registration + program) Shipping & Handling (Quan x $3.00) $________ Illinois residents please add 6.5% PST. Tax $________ Total $________ Check disk size required: __ 5 1/4 __ 3 1/2 Checks or money orders accepted. ----------------------------------------------------------------- Name_______________________________________________________ Company_______________________________________________________ Address_______________________________________________________ _______________________________________________________ Phone_________________________ Bus.________________________ Where did you obtain 'The Glide'? _______________________________________________________ What Programming Languages are you using 'The Glide' with ? _______________________________________________________ _______________________________________________________ Comments_______________________________________________________ _______________________________________________________ _______________________________________________________ ----------------------------------------------------------------- MAKE PAYMENT TO: Russell A. Powell 708 Gawain Troy, Illinois, U.S.A. 62294