home *** CD-ROM | disk | FTP | other *** search
INI File | 1990-07-04 | 12.1 KB | 288 lines |
- ; About This File
- ; ===============
- ;
- ; This file, APPSETUP.INF, contains information that Install uses to
- ; install applications. This file must be in the same directory as the
- ; program file INSTALL.EXE. The two files can be on a floppy disk, a hard
- ; disk, or a network disk drive.
- ;
- ; The information in this file determines
- ;
- ; * The names of the disks and directories from which, and to which, Install
- ; copies files
- ;
- ; * The name of the group that Install creates in Program Manager's window, and the
- ; names of program items that Install adds to that group
- ;
- ; You can create your own Install program by changing some of the information
- ; in this file.
- ;
- ; The Parts of APPSETUP.INF
- ; -------------------------
- ;
- ; APPSETUP.INF is similar in format to a Windows initialization (.INI) file.
- ;
- ; Sections: APPSETUP.INF is divided into sections. Each section is identified by an
- ; alphanumeric name enclosed in square brackets.
- ;
- ; Most section names are "hard-coded": Install is written to search for
- ; in APPSETUP.INF for that specific section name. However, some section
- ; names are defined within other sections, and are therefore easily
- ; customizable.
- ;
- ; Comments: A comment begins with a semicolon. You can include a comment
- ; on the same line as syntax, as long as it comes after the syntax.
- ;
- ; Spaces: Spaces are ignored, except when between double quotes.
- ; Blank lines are also ignored.
- ;
- ; Sections in This File
- ; ---------------------
- ;
- ; The rest of this file contains the actual sections and statements
- ; that make up the working file. It also includes comments that
- ; explain each section and statement.
- ;
-
- [dialog]
- ; The [dialog] section contains information pertaining to Install's dialog box.
- ;
- ; The Caption statement determines the text that appears in the title bar
- ; of Install's dialog box.
- ;
- ; The following Caption statement specifies the caption "Demo App Installation".
- ; To specify your own caption, replace the text "Demo App Installation" with the
- ; title you want (enclosed in double quotes).
-
- caption = "Demo App Installation"
-
- [data]
- ; The [data] section includes information about the location to which the
- ; application's files should be copied.
- ;
- ; The Defdir statement specifies the default directory for installing the
- ; application. This is the drive and directory name that will appear in the
- ; Install dialog box. The user can specify a different installation directory
- ; by typing a different name. (The Defdir statement MUST include a drive letter.)
- ;
- ; The following Defdir statement tells Install to display the default directory
- ; C:\DEMOAPP when asking the user where to install the application.
- ; To specify your own default directory, replace the text C:\DEMOAPP with
- ; the drive and directory you want.
-
- defdir = C:\DEMOAPP
-
- [disks]
- ; The [disks] section defines the distribution disks that contain the application
- ; files. Install uses this information to tell the user to insert the correct disk.
- ;
- ; Elsewhere within this .INF file, the distribution disks are normally referred to
- ; by a single-character disk ID. This section defines those disk IDs, and includes
- ; information about the disk to which each disk ID refers.
- ;
- ; The disk ID '0' is reserved; it represents the installation directory --
- ; the directory in which the user is installing the application.
- ;
- ; The format of each disk definition is:
- ;
- ; n = path, title
- ;
- ; where
- ; n is the disk ID (a single character from 1-9 or A-Z).
- ;
- ; path the path of the source directory from which Install should copy
- ; the files to the disk The path can be relative to the
- ; source directory (see examples below).
- ;
- ; title is a descriptive name for the disk. The title should match
- ; the disk's printed or written label exactly.
- ;
- ; The following disk-definition statements define two distribution disks.
-
- 1 =., "Demo Application Disk 1"
- 2 =.\files, "Demo Application Disk 2"
-
- ; The first statement tells Install to refer to Disk 1 as "Demo Application
- ; Disk 1". Because the period (.) denotes the current directory, the files
- ; on that disk will be copied from the root directory of the
- ; distribution disk.
- ;
- ; The second statement tells Install to refer to Disk 2 as "Demo Application
- ; Disk 2"; the files that Disk 2 contains will be copied from the \FILES
- ; directory of the distribution disk.
- ;
- ; You can include as many disk-definition statements as necessary. Every
- ; distribution disk should have a corresponding disk-definition statement;
- ; otherwise, Install cannot tell the user to insert the appropriate disk.
-
- [needed.space]
- ; The [needed.space] section defines how much disk space, in bytes, your
- ; application files require. If the specified amount of space is not available,
- ; Install will ask the user to specify a different hard disk, or exit Install.
- ; The following statement tells Install that this application requires 300KB of disk
- ; space:
- ;
- minspace = 300000
- ;
- [app.copy.appstuff]
-
- ; The [app.copy.appstuff] section contains section-definition statements.
- ; Each statement defines a section that lists application files to be
- ; copied as part of installation. The sections are organized by file
- ; destination; you should define a separate section for each destination
- ; directory.
- ;
- ; Each section definition has the following form:
- ;
- ; #section_name, 0:dest_pathname
- ;
- ; where
- ;
- ; #section_name defines the name of the .INF section that lists the
- ; files to be copied.
- ; 0 is the disk ID that represents the installation directory.
- ; (0 is a reserved disk ID, and always represents the
- ; installation directory -- the directory the user specified
- ; when asked where to install the application.)
- ; dest_pathname is the pathname of the destination directory, relative
- ; to the installation directory. For example, "0:FILES"
- ; represents the FILES subdirectory of the installation
- ; directory.
- ;
- ; The following section-definition statements define two sections, [app.user]
- ; and [app.system]. The files listed in the [app.user] section will be copied
- ; into the installation directory; those listed in the [app.system] directory
- ; will be copied into the SYSTEM subdirectory of the installation directory.
-
- #app.user, 0:
- #app.system , 0:system
-
- [app.user]
- ; This section is a user-defined section that lists files to be copied to a
- ; particular destination directory. The [app.copy.appstuff] section defines.
- ; the name of this section and the destination directory of the files.
- ;
- ; In each section like this one, you should list all files that you want copied
- ; to the same destination. (For example, all the files in this section, [app.user],
- ; will be copied to the installation directory.)
- ;
- ; Install copies the files listed in this section in the order in which they
- ; are listed.
- ;
- ; The syntax of each file listing is
- ;
- ; N:FILENAME, "Description"
- ;
- ; where
- ;
- ; N: is the disk ID of the disk that contains the file. (Disk IDs
- ; are defined in the [disks] section.) If the specified disk
- ; is not in the disk drive, Install prompts the user to insert it.
- ;
- ; FILENAME is the name of the file, including the filename extension, if any.
- ;
- ; Description is descriptive text that Install displays as it is copying
- ; the file or group of files. If you leave the description blank,
- ; Install will continue displaying the descriptive text from the
- ; previous file. This lets you use a general name for a group of files.
- ;
- ; For example, the first statement below tells Install to copy the file FILE1.FOO from
- ; Disk 1, and to display the descriptive text "Demo App" while copying that file. As
- ; explained above, the destination of the files in this section is determined by a
- ; section-definition statement in the [app.copy.appstuff] section.
-
- 1:file1.foo, "Demo App"
- 1:file2.foo, "Demo App Help"
- 1:file3.foo, "Frogs Demo"
- 1:demo.ico, "Demo Icon"
- 2:file4.foo, "Elephants Demo"
-
- [app.system]
- ; Like the [app.user] section, this section is user-defined, and lists
- ; files to be copied to a particular destination directory. The
- ; [app.copy.appstuff] section defines.the name of this section and the
- ; destination directory of the files listed in this section.
- ; See the preceding section for a description of the syntax for listing
- ; files.
-
- 2:driver1.foo, "Demo App Drivers"
- 2:driver2.foo
-
-
- [progman.groups]
- ; The [progman.groups] section (optional) tells Install to create Program
- ; Manager groups for your application. (Install then uses DDE to communicate
- ; with Program Manager.)
- ;
- ; The section lists the names of the groups you want to create. You then
- ; define additional sections in this file; those sections list the program
- ; items you want in each group.
- ;
- ; The syntax for each group name is:
- ;
- ; groupname, [groupfile.grp]
- ;
- ; where
- ;
- ; groupname is the title you want Program Manager to display
- ; under the icon that represents the group. (The
- ; groupname will also be the name of the section
- ; that defines the contents of the group.)
- ;
- ; groupfile.grp is the filename of the file in which Program Manager
- ; will save information about the group. (You must include
- ; the .GRP filename extension.) This parameter is optional;
- ; if you omit it, Install uses a default name for the
- ; group file.
- ;
- ; The following group-definition statement tells Install to create a group named
- ; Demo, and store its information in a file named DEMO_APP.GRP. The [demo] section
- ; will contain information about the group's contents.
-
- Demo,demo_app.grp
-
- [Demo]
- ; This section is a user-defined section that define the contents of a
- ; Program Manager group file. The [progman.groups] section defines.
- ; the name of this section and the group, and the name of the file in which
- ; to store information about the group.
- ;
- ; In each section like this one, you should list all items that you want Install
- ; to add to the group.
- ;
- ; The syntax for item-definition statements is:
- ;
- ; "Description", APPFILE.EXE, [ICONFILE.EXE[, N]]
- ;
- ;where
- ;
- ; Description is the text that will appear below the program icon
- ; when displayed in the Program Manager group.
- ;
- ; APPFILE.EXE is the command line that starts the application.
- ;
- ; ICONFILE.EXE is the application file that contains the icon you
- ; want to represent the application. Typically, this is
- ; the executable application file, but it could be a
- ; different file. (You can also specify a .ICO file, created
- ; using the SDKPaint tool.) This parameter is optional; if you omit it,
- ; Install will use the first icon it finds in APPFILE.EXE.
- ;
- ; N is the offset of the icon you want to use within the file
- ; ICONFILE.EXE. This parameter is optional; if you omit it,
- ; Install uses the first icon it finds in ICONFILE.EXE.
- ; You must include this parameter if the file you specify
- ; contains more than one icon, and you want to use an icon
- ; other than the first icon.
- ;
- ; To use the Nth icon, specify the number N-1. For example,
- ; to use the third icon, specify 2.
- ;
- ; For example, the following item-definition statement tells Install to add an item
- ; titled "Demo Application" to Program Manager. The application command line
- ; is FILE1.FOO; the file that contains the application icon is DEMO.ICO
-
- "Demo Application", file1.foo, demo.ico
- "Samples", file2.foo, demo.ico
-
-