The customization setup (csetup.ini) file

The customization setup file (Customizable\csetup.ini) performs two functions:

  1. It tells the HoTMetaL PRO installer the size of each customizable folder, so that the installer can calculate if the user's hard disk contains enough space.
  2. For DLLs in the customizable Dlls folder, it indicates install locations and registration information.

Folder sizes

The csetup.ini file indicates the size of each customizable folder; it is important that the size you enter accurately reflects how much space is needed at installation time by each of these components. (Note that Windows file system cluster sizes can increase the amount of space needed.)

This information must be entered in the [sizes] section of the csetup.ini file. The supplied value for each folder is the total size in bytes of the files in that folder. If a setting is commented out (by starting the line with a `#') or set to 0 (zero), its value is not used at install time. The folder name must be written exactly as specified in the Customizable folders section.

Here is a group of sample settings:

[sizes] 
# Setting format: folder_name=value 
Dlls=29444000 
Asset Templates=64000 
Assets=336000 
 
Display=12000 
Macros=44000 
Progguide=980000 
Rules=380000 
 
Template=28000 
#Top=0

DLLs

The Customizable\csetup.ini file provides up to five pieces of information about each DLL:

This information is contained in five variables, which have the names dll_name_N, dll_destination_N, dll_mustinstall_N, dll_register_N, and dll_component_N. N is the (arbitrary) number of the DLL. These settings must be in the [dlls] section of the csetup.ini file.

For example:

[dlls] 
dll_name_1=address.dll 
dll_destination_1=SQDIR\Samples\Installed 
dll_register_1=SELFREGISTER 
dll_mustinstall_1=YES 
dll_component_1=Samples

dll_name

The dll_name_N variable must be set. The HoTMetaL PRO installer will look for the specified DLL in the Dlls folder and install it. A DLL that exists in the Dlls folder but does not have a dll_name_N entry will not be installed.

dll_destination

dll_destination_N is the folder into which the corresponding DLL will be installed. If the specified folder does not exist, it will be created. The folder can be a full path (including the drive letter) or it can consist of one of the following system variables:

The specified folder cannot be a relative path.

dll_register

If dll_register_N has the value SELFREGISTER, then the HoTMetaL PRO installer will enable the DLL to register itself. If the variable has any other value or is not set, the DLL is assumed to not require registration, and no special action will be taken by the installer. If you specify SELFREGISTER and the DLL is not a self-registering DLL, the installation will fail.

dll_mustinstall

If dll_mustinstall_N has the value YES or is not set, then the corresponding DLL will be installed. If it has the value NO, then during the HoTMetaL PRO installation a dialog box will be displayed, asking the end user if optional DLLs should be installed. If the user answers Yes, then this DLL and all other optional DLLs will be installed. The text in this dialog box can be configured; see Optional DLL dialog below.

dll_component

The dll_component_N variable can specify one of the other customizable folders; if that folder is not selected by the user at install time, then this DLL will not be installed. The component folder name must be written exactly as specified in the Customizable folders section.

Optional DLL dialog

If one or more DLLs have the dll_mustinstall_N variable set to NO, then the `optional DLL dialog' will appear exactly once during the HoTMetaL PRO installation, asking the user if all optional DLLs should be installed. Yes and No are the only choices; users cannot pick individual optional DLLs.


Left arrow
Previous Topic
Table of contents
Table of Contents

Copyright © SoftQuad Software Inc. 1999