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