home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Today - The Disc! 17 / cdrt17.iso / pc / crested / appsetup.inf next >
INI File  |  1995-08-27  |  23KB  |  511 lines
  1. ;
  2. ; Macros
  3. ; ------
  4. ;
  5. ; Any String that you define in this file can include one of the following
  6. ; macros to enable defining directory locations that would be impossible
  7. ; otherwise.  Simply place the desired macro in the string where you would
  8. ; normally use a pathspec.
  9. ;
  10. ; Supported Macros in this Version
  11. ; #W The user's WINDOWS directory
  12. ; #S The user's SYSTEM directory
  13. ; #D The directory in which the installation actually occurred
  14. ; #V The DRIVE on which the installation occurred, such as C: (no backslash)
  15. ;
  16. ; If you need to specify any of these letter combinations and do not want
  17. ; the macro expansion to take place, just precede the combination with an
  18. ; extra #, as in the following: "The ##Workplace ##Solution"
  19. ;
  20. ;
  21. ;
  22. ; -------------------------------------------------------------
  23. ; *************************************************************
  24. ; -------------------------------------------------------------
  25. ; INFOFILE
  26. ; -------------------------------------------------------------
  27. ; *************************************************************
  28. ; -------------------------------------------------------------
  29. ; The [infofile] section describes various miscellaneous aspects
  30. ; of the installation.  The FILENAME label indicates the name of 
  31. ; the text file that is shown to the user when the program starts 
  32. ; up.  The APPNAME label is used to refer to the name of the 
  33. ; application being installed.
  34. ;
  35. ; The EXEFILE label is used to tell InstallWare that you would
  36. ; like to run a file after the installation is complete.  This
  37. ; is useful for showing a readme file, unpacking some archives,
  38. ; or just starting up the program that was just installed.  In
  39. ; the example below, note that the filename starts with a backslash.
  40. ; This indicates that the program is in the PATH.  Otherwise,
  41. ; it is assumed to be located relative to the installation
  42. ; directory.  You can also use macros to indicate directories.
  43. ; The MESSAGE label denotes the text that will be
  44. ; displayed in the message box that prompts the user just before
  45. ; the EXEFILE is run.  If there is no MESSAGE, then the EXEFILE
  46. ; is run without prompting the user.
  47. ; -------------------------------------------------------------
  48.  
  49. [infofile]
  50.     filename= README.TXT
  51.     appname= "Crested Butte"
  52. ;       exefile  = "\notepad.exe sub\readme.iw"
  53.     exefile  = "#W\notepad.exe #Xreadme.txt"
  54.     message  = "Do you want to view the readme file?"
  55.     
  56. ; -------------------------------------------------------------
  57. ; *************************************************************
  58. ; -------------------------------------------------------------
  59. ; DIALOG
  60. ; -------------------------------------------------------------
  61. ; *************************************************************
  62. ; -------------------------------------------------------------
  63. ; The [dialog caption] section is used to define the caption
  64. ; of the windows that are shown in the INSTALL program.
  65. ; -------------------------------------------------------------
  66.  
  67. [dialog]
  68.     caption = "Crested Butte Installation"
  69.     Info, YES               ;Determines whether the introductory dialog 
  70.                     ;will be displayed. NO hides it
  71.     DirSelect, NO  ;Determines whether the dir prompt dialog
  72.             ;will be displayed. NO hides it
  73.             
  74. ; -------------------------------------------------------------
  75. ; *************************************************************
  76. ; -------------------------------------------------------------
  77. ; DATA
  78. ; -------------------------------------------------------------
  79. ; *************************************************************
  80. ; -------------------------------------------------------------
  81. ; The [data defdir] section defines the default directory. This
  82. ; directory is placed in the Install location editbox when the
  83. ; program starts.  If the user does not change it, then this
  84. ; will be the base directory of the installation.  To reference
  85. ; the WINDOWS directory on the user's system, use the #W macro.
  86. ; -------------------------------------------------------------
  87.  
  88. [data]
  89.      defdir = C:\CRESTEDB
  90. ;    defdir = #X
  91.  
  92.  
  93. ; -------------------------------------------------------------
  94. ; *************************************************************
  95. ; -------------------------------------------------------------
  96. ; DISKS
  97. ; -------------------------------------------------------------
  98. ; *************************************************************
  99. ; -------------------------------------------------------------
  100. ;
  101. ; The [disks] section defines the distribution disks that contain the
  102. ; application  files. InstallWare uses this information to tell the user to
  103. ; insert the correct disk.
  104. ; 
  105. ; Elsewhere within this .INF file, the distribution disks are normally
  106. ; referred to by a single-character disk ID. This section defines those
  107. ; disk IDs, and includes  information about the disk to which each disk ID
  108. ; refers.
  109. ;
  110. ; The disk ID '0' is reserved; it represents the installation directory -- 
  111. ; the directory in which the user is installing the application. 
  112. ;
  113. ; The format of each disk definition is:
  114. ; 
  115. ;     n = path, title
  116. ;
  117. ; where
  118. ;     n       is the disk ID (a single character from 1-9 or A-Z). 
  119. ;
  120. ;     path    the path of the source directory from which InstallWare should 
  121. ;             copy the files to the disk.  The path can be relative to the
  122. ;             source directory (see examples below).
  123. ;
  124. ;     title   is a descriptive name for the disk. The title should match 
  125. ;             the disk's printed or written label exactly.
  126. ;
  127. ; The following statements would define two distribution disks.
  128. ; 
  129. ;  1 =.,        "Demo Application Disk 1"
  130. ;  2 =.\files,  "Demo Application Disk 2"
  131. ;
  132. ; The first statement tells InstallWare to refer to Disk 1 as "Demo Application 
  133. ; Disk 1". Because the period (.) denotes the current directory, the files 
  134. ; on that disk will be copied from the root directory of the
  135. ; distribution disk. 
  136. ;
  137. ; The second statement tells InstallWare to refer to Disk 2 as "Demo 
  138. ; Application Disk 2"; the files that Disk 2 contains will be copied 
  139. ; from the \FILES directory of the distribution disk.
  140. ;
  141. ; You can include as many disk-definition statements as necessary. Every 
  142. ; distribution disk should have a corresponding disk-definition statement;
  143. ; otherwise, InstallWare cannot tell the user to insert the appropriate disk.
  144. ;
  145. ; For the purposes of this file we will use this disk definition line:
  146.  
  147. [disks]
  148.     1 =., 
  149.  
  150.  
  151.     
  152. ; -------------------------------------------------------------
  153. ; *************************************************************
  154. ; -------------------------------------------------------------
  155. ; NEEDED.SPACE
  156. ; -------------------------------------------------------------
  157. ; *************************************************************
  158. ; -------------------------------------------------------------
  159. ; This section tells INSTALL how much space is needed on the
  160. ; target disk to do a successful installation.  The user will
  161. ; get an error message if they try to install to a disk that
  162. ; has less space.
  163. ; -------------------------------------------------------------
  164.  
  165. [needed.space]
  166.     minspace = 1000
  167.  
  168.     
  169.  
  170. ; -------------------------------------------------------------
  171. ; *************************************************************
  172. ; -------------------------------------------------------------
  173. ; DEST.DIRECTORIES
  174. ; -------------------------------------------------------------
  175. ; *************************************************************
  176. ; -------------------------------------------------------------
  177. ; The [dest.directories] section contains section-definition statements.
  178. ; Each statement defines a section that lists application files to be
  179. ; copied as part of installation. The sections are organized by file 
  180. ; destination; you should define a separate section for each destination 
  181. ; directory. 
  182. ;
  183. ; Each section definition has the following form:
  184. ;
  185. ;     #section_name, 0:dest_pathname
  186. ;
  187. ; where
  188. ;
  189. ;     #section_name   defines the name of the .INF section that lists the
  190. ;                     files to be copied.
  191. ;     0               is the disk ID that represents the installation directory.
  192. ;                     (0 is a reserved disk ID, and always represents the
  193. ;                     installation directory -- the directory the user specified
  194. ;                     when asked where to install the application.)
  195. ;     dest_pathname   is the pathname of the destination directory, relative 
  196. ;                     to the installation directory. For example, "0:FILES"
  197. ;                     represents the FILES subdirectory of the installation 
  198. ;                     directory.
  199. ;
  200. ; -------------------------------------------------------------
  201. ; In the example below, the first two entries define application
  202. ; specific directories.  The #app.main directory will be the
  203. ; base directory defined by the user (or the default as
  204. ; described above).  The #app.sub directory will cause a
  205. ; directory called sub to be created off of the base directory.
  206. ;
  207. ; The third and fourth entries refer to the two Windows
  208. ; specific directories: \WINDOWS and \WINDOWS\SYSTEM.
  209. ; INSTALL will find these directories and copy the specified
  210. ; files into them.
  211. ; -------------------------------------------------------------
  212.  
  213. [dest.directories]
  214.     #app.main,   1: 
  215.  
  216.  
  217.  
  218. ; -------------------------------------------------------------
  219. ; *************************************************************
  220. ; -------------------------------------------------------------
  221. ; USER-DEFINED SECTION
  222. ; -------------------------------------------------------------
  223. ; *************************************************************
  224. ; -------------------------------------------------------------
  225. ; This section is a user-defined section that lists files to be copied to a
  226. ; particular destination directory. The [dest.directories] section defines.
  227. ; the name of this section and the destination directory of the files.
  228. ;
  229. ; In each section like this one, you should list all files that you want copied
  230. ; to the same destination. (For example, all the files in this section, 
  231. ; [app.user], will be copied to the installation directory.)
  232. ;
  233. ; InstallWare copies the files listed in this section in the order in which they
  234. ; are listed. 
  235. ;
  236. ; The syntax of each file listing is
  237. ;
  238. ;     N:FILENAME, "Description"
  239. ;
  240. ; where
  241. ;
  242. ;     N:           is the disk ID of the disk that contains the file. (Disk 
  243. ;                  IDs are defined in the [disks] section.) If the specified 
  244. ;                  disk is not in the disk drive, InstallWare prompts the
  245. ;                  user to insert it.
  246. ;       
  247. ;     FILENAME     is the name of the file, including any filename extension.
  248. ;
  249. ;     Description  is descriptive text that InstallWare displays as it is 
  250. ;                  copying the file or group of files.  If you leave the 
  251. ;                  description blank, InstallWare will continue displaying 
  252. ;                  the descriptive text from the previous file. This lets 
  253. ;                  you use a general name for a group of files.
  254. ;
  255. ;
  256. ; -------------------------------------------------------------
  257. ; This is the file list for the base directory.
  258. ; -------------------------------------------------------------
  259.  
  260. [app.main]
  261. ;1:README.TXT, "Readme information file."
  262. ;       1:FRAG.EXE, "Fragger"
  263. ;       1:TEST.001, "Test File"
  264. ;       1:TEST.002, "Test File"
  265. ;       1:TEST.003, "Test File"
  266. ; -------------------------------------------------------------
  267. ; This is the file list for the \WINDOWS\SYSTEM directory.
  268. ; -------------------------------------------------------------
  269.  
  270. [app.SETUPSYSDIR]
  271.     1:README.TXT,        "##WReadme File"        ; This shows the literal ## non-macro
  272.  
  273.  
  274. ; -------------------------------------------------------------
  275. ; This is the file list for the \WINDOWS\SYSTEM directory.
  276. ; -------------------------------------------------------------
  277.  
  278. [app.SETUPWINDIR]
  279.  
  280.  
  281. ; -------------------------------------------------------------
  282. ; This is the file list for the sub directory located off of
  283. ; the base directory.
  284. ; -------------------------------------------------------------
  285. [app.sub]
  286. ;    1:COMPR.C,         "Test Compressed"
  287.   1:README.TXT, "Readme File"
  288.  
  289. ; -------------------------------------------------------------
  290. ; *************************************************************
  291. ; -------------------------------------------------------------
  292. ; PROGMAN.GROUPS
  293. ; -------------------------------------------------------------
  294. ; *************************************************************
  295. ; -------------------------------------------------------------
  296. ; The [progman.groups] section (optional) tells InstallWare to create Program 
  297. ; Manager groups for your application. (InstallWare then uses DDE to 
  298. ; communicate with Program Manager.)
  299. ;
  300. ; The section lists the names of the groups you want to create. You then 
  301. ; define additional sections in this file; those sections list the program 
  302. ; items you want in each group.
  303. ;
  304. ; The syntax for each group name is:
  305. ;
  306. ;     groupname, [groupfile.grp]
  307. ;
  308. ; where
  309. ;
  310. ;     groupname      is the title you want Program Manager to display
  311. ;                    under the icon that represents the group. (The 
  312. ;                    groupname will also be the name of the section
  313. ;                    that defines the contents of the group.)
  314. ;
  315. ;     groupfile.grp  is the filename of the file in which Program Manager
  316. ;                    will save information about the group. (You must include
  317. ;                    the .GRP filename extension.) This parameter is optional;
  318. ;                    if you omit it, InstallWare uses a default name for the 
  319. ;                    group file.
  320. ;
  321. ; The following group-definition statement tells InstallWare to create a 
  322. ; group named "Bob Dolan Shareware", and store its information in a file
  323. ; named BOBDOLAN.GRP.
  324.  
  325. [progman.groups]
  326.     "Crested Butte Tour", CBUTTE.GRP
  327.  
  328.  
  329.     
  330. ; -------------------------------------------------------------
  331. ; *************************************************************
  332. ; -------------------------------------------------------------
  333. ; USER-DEFINED PROGMAN.GROUPS
  334. ; -------------------------------------------------------------
  335. ; *************************************************************
  336. ; -------------------------------------------------------------
  337. ; This section describes the Program Item Icon to add to the
  338. ; Program Group defined in the section heading.
  339. ;
  340. ; In each section like this one, you should list all items that you want 
  341. ; InstallWare to add to the group.
  342. ;
  343. ; The syntax for item-definition statements is: 
  344. ;
  345. ;     "Description",    APPFILE.EXE, [ICONFILE.EXE[, N]]
  346. ;
  347. ;where
  348. ;
  349. ;     Description   is the text that will appear below the program icon 
  350. ;                   when displayed in the Program Manager group. 
  351. ;
  352. ;     APPFILE.EXE   is the command line that starts the application.
  353. ;     
  354. ;     ICONFILE.EXE  is the application file that contains the icon you
  355. ;                   want to represent the application. Typically, this is 
  356. ;                   the executable application file, but it could be a 
  357. ;                   different file. (You can also specify a .ICO file, created
  358. ;                   using an icon editor.) This parameter is optional; if
  359. ;                   you omit it, InstallWare will use the first icon it finds in
  360. ;                   APPFILE.EXE. 
  361. ;
  362. ;     N             is the offset of the icon you want to use within the file
  363. ;                   ICONFILE.EXE.  This parameter is optional; if you omit it, 
  364. ;                   InstallWare uses the first icon it finds in ICONFILE.EXE.
  365. ;                   You must include this parameter if the file you specify
  366. ;                   contains more than one icon, and you want to use an icon
  367. ;                   other than the first icon. 
  368. ;
  369. ;                   To use the Nth icon, specify the number N-1. For example,
  370. ;                   to use the third icon, specify 2.
  371. ;
  372. ; For example, the following item-definition statement tells InstallWare to add 
  373. ; an item titled "Install" to Program Manager. The application command line is
  374. ; a file named INSTALL.EXE which is located in the SUB subdirectory off of the
  375. ; installation directory.
  376.  
  377.  
  378. ["Crested Butte Tour"]
  379.     "Crested Butte", #XCBTOUR.EXE
  380.     "Readme File", #XReadme.TXT
  381.  
  382.  
  383. ; -------------------------------------------------------------
  384. ; -------------------------------------------------------------
  385. ; *************************************************************
  386. ; -------------------------------------------------------------
  387. ; INI FILE MODIFICATION
  388. ; -------------------------------------------------------------
  389. ; *************************************************************
  390. ; -------------------------------------------------------------
  391. ; This section defines any INI file modifications that will be performed.
  392. ; The Installation Directory can be referenced by using the #D macro as is
  393. ; shown in the examples below.  If you specify an INI file that does not exist,
  394. ; it will be created.  If you do not specify a path, the WINDOWS directory is
  395. ; used.  Be sure to use quotes around text that contains spaces (see example).
  396. ; The format is as follows:
  397. ;       INIFILENAME, INI SectionName, Entry Label, Actual Text to be added
  398.     
  399. [INIFiles]
  400. ;        WIN.INI, InstallWare, TestEntry1, TestString1
  401.     
  402.  
  403. ; -------------------------------------------------------------
  404. ; *************************************************************
  405. ; -------------------------------------------------------------
  406. ; NON-OPTIONAL EXECUTABLE FILE LIST
  407. ; -------------------------------------------------------------
  408. ; *************************************************************
  409. ; -------------------------------------------------------------
  410. ; This section lists the files that will be executed to complete the installation.
  411. ; The user is not prompted as to whether they would like these files to be run.
  412. ; Common uses are running self-extracting archives or tutorials.  The filename
  413. ; that is specified is assumed to be relative to the install path.  The DELETE
  414. ; FLAG parameter indicates whether the file is deleted after it has completed
  415. ; executing.  All files run in succession, and processing of InstallWare is 
  416. ; suspended until each file terminates.  Use the #D or #W macros to reference
  417. ; the directory that was used for the installation.  A directory change is made
  418. ; just before the Command is run.  The directory changed to will be the same as
  419. ; the executable.  If no directory is specified, the installation directory is
  420. ; used.  In the following example using NOTEPAD, the application is in the PATH
  421. ; and the directory is the installation directory so the command line parameter
  422. ; is relative to the installation directory.
  423. ; The format is as follows:           
  424.  
  425. ;       EXECUTABLE FILENAME, DELETE FLAG (YES/NO)
  426. [ExtCmds]
  427. ;       #D\SUB\SFX.EXE, YES
  428. ;       "#D\FRAG.EXE d #D\TEST #D\sub 0", YES   ; Test Fragger
  429. ;       "NOTEPAD.EXE #V\BOOTLOG.TXT", NO
  430.  
  431. ; -------------------------------------------------------------
  432. ; *************************************************************
  433. ; -------------------------------------------------------------
  434. ; *************************************************************
  435. ; -------------------------------------------------------------
  436. ; OPTIONS
  437. ; -------------------------------------------------------------
  438. ; *************************************************************
  439. ; -------------------------------------------------------------
  440. ; This section allows for the customization of several InstallWare functions.
  441. ; The format is as follows:           
  442. ;       OPTION, FLAG (YES/NO)                                        
  443.  
  444. [Options]
  445.     Logging, YES        ; If this option is set to YES, then a log file will
  446.                         ; be created, detailing the installation.
  447.     DirChg, yes             ; If this option is set to NO, the Install directory
  448.                         ; editbox will not be displayed
  449.  
  450.     OverWrite, NO           ; This option determines what the default setting of
  451.                         ; of the OverWrite radio buttons will be.
  452.  
  453.  
  454. ;-----ReBoot/ReStart Section------
  455. ; Make sure you enable ONLY one of
  456. ; these options. If bother are enabled,
  457. ; a ReBoot will occur automatically.
  458.  
  459.     Restart, NO                ; If this option is set to YES, the user will be
  460.                     ; prompted to restart Windows.  If set to NO, it will
  461.                     ; just happen (the developer should warn about this
  462.                     ; at the beginning of the install).  If the field is not
  463.                     ; present, then no restart will occur.
  464.  
  465. ;    Reboot, YES                        ; If this option is set to YES, the user will be
  466.                     ; prompted to reboot the system.  If set to NO, it will
  467.                     ; just happen (the developer should warn about this
  468.                     ; at the beginning of the install).  If the field is not
  469.                     ; present, then no reboot will occur.
  470.  
  471.     RestartString, "The system must be rebooted/restarted for all changes to take effect.  Would you like to do this now?"
  472.                         ; This field MUST be present if you use either of the
  473.                         ; reboot/restart fields.                                        
  474.  
  475.     DeleteIW, NO            ; Due to SHARE problems on some systems, you might want 
  476.                         ; to leave IW.EXE on the target system.  To do so, set
  477.                         ; this option to NO (i.e. don't delete it)  Note that
  478.                         ; this is not an issue with single disk installations.
  479.     
  480.  
  481. ; -------------------------------------------------------------
  482. ; *************************************************************
  483. ; -------------------------------------------------------------
  484. ; *************************************************************
  485. ; -------------------------------------------------------------
  486. ; WINDOW
  487. ; -------------------------------------------------------------
  488. ; *************************************************************
  489. ; -------------------------------------------------------------
  490. ; This section allows for describing the InstallWare backdrop window.
  491. ; The format is different for each field.           
  492.  
  493. [Window]
  494.     Focus, YES               ;If set to YES, the window stays on top,
  495.                     ;keeping the user focused on the installation.
  496.  
  497.     Show, YES               ;If set to YES, the backdrop window is shown
  498.                     ;Otherwise, it is not and all other vars are ignored.
  499.                     
  500.     Style, FULL     ;If set to FULL, no caption is displayed.                                   
  501.                     
  502.     Color, BLUE      ;Options are gradients of RED, GREEN, and 
  503.                     ;BLUE (which is the default)
  504.  
  505.     Message, "InstallWare 4.1!"     ;This message is shown in the window    
  506.     Caption, "This is the InstallWare Demo" ;This message is shown in 
  507.                                             ;the caption of the window 
  508.                                             ;if it not set to FULL
  509.                                             
  510.     MessageLoc, TOP ;Location of the Message string: TOP or BOTTOM
  511.