The customization setup file (Customizable\csetup.ini) performs two functions:
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
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
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_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.
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.
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.
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.
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.
Copyright © SoftQuad Software Inc. 1999