This file (README.TXT) contains important and last minute information about: dCG (draft) Code Generator v0.07a A general purpose source code generator for Windows 32-bit edition (Windows 95/NT) 07-Oct-1996 rncbc (c) 1996, Copyright by Rui Capela Email: rncbc@mail.telepac.pt CompuServe: 100256,2502 rncbc@compuserve.com http://ourworld.compuserve.com/homepages/dCG1.htm ======================================================================= dCG primary use is intended to generate all that common code that you have to type whenever you're about to start a new project. This has been quite useful in the Windows programming arena, where one have to type the same good old code every time a new idea comes into mind. Yes there's truth that every C/C++ compiler vendor offers something that fills neatly this task, but it's somewhat hardwired to a specific framework (e.g. MFC, OWL). What about if you have your own framework? There's where dCG could help. This is an example of the necessity for a code generator like dCG. The basic idea is that you have to type all the common code nevertheless, but only once and with a little help from dCG scripting, you tailor that code as a template and build a base groundwork for next projects. Of course it was created having C/C++ coding in mind, but I've been heavy using the same idea for creating everything else that can be held by a source text file: real examples have been COBOL mainframe code, REXX, DB2/SQL DDL, HTML, etc. Probably any other procedural language is no obstacle, as you can imagine. If you have any specific question or problem in mind about using dCG for your own needs please feel free to state it. I'll appreciate very much helping you evaluating the usability of dCG. It can happen that it's the tool you want, but the opposite can also be true. There's nothing like really trying it! ======================================================================= FILES IN THIS PACKAGE README.TXT - This very file. CHANGES.TXT - List of changes since last release. DCG32.EXE - The main application executable (for Windows 95/NT). DCGAPI32.DLL - The interpreter/generator engine component. DCGTYP32.DLL - Default data-type registration driver. DCG.HLP - On-line documentation with dCG Scripting language guide and reference. SAMPLE.DCG - A sample script file, for a Generic Windows SDK windows application. ======================================================================= INSTALLATION Installation of this package should be done by following these steps: 1. Create a working folder on your computer for the application (e.g. C:\DCG). 2. Copy all files to the folder you've just created. 3. If you wish, create a shortcut to point to DCG.EXE. 4. Now you're ready to run DCG.EXE. Note: If you've installed a previous version of dCG make sure you overwrite all existing files. ======================================================================= INTENDED FUTURE ENHANCEMENTS 0. Correction of current version bugs and/or misfeatures. 1. Code generation project database to assist your "cut and paste" way of code reusability (i.e. code snippets). 2. Extension driver to parse and process resource files (.RC). This will let you generate custom dialog code for resource files created by resource editors like Borland's Resource Workshop or Microsoft's Dialog Editor and/or AppStudio. 3. A better edit custom control (in the Win95 version I will try to use the RichEdit standard control). N. Any other suggestion you may think of -- spit it right through my Email address: rncbc@mail.telepac.pt. ======================================================================= DISCLAIMER This is just an evaluation copy of software that are still in alpha version. You can use and distribute the software without prior agreement with the author, as far as you keep the above copyright notice. This software is made available "as is" without any express or implied warranty of merchantability or fitness for a particular purpose. The author, Rui Nuno Capela, is not responsible for lost profits or revenue, loss of use of the software, loss of data, costs of recreating lost data, the cost of any substitute equipment or program, or claims by any party other than you. ======================================================================= Enjoy dCG. rncbc a.k.a. Rui Nuno Capela Email: rncbc@mail.telepac.pt CompuServe: 100256,2502 or rncbc@compuserve.com http://ourworld.compuserve.com/homepages/rncbc