=============================================================================== OS/2 Visual Development Tools Version 0.8 - README.TXT =============================================================================== 1. Introduction: =============== This package contains some class libraries for use with the gcc/emx develop- ment package and applications supporting visual development by mostly doing drag and drop while programming. 2. List of files: ================ The package consists of the following archive files: * VD08BIN.ZIP Programs, libraries and header files * VD08DOC1.ZIP First part of the documentation (OS/2 inf and Postscript format) * VD08DOC2.ZIP Second part of the documentation (OS/2 inf and Postscript format) * VD08SMP.ZIP Sample programs for the development package. 3. Installation: =============== This is just a very short description. See the installation manual for more details. It can be found in \usr\doc\install.ps and \usr\lib\book\install.inf after uncompressing and installing the archive files listed above. Change the current working directory to the root directory of the HPFS drive you want to install the libraries to and type: unzip vd08bin unzip vd08doc1 unzip vd08doc2 unzip vd08smp This will create some directories and copy the necessary files into them. Add `c:/usr/include' to your environment variable `OBJC_INCLUDE_PATH' in your CONFIG.SYS, if you installed the library to drive C, or replace `c:' with the drive label you installed the library to. The samples have been installed to `\usr\samples'. Then, add `\usr\bin' and `\usr\bin\PM' to your `PATH' statement in CONFIG.SYS. Finally, add `\usr\lib' to the `LIBRARY_PATH' and `\usr\lib\book' to your `BOOKSHELF'. Then reboot the system. After rebooting, start the REXX script makeobj.cmd located in \usr\bin. Without any parameters, it will create a folder and program and documentation objects on your desktop, assuming the package is installed on drive C. If you installed the package on some other drive, specify the drive name. E.g. use makeobj d to tell makeobj.cmd that the library package has been installed on drive D:. Now you should be able to find a folder called `Visual Development' on your desktop. There you can find the program objects, a project template and objects for viewing the online-documentation. The Project Editor will need a make utility called `make.exe' to be installed somewhere in your PATH. Use e.g. GNU make for this purpose. For information on installing the major mode for Objective C programs for use with the text editor GNU Emacs see the installation manual. To print the documentation located in \usr\doc you will either have to use a Postscript printer or a Postscript interpreter (Ghostscript will work fine). All documents are prepared for two-sided printing, If you want to print only the odd/even pages, use a utility as found in the `pstools' package on hobbes.nmsu.edu. 4. Limitations of the Shareware Version: ======================================= Until now the library was not limited in any way. Starting with this version, some limitations have been put on the shareware version---just to give you some encouragement to register. On the one hand, I personally think you should pay for a piece of software you use for developing applications---either for your own use or for profit---so the shareware version has been ``crippled'' to some extent. You will not be able to develop any ``real'' applications because * the Interface Editor is limited to create at most two objects (windows, help objects,...), * you are not able to work with more than two interface files at once, and * the Project Editor will refuse opening more than one project at once. Especially the limitations of the Project Editor will make it impossible to choose ``File/Open'' from the main menu of the application. The only way to edit an already existing project is to specify the project directory on startup (e.g. by double-clicking the project's icon). In addition to that, the list objects (instances of SimpleList and KeyedList) in the utility library are limited to store at most 5 objects. On the other hand pricing for this development package is just very low. You cannot tell anyone, you can't afford to spend 400ATS (about 40US$) for a development environment if you spent much more on a computer capable of running OS/2 and the operating system itself---just assuming you are not running an illegal copy of OS/2, and who really would do this ;-) So, if you want to use this package for developing applications support any further improvements by registering; you can expect it to be a lot more comfortable and powerful in the next versions... Of course you will be sent the registered and unlimited version after you have paid the registration fee and I have received the registration form. This version will be sent to you via Internet E-Mail. If you do not have access to Internet E-Mail, enclose a self-addressed envelope, a single 3,5'' high density disk and return postage (use international postage reply coupons if you are located outside Austria) with your registration form so I can send you the registered version. Keep in mind that your registration fee will not be lost with the next version, you will be registered until version 1.0 of the development kit and then have the chance to update at a very low price. 5. Distribution: =============== This program is Shareware. Feel free to distribute the whole and unmodified package to anyone. You are not allowed to change any of the files part of the package before distributing, you only are allowed to distribute the package as a whole, including all files you received with it. Distribution of the registered version is *not* allowed. Distributing the registered version is an act of software-piracy. You probably don't want to do this ;-). You are allowed to charge a small amount of money for the physical act of transferring the library. This amount of money must not exceed twice the cost of the storage medium. So, if you for example use floppy disks at a price of 10 ATS (ATS is `Austrian Schillings' each, you are allowed to charge at most 20 ATS for copying the disk. That makes a total of 30 ATS (including packaging). If you are distributing this packages as part of a collection on a compact disk (CD), send me a copy of the disk along with pricing information. It's just that simple, if you think, you can make money by distributing shareware programs, send me a disk or you are not allowed to distribute this package. If you don't like these distribution restrictions, simply don't distribute the program. It's a shame to see some vendors ``selling'' Public Domain or Shareware programs at a price of 80 ATS per disk (3,5'' HD disks are sold at a price between 5 and 10 ATS). Especially those vendors are not allowed to distribute the library package at their normal copying costs. So, change your pricing policy, or just don't distribute this library package. If you're not sure, whether you are allowed to distribute the package, contact me. Any vendors who want to distribute registered versions of the library should do the same. 6. Licensing: ============ This libraries are distributed as Shareware. To become a registered user fill in the registration form in the file `register.txt' and send it to me (the address can be found in `register.txt'). You will be sent the registered versions of the package as soon as I receive the registration form (and of course after I checked with my bank that the registration fee has arrived). After registration you are automatically registered for all following versions of the library until the major version number increases. That means by registering this version of the library together with the PM class library (PM library: version 0.8; DB library: version 0.6) you are automatically registered for all future versions of the PM and DB libraries including version 1.0. Starting at version 1.1 of the PM or DB library you will have to register newly at a special update price. Support the Shareware distribution concept and register if you like this library and want to use it in your own applications. Future Shareware releases of this library depend heavily on the will of users to register. So, if no one registers this library, surely no further effort will be made in adding functionality to the libraries. As a registered user you are allowed to write applications using these two libraries and distribute them at whatever price you think of. Before registering you are allowed to test this library package as much as you like for a trial period of 30 days after first installing this package. You are not allowed to sell any of the applications written using this package if you have not registered it. If you continue using the library package after the trial period of 30 days and don't register, that's an act of software-piracy. May your bad conscious haunt you till the end of your days ;-) Think of the cheap pricing for this powerful library package and register. Future releases will provide better support for Presentation Manager programming and fast database access. Supporting various database engines is also being thought of. But future Shareware-releases of this software heavily depend on the number of registrations made. 7. Warranty: =========== Well, as you might have thought, there's ABSOLUTELY NO WARRANTY for this library package. 8. Pricing: ========== The registration fee for the OS/2 PM class library together with the Database library is 400ATS (400 Austrian Schillings), that's about 40US$, per copy for individuals or 500ATS for companies. Don't forget to check with your bank, how much you should pay, so that I will get the whole registration fee as mentioned above. Don't forget to fill in the registration form and send it to me (address below). ------------------------------------------------------------------------------- Send the money directly to my local bank account: NAME OF BANK: RAIFFEISENBANK KREMS ID Nr. OF BANK: 32397 ACCOUNT NR.: 12.195 As it seems to be quite expensive to transfer money from foreign countries to Austria---the fee for transferring the money could even be higher than the registration fee itself---you should think of another way I could get the registration fee which would be cheaper for you. On the on hand, Eurocheques seem to work just fine, but on the other hand, I would really never suggest you send the money directly via snail mail ;-) O.k., you should at least make sure the letter will arrive here safely. Always make sure to pay in Austrian currency! For information about 10+ licenses of this libraries feel free to contact me via Internet E-Mail (baier@ci.tuwien.ac.at) or via Snail Mail at: Thomas Baier Ufergasse 68 A-3500 Krems Austria Internet: baier@ci.tuwien.ac.at 9. Registration Form: ==================== After paying the registration fee, fill in the following registration form and send it to me to the following address: Thomas Baier Ufergasse 68 A-3500 Krems AUSTRIA --------------------------------- CUT HERE --------------------------------- Registration form for OS/2 PM and database libraries PM class library version is 0.8 Database class library version is 0.6 The registration fee for the OS/2 PM class library together with the Database library is 400ATS (400 Austrian Schillings), that's about 40US$, per copy for individuals or 500ATS for companies. Pricing for individuals: ____ copies for 400 ATS each makes a total of _____ ATS. Pricing for companies: ____ copies for 500 ATS each makes a total of _____ ATS. The total sum of _____ ATS has been paid to (check how you did it) [ ] THOMAS BAIER NAME OF BANK: RAIFFEISENBANK KREMS ID Nr. OF BANK: 32397 ACCOUNT NR.: 12.195, [ ] sent using an Eurocheque in Austrian Schillings, or [ ] some other way. Let me know how you did this! ____________________________________________________ Registration information: NAME: ______________________________ INTERNET-EMAIL: ______________________________ COMPANY: ______________________________ ADDRESS: ______________________________ ______________________________ ______________________________ ______________________________ SIGNATURE: ______________________________ ------------------------- END OF REGISTRATION FORM -------------------------