home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / gbase311.zip / INSTALL.HLP (.txt) < prev    next >
OS/2 Help File  |  1993-10-26  |  15KB  |  357 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Guidelines Installation ΓòÉΓòÉΓòÉ
  3.  
  4. Guidelines Installation 
  5.  
  6.                                     Welcome!
  7.  
  8. Welcome to the Guidelines Installation program.  This program will perform the 
  9. installation of Guidelines and any optional extension packs. 
  10.  
  11. Help is available at each step of the installation process, so if you are in 
  12. doubt, either press the Help button or press F1. 
  13.  
  14. Press the Ok button to continue. 
  15.  
  16.  
  17. ΓòÉΓòÉΓòÉ 2. Installation Help ΓòÉΓòÉΓòÉ
  18.  
  19. Installation Help 
  20.  
  21. Welcome to the Guidelines Installation program.  This program will perform the 
  22. installation of Guidelines and any optional extension packs. 
  23.  
  24. Help is available at each step of the installation process, so if you are in 
  25. doubt, either press the Help button or press F1. 
  26.  
  27. As you complete steps of the installation, a checkmark will be placed alongside 
  28. those items you have finished. 
  29.  
  30.  
  31. ΓòÉΓòÉΓòÉ 2.1. Directories Menu Item ΓòÉΓòÉΓòÉ
  32.  
  33. Directories Menu Item 
  34.  
  35. Selecting this menu item will invoke the Directories dialog, which allows you 
  36. to specify Source and Target directories for the installation. 
  37.  
  38.  
  39. ΓòÉΓòÉΓòÉ 2.2. Options Menu Item ΓòÉΓòÉΓòÉ
  40.  
  41. Options Menu Item 
  42.  
  43. Selecting this menu item will invoke the Options dialog, which allows you to 
  44. modify the behaviour of the installation program. 
  45.  
  46.  
  47. ΓòÉΓòÉΓòÉ 2.3. Install Menu Item ΓòÉΓòÉΓòÉ
  48.  
  49. Install Menu Item 
  50.  
  51. Selecting this menu item will begin the installation of the base Guidelines 
  52. product, using the settings you have selected within the directories and 
  53. options dialogs. 
  54.  
  55.  
  56. ΓòÉΓòÉΓòÉ 2.4. Install Extensions Menu Item ΓòÉΓòÉΓòÉ
  57.  
  58. Install Extensions Menu Item 
  59.  
  60. Selecting this menu item will invoke the Install Extensions Selection dialog, 
  61. allowing you to choose a Guidelines Extension Pack to install. 
  62.  
  63.  
  64. ΓòÉΓòÉΓòÉ 2.5. Convert Menu Item ΓòÉΓòÉΓòÉ
  65.  
  66. Convert Menu Item 
  67.  
  68. Selecting this menu item will invoke the Convert GUI Files dialog, which allows 
  69. you to selectively convert GUI files created by earlier versions of Guidelines. 
  70. The GUI files will be upgraded to a file format compatible with the version of 
  71. Guidelines being installed. 
  72.  
  73.  
  74. ΓòÉΓòÉΓòÉ 2.6. Exit Menu Item ΓòÉΓòÉΓòÉ
  75.  
  76. Exit Menu Item 
  77.  
  78. Select this menu item to leave the installation program. 
  79.  
  80.  
  81. ΓòÉΓòÉΓòÉ 3. Options Dialog ΓòÉΓòÉΓòÉ
  82.  
  83. Options Dialog 
  84.  
  85. This dialog allows you to modify the behaviour of the installation program. 
  86. The following settings may be modified: 
  87.  
  88. Γûá Update CONFIG.SYS 
  89. Γûá Create WPS Folder 
  90. Γûá Install Sample Applications 
  91.  
  92.  
  93. ΓòÉΓòÉΓòÉ 3.1. Update CONFIG.SYS ΓòÉΓòÉΓòÉ
  94.  
  95. Update CONFIG.SYS 
  96.  
  97. Guidelines needs to modify several environment variables within your CONFIG.SYS 
  98. file in order to operate correctly.  It will modify the following settings: 
  99.  
  100. LIBPATH     This setting tells OS/2 where to look for Dynamic Link Libraries 
  101.             (.DLL). So that Guidelines may find its own DLLs when it has not 
  102.             been started from its installed directory, the GUIDE\SYS directory 
  103.             is added to this setting. 
  104.  
  105. PATH        The PATH variable is used to find executable (.EXE) programs.  To 
  106.             allow you to run GUIDE from the command line from any directory, 
  107.             the Installation program will add the GUIDE directory to the PATH 
  108.             environment variable. 
  109.  
  110. HELP        This variable tells the Help Manager where to find online help 
  111.             files (.HLP). Guidelines itself, and all the custom controls have 
  112.             help files, so the Installation program will add GUIDE and 
  113.             GUIDE\SYS to the HELP path to find them. 
  114.  
  115. INCLUDE     The INCLUDE path tells the compiler where C/C++ header files 
  116.             (.H/.HPP) are to be found. The Guidelines runtime and all the 
  117.             controls have their own header files which are needed to compile 
  118.             applications, so the Installation program will add GUIDE\SYS to the 
  119.             INCLUDE path. 
  120.  
  121. LIB         The LIB path tells the linker where to find libraries (.LIB) to 
  122.             link as a final step of building an application.  As with the 
  123.             INCLUDE path, Guidelines and its controls need to know where to 
  124.             find their libraries, so the LIB path will have GUIDE\SYS added to 
  125.             it. 
  126.  
  127. GUE         This setting is specific to Guidelines, as it tells Guidelines 
  128.             where to find the GUE extensions which support the custom controls. 
  129.             This will be set to GUIDE\SYS. 
  130.  
  131. It is recommended that you allow the Installation program to modify CONFIG.SYS 
  132. for you, otherwise you will need to manually edit the file to ensure correct 
  133. operation.  If you opt not to have the changes done automatically, the required 
  134. changes will be written to a file called CONFIG.GL within the target directory. 
  135. These changes can then be applied manually before running Guidelines. 
  136.  
  137.  
  138. ΓòÉΓòÉΓòÉ 3.2. Create WPS Folder ΓòÉΓòÉΓòÉ
  139.  
  140. Create WPS Folder 
  141.  
  142. If this option is selected, the Installation program will create a Guidelines 
  143. folder on your Workplace Shell Desktop, which looks like this: 
  144.  
  145.  
  146. ΓòÉΓòÉΓòÉ 3.3. Install Sample Applications ΓòÉΓòÉΓòÉ
  147.  
  148. Install Sample Applications 
  149.  
  150. If this option is checked, a series of Guidelines applications will be 
  151. installed into the GUIDE\GUI directory.  There is a wide range of samples GUI 
  152. files, which illustrate important techniques for creating Guidelines 
  153. applications. 
  154.  
  155. Some applications are small and illustrate key concepts or demonstrate specific 
  156. features of a control, while others are more complex, and illustrate design 
  157. principles and coding examples used by the creators of Guidelines. 
  158.  
  159. It is recommended that all users install these samples, as even experienced 
  160. programmers may learn from them. 
  161.  
  162. Other sample programs will be installed within the GUIDE\BIN directory which 
  163. demonstrate some of the capabilities available in optional Guidelines extension 
  164. packs. GUI files for these programs have not been provided as they require the 
  165. extension packs to support them. 
  166.  
  167.  
  168. ΓòÉΓòÉΓòÉ 4. Installation Directories ΓòÉΓòÉΓòÉ
  169.  
  170. Installation Directories 
  171.  
  172. This dialog allows you to specify the source and target directories to be used 
  173. during the installation of Guidelines.  The following fields can be set: 
  174.  
  175. Γûá Install From 
  176. Γûá Installation Directory 
  177.  
  178.  
  179. ΓòÉΓòÉΓòÉ 4.1. Source Directory ΓòÉΓòÉΓòÉ
  180.  
  181. Source Directory 
  182.  
  183. This is the directory from which you are installing Guidelines.  It would 
  184. normally be A:\ or B:\ if you are installing from a floppy drive. 
  185.  
  186. If you are installing from a directory on a hard drive, the Installation 
  187. program will display the directory from which it was run, which should specify 
  188. the location of the installation files. 
  189.  
  190. This field should not normally be changed. 
  191.  
  192.  
  193. ΓòÉΓòÉΓòÉ 4.2. Target Directory ΓòÉΓòÉΓòÉ
  194.  
  195. Target Directory 
  196.  
  197. This field allows you to specify the directory in to which Guidelines will be 
  198. installed.  The default drive for installation is the OS/2 boot drive, and the 
  199. default directory is GUIDE.  If the target directory does not exist, it will be 
  200. created.  If the target directory already exists and contains an existing copy 
  201. of Guidelines, then the system files will be overwritten with the version being 
  202. installed.  Other user files within the target directory will not be affected. 
  203.  
  204. The Installation program will automatically check that there is sufficient 
  205. space to install all the options selected. 
  206.  
  207.  
  208. ΓòÉΓòÉΓòÉ 5. Registration Dialog ΓòÉΓòÉΓòÉ
  209.  
  210. Registration Dialog 
  211.  
  212. This dialog allows you to personalize your Guidelines package.  You should 
  213. enter the following information to before proceeding: 
  214.  
  215. Γûá Registration Number 
  216. Γûá Name 
  217. Γûá Company 
  218.  
  219.  
  220. ΓòÉΓòÉΓòÉ 5.1. Registration Number ΓòÉΓòÉΓòÉ
  221.  
  222. Registration Number 
  223.  
  224. Enter your Registration Number in this field.  Your unique Registration Number 
  225. is supplied with your Guidelines package.  If you have not purchased a 
  226. registered copy of Guidelines, a blank Registration Number will be accepted 
  227. which will provide full functionaility within the base product, but will 
  228. prevent the use of any Guidelines extension packs. 
  229.  
  230.  
  231. ΓòÉΓòÉΓòÉ 5.2. Name ΓòÉΓòÉΓòÉ
  232.  
  233. Name 
  234.  
  235. Enter your name in this field to customize your Guidelines package. This name 
  236. will appear in the Product Information dialog from within Guidelines.  If no 
  237. Company is specified, this Name will appear in your applications' Copyright 
  238. notices. 
  239.  
  240.  
  241. ΓòÉΓòÉΓòÉ 5.3. Company ΓòÉΓòÉΓòÉ
  242.  
  243. Company 
  244.  
  245. Enter your Company name (if any) in this field.  This Company name will appear 
  246. in your applications' Copyright notices.  If the Company name is not specified, 
  247. the Name will appear in the Copyright notices instead. 
  248.  
  249.  
  250. ΓòÉΓòÉΓòÉ 6. Installation Status ΓòÉΓòÉΓòÉ
  251.  
  252. Installation Status 
  253.  
  254. This dialog shows the progress of the installation.  It displays the actions it 
  255. is performing and shows a graphical bar representing the completion percentage 
  256. of the installation as it progresses.  Pressing the Cancel button will abort 
  257. the installation. 
  258.  
  259.  
  260. ΓòÉΓòÉΓòÉ 7. GUI Files Conversion ΓòÉΓòÉΓòÉ
  261.  
  262. GUI Files Conversion 
  263.  
  264. This dialog allows you to selectively nominate existing application GUI files 
  265. to be converted into a format compatible with the latest version of Guidelines. 
  266. You can optionally select files individually by pressing Select, or have the 
  267. Installation program automatically search all your drives for GUI files. Once 
  268. you have selected the desired files, press the Convert button to update the 
  269. files. 
  270.  
  271.  
  272. ΓòÉΓòÉΓòÉ 7.1. Files List ΓòÉΓòÉΓòÉ
  273.  
  274. Files List 
  275.  
  276. This list displays all the files which have been selected for conversion. Each 
  277. file may be individually selected or deselected by a single click with the Left 
  278. Mouse Button (LMB). 
  279.  
  280. Once you are satisfied with your selections, press the Convert button. 
  281.  
  282.  
  283. ΓòÉΓòÉΓòÉ 8. Install Extensions Dialog ΓòÉΓòÉΓòÉ
  284.  
  285. Install Extensions Dialog 
  286.  
  287. This dialog displays a list of the Extension Packs which are available for 
  288. installation.  Select an Extension Pack to install from the Extension Pack list 
  289. and press the Install button. 
  290.  
  291.  
  292. ΓòÉΓòÉΓòÉ 8.1. Extension Pack List ΓòÉΓòÉΓòÉ
  293.  
  294. Extension Pack List 
  295.  
  296. This list shows all of the Extension Packs which were located on the specified 
  297. source directory. Select an Extension Pack to install, and press the Install 
  298. button to proceed. 
  299.  
  300.  
  301. ΓòÉΓòÉΓòÉ 9. File Selection Dialog ΓòÉΓòÉΓòÉ
  302.  
  303. File Selection Dialog 
  304.  
  305. This is a standard OS/2 dialog which allows you to select one or more GUI 
  306. application files for conversion from earlier releases of Guidelines. 
  307.  
  308. Help is available for the following: 
  309.  
  310. Γûá Name 
  311. Γûá Type 
  312. Γûá Drives 
  313. Γûá Files 
  314. Γûá Directories 
  315.  
  316.  
  317. ΓòÉΓòÉΓòÉ 9.1. Name ΓòÉΓòÉΓòÉ
  318.  
  319. Name 
  320.  
  321. This field shows the currently selected file in the Files list.  You can also 
  322. type in the name of the desired file, if known. 
  323.  
  324.  
  325. ΓòÉΓòÉΓòÉ 9.2. Type ΓòÉΓòÉΓòÉ
  326.  
  327. Type 
  328.  
  329. This combo box allows you to select the Extended Attribute Type of the files to 
  330. display.  It is not currently used. 
  331.  
  332.  
  333. ΓòÉΓòÉΓòÉ 9.3. Drives ΓòÉΓòÉΓòÉ
  334.  
  335. Drives 
  336.  
  337. This combo box shows all the drives available on your system.  To select a file 
  338. on a different drive, simply click on the desired drive in the list. 
  339.  
  340.  
  341. ΓòÉΓòÉΓòÉ 9.4. Files ΓòÉΓòÉΓòÉ
  342.  
  343. Files 
  344.  
  345. This list shows the available GUI files in the current directory. You can 
  346. scroll through the list and select individual files to add to the list of files 
  347. to be converted. 
  348.  
  349.  
  350. ΓòÉΓòÉΓòÉ 9.5. Directories ΓòÉΓòÉΓòÉ
  351.  
  352. Directories 
  353.  
  354. This list shows a hierarchical display of the directories on the current drive. 
  355. To navigate through the list, double-click on the desired directory name.  As 
  356. you change directories, the list of files will be updated with the GUI files in 
  357. that directory.