home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / PROGRAM / C / INST / DEMO.INF < prev    next >
INI File  |  1993-12-01  |  12KB  |  288 lines

  1. ; About This File
  2. ; ===============
  3. ;
  4. ; This file, APPSETUP.INF, contains information that Install uses to 
  5. ; install applications. This file must be in the same directory as the 
  6. ; program file INSTALL.EXE. The two files can be on a floppy disk, a hard 
  7. ; disk, or a network disk drive.
  8. ;
  9. ; The information in this file determines
  10. ;   * The names of the disks and directories from which, and to which, Install
  11. ;     copies files
  12. ;
  13. ;   * The name of the group that Install creates in Program Manager's window, and the
  14. ;     names of program items that Install adds to that group
  15. ;
  16. ; You can create your own Install program by changing some of the information
  17. ; in this file.
  18. ;
  19. ; The Parts of APPSETUP.INF
  20. ; -------------------------
  21. ;
  22. ; APPSETUP.INF is similar in format to a Windows initialization (.INI) file.
  23. ;
  24. ; Sections: APPSETUP.INF is divided     into sections. Each section is identified by an     
  25. ;           alphanumeric name enclosed in square brackets.
  26. ;
  27. ;           Most section names are "hard-coded": Install is written to search for
  28. ;           in APPSETUP.INF for that specific section name. However, some section
  29.  ;          names are defined within other sections, and are therefore easily 
  30. ;           customizable.
  31. ;
  32. ; Comments: A comment begins with a semicolon. You can include a comment 
  33. ;           on the same line as syntax, as long as it comes after the syntax.
  34. ; Spaces:   Spaces are ignored, except when between double quotes.
  35. ;           Blank lines are also ignored.
  36. ;
  37. ; Sections in This File
  38. ; ---------------------
  39. ; The rest of this file contains the actual sections and statements
  40. ; that make up the working file. It also includes comments that 
  41. ; explain each section and statement.
  42. ;
  43.  
  44. [dialog]
  45. ; The [dialog] section contains information pertaining to Install's dialog box. 
  46. ;
  47. ; The Caption statement determines the text that appears in the title bar 
  48. ; of Install's dialog box. 
  49. ;
  50. ; The following Caption statement specifies the caption "Demo App Installation".
  51. ; To specify your own caption, replace the text "Demo App Installation" with the 
  52. ; title you want (enclosed in double quotes).
  53.  
  54.   caption = "Demo App Installation"
  55.  
  56. [data]
  57. ; The [data] section includes information about the location to which the 
  58. ; application's files should be copied.
  59. ;
  60. ; The Defdir statement specifies the default directory for installing the 
  61. ; application. This is the drive and directory name that will appear in the
  62. ; Install dialog box. The user can specify a different installation directory 
  63. ; by typing a different name. (The Defdir statement MUST include a drive letter.) 
  64. ;
  65. ; The following Defdir statement tells Install to display the default directory 
  66. ; C:\DEMOAPP when asking the user where to install the application.
  67. ; To specify your own default directory, replace the text C:\DEMOAPP with
  68. ; the drive and directory you want.
  69.  
  70.   defdir = C:\DEMOAPP
  71.  
  72. [disks]
  73. ; The [disks] section defines the distribution disks that contain the application 
  74. ; files. Install uses this information to tell the user to insert the correct disk.
  75. ; Elsewhere within this .INF file, the distribution disks are normally referred to
  76. ; by a single-character disk ID. This section defines those disk IDs, and includes 
  77. ; information about the disk to which each disk ID refers.
  78. ;
  79. ; The disk ID '0' is reserved; it represents the installation directory -- 
  80. ; the directory in which the user is installing the application. 
  81. ;
  82. ; The format of each disk definition is:
  83. ;     n = path, title
  84. ;
  85. ;  where
  86. ;     n       is the disk ID (a single character from 1-9 or A-Z). 
  87. ;
  88. ;     path    the path of the source directory from which Install should copy 
  89. ;             the files to the disk  The path can be relative to the
  90. ;             source directory (see examples below).
  91. ;
  92. ;     title   is a descriptive name for the disk. The title should match 
  93. ;             the disk's printed or written label exactly.
  94. ; The following disk-definition statements define two distribution disks.
  95.  
  96.   1 =.,        "Demo Application Disk 1"
  97.   2 =.\files,  "Demo Application Disk 2"
  98.  
  99. ; The first statement tells Install to refer to Disk 1 as "Demo Application 
  100. ; Disk 1". Because the period (.) denotes the current directory, the files 
  101. ; on that disk will be copied from the root directory of the
  102. ; distribution disk. 
  103. ;
  104. ; The second statement tells Install to refer to Disk 2 as "Demo Application 
  105. ; Disk 2"; the files that Disk 2 contains will be copied from the \FILES 
  106. ; directory of the distribution disk.
  107. ;
  108. ; You can include as many disk-definition statements as necessary. Every 
  109. ; distribution disk should have a corresponding disk-definition statement;
  110. ; otherwise, Install cannot tell the user to insert the appropriate disk.
  111.  
  112. [needed.space]
  113. ; The [needed.space] section defines how much disk space, in bytes, your 
  114. ; application files require. If the specified amount of space is not available,
  115. ; Install will ask the user to specify a different hard disk, or exit Install.
  116. ; The following statement tells Install that this application requires 300KB of disk
  117. ; space:
  118. ;
  119.   minspace = 300000
  120. ;
  121. [app.copy.appstuff]
  122.  
  123. ; The [app.copy.appstuff] section contains section-definition statements.
  124. ; Each statement defines a section that lists application files to be
  125. ; copied as part of installation. The sections are organized by file 
  126. ; destination; you should define a separate section for each destination 
  127. ; directory. 
  128. ;
  129. ; Each section definition has the following form:
  130. ;
  131. ;     #section_name, 0:dest_pathname
  132. ;
  133. ; where
  134. ;
  135. ;     #section_name   defines the name of the .INF section that lists the
  136. ;                     files to be copied.
  137. ;     0                   is the disk ID that represents the installation directory.
  138. ;                     (0 is a reserved disk ID, and always represents the
  139. ;                     installation directory -- the directory the user specified
  140. ;                     when asked where to install the application.)
  141. ;     dest_pathname   is the pathname of the destination directory, relative 
  142. ;                     to the installation directory. For example, "0:FILES"
  143. ;                     represents the FILES subdirectory of the installation 
  144. ;                     directory.
  145. ;
  146. ; The following section-definition statements define two sections, [app.user]
  147. ; and [app.system]. The files listed in the [app.user] section will be copied
  148. ; into the installation directory; those listed in the [app.system] directory
  149. ; will be copied into the SYSTEM subdirectory of the installation directory.
  150.  
  151.       #app.user,    0:
  152.       #app.system , 0:system
  153.  
  154. [app.user]
  155. ; This section is a user-defined section that lists files to be copied to a
  156. ; particular destination directory. The [app.copy.appstuff] section defines.
  157. ; the name of this section and the destination directory of the files.
  158. ;
  159. ; In each section like this one, you should list all files that you want copied
  160. ; to the same destination. (For example, all the files in this section, [app.user],
  161. ; will be copied to the installation directory.)
  162. ;
  163. ; Install copies the files listed in this section in the order in which they
  164. ; are listed. 
  165. ;
  166. ; The syntax of each file listing is
  167. ;
  168. ;     N:FILENAME, "Description"
  169. ;
  170. ; where
  171. ;
  172. ;     N:           is the disk ID of the disk that contains the file. (Disk IDs
  173. ;                  are defined in the [disks] section.) If the specified disk 
  174. ;                  is not in the disk drive, Install prompts the user to insert it.
  175. ;       
  176. ;     FILENAME     is the name of the file, including the filename extension, if any.
  177. ;
  178. ;     Description  is descriptive text that Install displays as it is copying
  179. ;                  the file or group of files.  If you leave the description blank,
  180. ;                  Install will continue displaying the descriptive text from the 
  181. ;                  previous file. This lets you use a general name for a group of files.
  182. ;
  183. ; For example, the first statement below tells Install to copy the file FILE1.FOO from 
  184. ; Disk 1, and to display the descriptive text "Demo App" while copying that file. As
  185. ; explained above, the destination of the files in this section is determined by a 
  186. ; section-definition statement in the [app.copy.appstuff] section.
  187.  
  188.   1:file1.foo, "Demo App"
  189.   1:file2.foo, "Demo App Help"
  190.   1:file3.foo, "Frogs Demo"
  191.   1:demo.ico, "Demo Icon"
  192.   2:file4.foo, "Elephants Demo"
  193.  
  194. [app.system]
  195. ; Like the [app.user] section, this section is user-defined, and lists 
  196. ; files to be copied to a particular destination directory. The 
  197. ; [app.copy.appstuff] section defines.the name of this section and the 
  198. ; destination directory of the files listed in this section.
  199. ; See the preceding section for a description of the syntax for listing
  200. ; files.
  201.  
  202.   2:driver1.foo, "Demo App Drivers"
  203.   2:driver2.foo
  204.  
  205.  
  206. [progman.groups]
  207. ; The [progman.groups] section (optional) tells Install to create Program 
  208. ; Manager groups for your application. (Install then uses DDE to communicate 
  209. ; with Program Manager.)
  210. ;
  211. ; The section lists the names of the groups you want to create. You then 
  212. ; define additional sections in this file; those sections list the program 
  213. ; items you want in each group.
  214. ;
  215. ; The syntax for each group name is:
  216. ;
  217. ;     groupname, [groupfile.grp]
  218. ;
  219. ; where
  220. ;
  221. ;     groupname      is the title you want Program Manager to display
  222. ;                    under the icon that represents the group. (The 
  223. ;                    groupname will also be the name of the section
  224. ;                    that defines the contents of the group.)
  225. ;
  226. ;     groupfile.grp  is the filename of the file in which Program Manager
  227. ;                    will save information about the group. (You must include
  228. ;                    the .GRP filename extension.) This parameter is optional;
  229. ;                    if you omit it, Install uses a default name for the 
  230. ;                    group file.
  231. ;
  232. ; The following group-definition statement tells Install to create a group named
  233. ; Demo, and store its information in a file named DEMO_APP.GRP. The [demo] section
  234. ; will contain information about the group's contents.
  235.  
  236.   Demo,demo_app.grp
  237.  
  238. [Demo]
  239. ; This section is a user-defined section that define the contents of a 
  240. ; Program Manager group file. The [progman.groups] section defines.
  241. ; the name of this section and the group, and the name of the file in which
  242. ; to store information about the group.
  243. ;
  244. ; In each section like this one, you should list all items that you want Install
  245. ; to add to the group.
  246. ;
  247. ; The syntax for item-definition statements is: 
  248. ;
  249. ;     "Description",    APPFILE.EXE, [ICONFILE.EXE[, N]]
  250. ;
  251. ;where
  252. ;
  253. ;     Description   is the text that will appear below the program icon 
  254. ;                   when displayed in the Program Manager group. 
  255. ;
  256. ;     APPFILE.EXE   is the command line that starts the application.
  257. ;     
  258. ;     ICONFILE.EXE  is the application file that contains the icon you
  259. ;                   want to represent the application. Typically, this is 
  260. ;                   the executable application file, but it could be a 
  261. ;                   different file. (You can also specify a .ICO file, created
  262. ;                   using the SDKPaint tool.) This parameter is optional; if you omit it,
  263. ;                   Install will use the first icon it finds in APPFILE.EXE. 
  264. ;
  265. ;     N             is the offset of the icon you want to use within the file
  266. ;                   ICONFILE.EXE.  This parameter is optional; if you omit it, 
  267. ;                   Install uses the first icon it finds in ICONFILE.EXE.
  268. ;                   You must include this parameter if the file you specify
  269. ;                   contains more than one icon, and you want to use an icon
  270. ;                   other than the first icon. 
  271. ;
  272. ;                   To use the Nth icon, specify the number N-1. For example,
  273. ;                   to use the third icon, specify 2.
  274. ;
  275. ; For example, the following item-definition statement tells Install to add an item
  276. ; titled "Demo Application" to Program Manager. The application command line
  277. ; is FILE1.FOO; the file that contains the application icon is DEMO.ICO
  278.     
  279. "Demo Application", file1.foo, demo.ico
  280. "Samples", file2.foo, demo.ico
  281.  
  282.