Chap.1: INSTALLATION

This library comes in full source code, and all you have to do is to unpack it or copy the directory tree onto your hard disk. The instructions are provided with the software.

Under the root directory PTL, you will have the following directories:

  • LIB ... the library itself, one *.h file for each class template.
  • ENVIR ... directory which lets you convert the library easily to different operating systems and compilers, and contains compilation script files for the regression tests.
  • MGR ... source and executable of the Template Manager, and of a special DIFF program which is used in regression testing.
  • DOC ... the documentation (Users Guide) in HTML format.
  • TTEST ... regression test suite using plain templates (not the Template Manager).
  • MTEST ... regression test suite using the Template Manager.
  • OUT ... correct results for all tests (identical for TTEST and MTEST).

After you have installed all of the files, recompile the library using these steps:

  1. Change to directory PTL\ENVIR, and select the batch file corresponding to your favorite compiler. For example, for Microsoft Visual C++, type msft, or for Borland C++ type borland. If there is no batch file for your compiler, modify one of these files.
  2. Change to directory MGR, and type all. This will recompile the Template Manager, and a special diff program used in the regression tests.
  3. There is no need to recompile the library itself. Directory LIB contains source code for all the templates which must be compiled again with each application.

All the documentation is in the directory DOC. The documentation is in HTML format, and you can conveniently browse through it with any WWW browser, such as Netscape Navigator/Communicator or Internet Explorer from Microsoft. Start with the file GUIDE.HTM. If you don't have a WWW browser, you can either ask a friend who has such a browser to print the documentation for you, or you can purchase the printed Users Guide from our company.

Directories TTEST and MTEST contain test programs for all patterns currently available from the library. These programs can verify that your installation is complete and correct, but they are also invaluable as examples and provide guidance when you are learning how to use a new class. To start a complete regression test, type regr in either directory.

If you run into difficulties, feel free to contact us:

  • email (prefered): info@codefarms.com
  • fax: 613-838-3316
  • telephone (please use only as last resort): 613-838-4829
  • Our address is: Code Farms Inc., 7214 Jock Trail, Richmond, Ontario, K0A 2Z0 Canada
  • For information on other products and services, see: http://www.CodeFarms.com