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