"NANIKA"
Documents - INSTALL/*.* -

Abstract
If you make your *.lzh or *.zip archive of your distribution file with the suitable configuration, your archive will be able to install itself only by drug and drop on the embryo.
Caution
The extractor of *.lzh and *.zip archive is not implemented on the embryo itself, because there are little merit.
The feature of INSTALL/*.* spec depend on the unlha32 or unzip32 freeware extractor. If these files don't exist, you can't use this feature. (It returns failure status codes.)
INSTALL/1.0
The "INSTALL/1.0" is specified to make a basic install procedure.
The archives defined in INSTALL/1.0 spec are basically simple *.lzh or *.zip archives, but particularly, they includes the "install.txt" files in their root directory. The embryo copies and configures the contents of archive based on the "install.txt."
  • install.txt
    type,ghost
directory,naru
The "type" entry is the type of the file set. You can set following three types into this entry, ghost, balloon, and plugin. You must set the appropriate type for your archive.

The "directory" entry is the name of the directory which is made by their file set. If the directory name conflicts with the existing one, it will overwrite them without confirmation.

The archived files extract into the individual directory directed by "directory" entry, under system directory directed by "type" entry. And if necessary, the directory for archives is created independently. In occasion of an example shown above, the actual directory which the archive is extracted into is as follows.
home\ghost\naru\
Therefore, the files in archive are basically placed into the directory tree shown as follows. 
+-ghost
   +-master
      +-....
   +-slave0
      +-....
+-shell
   +-master
      +-....
   +-80%
      +-....
install.txt
INSTALL/1.2
The "INSTALL/1.2" is specified to install the ghost/shell with balloons.
home
 +-ghost
    +-master
 +-shell
    +-master
 +-clover note
    +-descript.txt
    +-balloons0.png
    +-....
    +-..
 install.txt
  • install.txt
    type,ghost
directory,naru

balloon.directory,clover note
If you place the balloon files to the home directory of your ghost with master data, and put the directory name of balloon file into "balloon name" entry, your ghost package becomes according to "with balloon" spec.

The ghost installed according to "with balloon" spec is start with the balloon which is installed with the ghost at same time, not with the default balloon.
INSTALL/1.3
The "INSTALL/1.3" is specified to install additional files or archives to the individual ghost. These archives are especially called "supplement".
  • install.txt
    type,supplement
accept,Naru
name,surface80%
script,\h\s[0]Install process of the additional surface, \n\n(%lastobjectname)\n\n, is completed successfully.\w8\n How slim I am in tiny place, don't me? \w8\u....\w8\w8How dull of my life. Huh! \e
The "accept" entry is the name of the ghost to accept this file. Another ghosts that are not designated in this entry, can not accept this file. (Installation process is denied by other ghosts.)

The "name" entry is the name of additional object. This value put into the environmental parameter named "%lastobjectname".

The "script" entry is the script to play after installation completion.

The "supplement" shell archive is extracted under the home directory (designated by "accept" entry) of the ghost that is realizing now. In occasion of an example shown above, the actual directory which the archive is extracted into is as follows. 
home\ghost\naru\
Therefore, the files in archive are actually placed into the same directory tree as the normal ghost package archives. An example of directory tree after installing "supplement" archive is as follows. 
+-ghost
   +-master
      +-....
   +-slave0
      +-....
+-shell
   +-master
      +-....
   +-80%
      +-....
install.txt
The additional supplement file must be one type at each installation, but the updates of the master data, the slave ghost data, or the additional shell data are also available for the supplement data.

Following are related environmental parameter with the INSTALL/1.3 spec.

%lastghostname
%lastobjectname
The ghost name which processed the last event request puts into the "%lastghostname" environmental parameter. This parameter uses in case of failure, not uses when the install process is completed successfully. (An example of usage in the "script" entry, "Please give %lastghostname".) In the same way, the object name which processed the last event request puts into the "%lastobjectname" environmental parameter. In this occasion, the value "80%serface" is put into this parameter.
return to homepage
This page is based on phase 102.00 (2001/09/01)
This page was translated by:Hiro with SERIKO
Published by:Yoshiyuki.Sakakibara