home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / ctdemo.zip / readme.1st < prev   
Text File  |  1995-04-07  |  11KB  |  266 lines
  1.                         CTHROUGH - DEMO README
  2.                         ======================
  3.  
  4. Welcome to the CThrough demo version 1.2a !
  5.  
  6. This is *not* a small and fast demo. But if you are willing to spend
  7. some time, it should give you a good idea about what CThrough is and
  8. if it might be worthwhile for you.
  9.  
  10. This demo version does not expire, you might use it (for small projects)
  11. as long as you want. However, it is a restricted version that:
  12.  
  13.  - handles only class libraries with less than 30 classes
  14.  - stores only classes with less than 30 function members
  15.  - provides only support for creating and modifying classes,
  16.    building applications, exception handling and heap tracing
  17.  
  18. Even if all the configuration management tools, the DiskBrowser, the
  19. OutlineEditor, the class conversion tools and some other support tools
  20. are missing, there still remains a lot of things to discover. Besides
  21. the quantity restrictions, you can build and maintain real applications
  22. with this version.
  23.  
  24.  
  25.  
  26. 1. What's in the package
  27. ========================
  28.  
  29. This distribution should come with three subdirectories:
  30.  
  31. │
  32. └─┬CTHRU
  33.   │    readme.1st     : this file
  34.   │    install.cmd    : the basic install procedure
  35.   │
  36.   ├─ SYSTEM
  37.   │    ctdsk          : disk label file used by install.exe
  38.   │    ctinst1.zip    : zip archive containing CThrough base system
  39.   │    install.exe    : CThrough install program (called by install.cmd)
  40.   │    readme.1st     : again, this file
  41.   │    unzip.exe      : the public unzip utility (see Copyright)
  42.   │
  43.   ├─ CLASSES
  44.   │    @clslib1.zip   : zip archive containing a sample class library
  45.   │    ctini.tmp      : CThrough init file for this class library
  46.   │    libdsk         : disk label file used by the ClassLib installer
  47.   │
  48.   └─ DOC
  49.        order.ps       : order form (Postscript format)
  50.        overview.ps    : 16 pg. technical brochure
  51.        tutorial.ps    : 220 pg. CThrough tutorial (Postscript)
  52.  
  53.  
  54.  
  55. 2. Prerequisites
  56. ================
  57.  
  58. Besides OS/2 2.1 - 3.0 you should have (at least) 8 MB of RAM, a high
  59. resolution graphics card / monitor (> 640x480) and about 10 MB of free
  60. disk space. In order to build applications, CThrough requires the
  61. IBM C/Set++ compiler to be installed.
  62.  
  63. CThrough can even be started if you don't have C/Set++ on your machine,
  64. In this case, you will get some warnings at startup time (telling you that
  65. entries in the CTPATH.INI configuration file are missing). These warnings
  66. can be ignored, CThrough usage will be restricted just to editing and
  67. analyzing classes.
  68.  
  69. If you are using the IBM CPPBETA, you should change the LINKER setting
  70. in the CTPATH.INI configuration file from LINK386.EXE to ILINK.EXE.
  71.  
  72.  
  73.  
  74. 3. Quick Install
  75. ================
  76.  
  77. The installation of CThrough actually is a 3 stage process
  78.  
  79. a.) switch to the root directory of the distribution:
  80.  
  81.         "CD \CTHRU"
  82.  
  83. b.) start the install procedure
  84.  
  85.         "INSTALL"
  86.  
  87. c.) when the root install dialog (labeled "Welcome to the CThrough...")
  88.     comes up, enter the *full* pathname (with drive) where you want to
  89.     install CThrough, e.g.
  90.  
  91.         "C:\CTHROUGH"
  92.  
  93.     Click on "Install CThrough" to start stage 1 which will create
  94.     the appropriate target directories and copies / unzips the required
  95.     files from the SYSTEM distribution directory. After unpacking all
  96.     required files, a desktop folder named "CThrough Demo" is created.
  97.  
  98. d.) The next stage will automatically start CThrough itself in order to
  99.     build the required configuration files. After some seconds, a dialog
  100.     labeled "CThrough IniBuilder" pops up. From within this dialog, you
  101.     have to perform the following steps:
  102.  
  103.     - click on "Scan" to start the disk scan process which will locate
  104.       several external programs (e.g. the compiler) which are needed by
  105.       CThrough. Depending on the size and speed of your harddisk, this
  106.       may take some time
  107.  
  108.     - specify a hostname for your computer which is used by CThrough
  109.       to identify your files. This name should not exceed 4 characters
  110.       and is stored in the environment variable CTHOST which should be
  111.       set in the CONFIG.SYS, e.g.
  112.  
  113.              "SET CTHOST=PCM"
  114.  
  115.       This is the *only* change of CONFIG.SYS which is required by
  116.       CThrough. If you - like me - don't like install programs to
  117.       silently mess up your CONFIG.SYS, you can make this change
  118.       manually prior to installing CThrough. It will be recognized
  119.       by the install process and the CONFIG.SYS will not be changed
  120.       at all. Otherwise CThrough can make this change for you if you
  121.       enter a name in the entry and click on the "Update" button.
  122.  
  123. e.) The last stage will install a sample class library from the
  124.     CLASSES distribution directory. Again, this is done by CThrough
  125.     itself with a dialog labeled "CThrough Class Library Installer".
  126.     You should *not* change the setting of the "Source" entry (which
  127.     should be initialized with the full pathname of the CLASSES
  128.     directory). However, you might want to change the directory name
  129.     where the library should be installed (e.g. "G:\CLS_LIB"). Again,
  130.     this has to be a full pathname. But it does not have to (and should
  131.     not) be a subdirectory of your CThrough base installation (specified
  132.     in stage 1.
  133.  
  134.     Simply click on "Install" to start creation of directories and
  135.     extraction of supplied files. When this stage is completed, you
  136.     should have an additional program entry (labeled with the directory
  137.     name you have chosen for the class lib) in the CThrough demo folder.
  138.  
  139.  
  140. Finally, reboot the machine to put the CTHOST setting into effect.
  141.  
  142. The files from the DOC subdirectory are not copied. Because of the
  143. file sizes, you should print the files directly from the DOC directory
  144. or just view them with generally available Postscript previewers like
  145. GhostScript. There are a lot of bitmaps in the tutorial and the brochure.
  146. You therefore should print them with at least 300 dpi (and a lot of
  147. time to spend). But having a look at the tutorial is *highly* recommended.
  148. Learning CThrough from the online reference might be somewhat painful.
  149.  
  150.  
  151.  
  152. 4. What to do next
  153. ==================
  154.  
  155. After successfully completing the installation, you should have a desktop
  156. folder named "CThrough Demo" with the following contents:
  157.  
  158.  "CThrough Demo"          : main CThrough folder
  159.  │
  160.  ├─ "XProcessor"          : program object to start the XProcessor tool
  161.  │
  162.  ├─ "CThrough Reference"  : program entry to view the online reference
  163.  │
  164.  ├─ "Configuration"       : subfolder with maintenance tools
  165.  │  ├─  "INI PathEditor"  : program entry for changing program paths
  166.  │  ├─  "INI FontEditor"  : program entry for changing font settings
  167.  │  ├─  "Lib Installer"   : program entry for installing new class libs
  168.  │  └─  "Lib Distributor" : program entry for creating class lib packages
  169.  │
  170.  └─ "x:\cls_lib"          : program entry to start CThrough on the
  171.                             class lib installed during step e. (The
  172.                             label will vary according to where you
  173.                             installed the class lib)
  174.  
  175.  
  176. Please refer to the online reference and the tutorial for meaning and
  177. usage of the "Configuration" subfolder items.
  178.  
  179. You should start with a doubleclick on the class lib object (e.g.
  180. "x:\cls_lib"). This will bring up CThrough showing the installed class
  181. library contents. Initially, there will be 2 windows: the Controller
  182. and the HierarchyViewer. A doubleclick on a classname in the left pane
  183. of the HierarchyViewer will bring up a ClassEditor on the selected class.
  184. With the popup menu, you can launch an AppsBuilder on the following
  185. example application classes:
  186.  
  187. XH_t1
  188.   Example of how to use the exception handling classes and tools that come
  189.   with CThrough. Make sure you start the XProcessor (from the CThrough Demo
  190.   Folder) prior to starting the application. After the application was
  191.   terminated, launch an XLogViewer to examine the saved exception log.
  192.  
  193. Heap_t2
  194.   Example to show the heap management / trace classes and tools that come
  195.   with CThrough. Compile/build with the AppsBuilder "heaptrace" option
  196.   enabled. Run with "App->Start Heaptrace" from the AppsBuilder menubar.
  197.  
  198. ICCLCTest
  199.   Example of how to use a mix of own template classes (TinyList) and the
  200.   IBM collection class lib. Look at the imports of ICCLCTest to see how
  201.   an external template is instanciated, Look at MyUniverse to see how this
  202.   is done for an own template class.
  203.  
  204. List_test
  205.   Small example from the tutorial demonstrating how to build applications
  206.   consisting of several classes
  207.  
  208. AHelloWindow
  209.   Ported IBM ICUI class example from \IBMCPP\SAMPLES\HELLO3. Shows how
  210.   to build applications which require additional files (*.ico, *.rc). Uses
  211.   implicit resource file compilation.
  212.  
  213. AHelloWindow5
  214.   Same as above for \IBMCPP\SAMPLES\HELLO5 (some more extra files, shows
  215.   explicit "post-build" procedure usage (*.cmd)
  216.  
  217.  
  218. To build an example, open the AppsBuilder on it, set the appropriate
  219. switches and click on the "Build" menubar item. Applications can be run
  220. from inside of the AppsBuilder by using the various "App" menubar items.
  221.  
  222. You can get online help on each pane by simply clicking on it and pressing
  223. the F1 key. If you need help for the whole window (e.g. the AppsBuilder),
  224. there is a "Window Help" item in the Help menu. For windows without menubars
  225. (like the AppsBuilder), the Help menu is accessible via the SystemMenu.
  226.  
  227. If you are using large header files or classes, you might want to uncomment
  228. and set the CLSHDR and SYSHDR settings in the CT.INI configuration file of
  229. your class library. File squeezing (which is done automatically) can speed
  230. up the compilation of large systems up to 30%. However, please refer to the
  231. CThrough reference prior to enabling class and header squeezing. You should
  232. also make sure that the corrected header files which are contained in the
  233. IBMHDR.ZIP archive in the HEADER subdir of your class library are unzipped
  234. and compatible with your compiler version.
  235.  
  236.  
  237. 5. Copyright
  238. ============
  239.  
  240. There are several programs in this distribution which are NOT part of
  241. CThrough. These programs are either under the GNU Copyleft (please refer
  242. to the included COPYING file for details) or in the public domain:
  243.  
  244. - UNZIP.EXE
  245. - VIEWHELP.EXE
  246. - GAWK.EXE      (which is only a dummy in the CThrough demo version)
  247.  
  248.  
  249. All of the listed programs can be downloaded from BBS or CompuServe.
  250.  
  251.  
  252. 6. How to order
  253. ===============
  254.  
  255. There is a file ORDER.PS in the DOC subdirectory which contains a
  256. fax order form. If you need additional information, please contact us:
  257.  
  258. BISS GmbH
  259. Chaukenweg 12
  260. D-26388 Wilhelmshaven, Germany
  261.  
  262. phone:        +49 4423 9289-20
  263. fax:          +49 4423 2360
  264. CompuServe:   100031,1733
  265.  
  266.