home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 July / CMCD0704.ISO / Software / Complet / FreeDOS / fdbootcd.iso / FREEDOS / PACKAGES / BASE / DISK03 / CHANGEX.ZIP / INSTALL.TXT < prev   
Text File  |  2003-09-15  |  10KB  |  235 lines
  1. Graphical FreeDOS installer v2.1-GR
  2.  
  3. What's new:
  4.  + Bugs fixed. Now we ignore configuration errors.
  5.  + Some switches added.
  6.  + Support for *.ini files to configure packages added
  7.    and updating fdauto.bat and fdconfig.sys according
  8.    to the settings in *.ini files and freedos.ini file.
  9.  + Installer creates directory INSTBASE and has
  10.    a possibility to uninstall packages (update FreeDOS installation)
  11.    using switch /change
  12.  + Installer sets the variable fdosdir (that indicates
  13.    destination directory) and adds it to fdauto.bat
  14.  
  15. Copyright (c) 2003  Sergey Kozlovich (Riga, Latvia - GMT+2).
  16. e-mail (English/Russian/Latvian):
  17.         kozlovichREMOVE_THIS@inbox.lv
  18.         sergey_kozlovich@hotmail.com
  19.  
  20.  
  21. Compiled by FreePASCAL installer doesn't more require any
  22. images or fonts - they are linked into *.exe file.
  23.  
  24. Uses library GUI (also by Sergey Kozlovich)
  25. to provide Graphical User Interface.
  26. GUI can be downloaded from:
  27.   artificial.times.lv/gui
  28.   creative.cool.lv/gui
  29.  
  30. To compile do these steps:
  31. --------------------------
  32.   - FreePascal should be installed and should be accessible from
  33.     the PATH variable;
  34.   - if gui\ subdirectory doesn't exist in this archive,
  35.       download gui from one of the sites above and
  36.       extract the archive to the directory where the sources
  37.       of installer are located (this will make a subdirectory gui);
  38.   - run build_fp.bat or make_fp.bat
  39.  
  40. What is necessary to run installer:
  41. -----------------------------------
  42.  o install.exe (may be compressed with UPX or PKLITE)
  43.  o textinst.exe (default text-mode installer; you may redefine it using
  44.                  switches - see below)
  45.  o licence.txt
  46.  o mouse driver loaded (ctmouse2.exe works fine)
  47.  o if it adviced to load disk bufferring software (e.g. SMARTDRV)
  48.    and/or to specify BUFFERS=50 in fdconfig.sys
  49.  o files install.dat and install.min must be in the current directory
  50.    and the directory EN\ with descriptions of disks should
  51.    also be there;
  52.  o *.lsm files that are used to show information about package
  53.    to user when he/she is seleceting packages to install
  54.    (if *.lsm file is not found user may not know what does the
  55.    package stay for and does he/she need it);
  56.  
  57.    if you install from CD, all *.lsm files can be read and we can
  58.    get info about all the packages; but installing from floppies
  59.    we can't do that becase *.lsm files are situated on different
  60.    floppies; I recommend to use lsm.exe program (call it with
  61.    one parameter that is a directory with packages). This program
  62.    will search recursively for *.lsm files and will create
  63.    lsm.ini file containing information about packages;
  64.  
  65.    Now, if graphical installer won't find *.lsm file, it can
  66.    get info from lsm.ini file;
  67.  
  68.    lsm.ini file can be situated in the current directory (where
  69.    install.exe is located) or in the directory with packages
  70.    
  71.    if you are installing from floppies, we can put lsm.ini to the
  72.    first floppy: and we can get info about ALL the packages!
  73.  
  74. Optional for Graphical installer (not supported by standart text-installer):
  75. ----------------------------------------------------------------------------
  76.  o freedos.ini file in current directory (where install.exe is located)
  77.    or in the directory where packages are located (source path)
  78.  
  79.    see the default freedos.ini for example
  80.  
  81.    !!! graphical installer can modify files fdauto.bat and fdconfig.sys;
  82.    it uses keys FDAUTO1=..., FDAUTO2=..., etc. and
  83.    FDCONFIG1=..., FDCONFIG2=..., etc.  from freedos.ini
  84.    to add lines to fdauto.bat and fdconfig.sys;
  85.  
  86.    So, if you use graphical installer, please, do not
  87.    re-create fdauto.bat and fdconfig.sys files. The best solution,
  88.    I think, is to check if graphical installer was used
  89.    (i.e. if variable "%GUI_inst%"=="true" or
  90.     %fdosdir%\instbase\freedos.log file exists)
  91.    then we don't create fdauto.bat and fdconfig.sys,
  92.    otherwise, we do.
  93.  
  94.    You can specify configuration files using AUTOFILE=... and CFGFILE=...
  95.    parameters in freedos.ini.
  96.  
  97.    You can call a command after the install has finished;
  98.    set this option using POSTINSTALL=... parameter in file
  99.    freedos.ini.
  100.  
  101.    This will work also to other packages that need post-install (e.g. seal).
  102.    Set this option in file <package>.ini (see below).
  103.  
  104.    Post-install commands are added to the queue, and executed after GUI has
  105.    finished. The first command is that was specified in file freedos.ini.
  106.  
  107.  
  108.  o <package>.ini file; not required for each package, but is
  109.    useful for packages that need to add paths/environment variables
  110.    or to add some strings to fdauto.bat/fdconfig.sys
  111.  
  112.    some of the packages is better to install to a specified folder
  113.    (not the default like C:\FDOS), e.g. DJGPP may be installed
  114.    in D:\DJGPP and not in C:\FDOS\DJGPP.
  115.    you may also specify the default destination directory
  116.    in file <package>.ini
  117.  
  118.    Example:
  119.  
  120.    you have to use a special configuration for package DJGPP
  121.    (i.e. to install DJGPP to a separate directory and set up
  122.    variable DJDIR in fdauto.bat)
  123.  
  124.    create a file called djgpp214.ini (if zip-file is djgpp214.zip)
  125.    see for example packages\djgpp214.ini in this archive;
  126.  
  127.    put the file to the directory on cd or floppy where djgpp214.zip
  128.    and djgpp214.lsm are located;
  129.  
  130.    See for more examples in packages\ directory of this archive.
  131.  
  132.  
  133.    variables that can be used in *.ini files:
  134.      %DIRECTORY% - the target directory of the package
  135.        (the main configuration of FreeDOS is stored in file freedos.ini)
  136.      %AUTOFILE% - e.g. c:\freedos\fdauto.bat or c:\autoexec.bat depending on          settings
  137.      %CFGFILE% - e.g. c:\fdconfig.sys or c:\config.sys depending on settings
  138.  
  139.  
  140.  o It is recommended to load mouse driver while booting.
  141.  
  142.    Install can work with or without mouse (if second you may
  143.    use all the same keys as in Windows to swith between the items -
  144.    TAB/SHIFT+TAB/UP ARROW/DOWN ARROW, etc.
  145.    to check/uncheck the item, press SPACEBAR).
  146.  
  147.  o It is recommended to load also disk buffering software (like SMARTDRV).
  148.  
  149.  
  150. Command-line parameters (case insensitive):
  151. -------------------------------------------
  152.  
  153. The parameters listed below may be passed in the command
  154. line while executing Graphical FreeDOS installer:
  155.   /df filename   - specify DAT-file name ( default: INSTALL.DAT )
  156.   /logfile filename - sprecift LOG-file name ( default: INSTALL.LOG )
  157.   /nolog - don't create LOG-file
  158.   /nobase - don't create installation database (for uninstalling packages)
  159.   /mono - used only if the user starts Text-mode installer
  160.   /noask - don't ask which graphic/text mode to use;
  161.            if this option is specified the 640x480x16colors mode will be used
  162.   /auto - automatically install FreeDOS with no questions if all is O.K.
  163.           if the error occurs, the dialog box will be displayed
  164.           Some windows will wail 5 sec. to allow user to press something.
  165.  
  166.           If there are no errors and user presses nothing, the
  167.           install program will install FreeDOS with the default options
  168.           and exit.
  169.  
  170.   /src path - specify source path
  171.   /dst path - specify destination path
  172.   /noevery
  173.     or
  174.   /dontshowfilenames - don't show the name of each file while extracting
  175.   /nocancel - don't allow to break copying process
  176.   /textinstall programname - specify the name of text-install program
  177.                              ( default: textinst.exe )
  178.   /licence filename - specify the filename of licence agreement
  179.                       ( default: licence.txt )
  180.   /acceptlicence - accept licence
  181.   /overwrite - don't ask for overwrite and overwrite existing files
  182.   /keepfiles - don't ask for overwrite and keep existing files
  183.  
  184.  
  185.   /change - this option allows to modify the existing FreeDOS installation
  186.             and deinstall some packages!
  187.             This options uses files from directory
  188.             %fdosdir%\instbase
  189.             If the installation program tells that it couldn't read
  190.             installation database, please, verify that you have inserted
  191.             the installation disk to the same drive where it was
  192.             during install. If FreeDOS source path was change,
  193.             please, change it in configuration file
  194.             %fdosdir%\instbase\freedos.log
  195.  
  196.   /theme dir-name - use GUI theme that is located in directory
  197.                     (e.g. /theme linux.thm
  198.                     here: in directory linux.thm should be file
  199.                     with the same name linux.thm and bmp-images
  200.                     that are used in theme)
  201.                     theme will be loaded only in 16-bit graphic mode;
  202.                     if we cannot open theme, it is not loaded
  203.                     and default buttons/forms/checkboxes are used;
  204.  
  205.  
  206. Install program sets the environment variable fdosdir (and adds it to fdauto.bat).
  207. This variable is a directory name where FreeDOS is installed without end slash.
  208.  
  209. It adds also variables %autofile%, %cfgfile% and %GUI_inst%:
  210.   autofile==c:\autoexec.bat or path\fdauto.bat (specified in freedos.ini)
  211.   cfgfile==c:\fdconfig.sys or c:\config.sys (specified in freedos.ini)
  212.   GUI_inst==true.
  213.  
  214. These variables will not remain after reboot. If you want to set
  215. them permanent you have to configure freedos.ini and add appropriate
  216. line to %AUTOFILE%
  217.  
  218.  
  219. If you want to check if Graphical Installer was used, you may do the
  220. following things:
  221.  
  222. if "GUI_inst"=="true" echo Graphical installer WAS used
  223. if "GUI_inst"=="" echo Graphical installer was NOT used
  224.  
  225. or
  226.  
  227.  
  228. if exist %fdosdir%\INSTBASE\freedos.log echo Graphical installer WAS used
  229. if not exist %fdosdir%\INSTBASE\freedos.log echo Graphical installer was NOT used
  230.  
  231.  
  232. P.S.
  233.   Sorry for possible errors in my English :)
  234.  
  235.