home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 99 / af099sub.adf / HotStartup.lzx / HotStartup / HotStartup_ENG.doc < prev    next >
Text File  |  1997-05-05  |  8KB  |  263 lines

  1.                               HotStartup
  2.                                 v 1.5
  3.                                26.03.97
  4.                         Written by Pietro Altomani
  5.  
  6. Introduction:
  7.  
  8.     Usually the Amiga,when you turn it on,waits for a disk which contains in the
  9.     's' directory a script,called Startup-Sequence,and executes it.
  10.     Some months ago I saw that if I insert the Win95 Installation CD
  11.     in a PC,AFTER the boot,starts a program contained in the CD.
  12.     That day I tought: "Why don't I give this feature also to my Amiga?"
  13.     So,in the Summer 1996,HotStartup was born.
  14.     When you launch it,it wait for a disk with the script
  15.     "S/HotStartup-Sequence" and then executes it.
  16.  
  17.  
  18. Archive Content:
  19.  
  20.     The distribuition Archive of HotStartup contains:
  21.  
  22.     HotStartup          The Program
  23.     HotStartup_ITA.doc  The Italian Manual
  24.     HotStartup_ENG.doc  This doc
  25.     HotStartup.config   A configuration example
  26.     HotStartup-Sequence An example of script for HotStartup
  27.  
  28.  
  29. Installation:
  30.  
  31.     To install HotStartup you have only to copy the file HotStartup to
  32.     the destination directory and the config file to ENVARC: or S:.
  33.     Then you have to reset the machine.
  34.  
  35. Use:
  36.  
  37.     To run HotStartup double-click on its icon or type in a CLI:
  38.  
  39.     RUN <> NIL: HotStartup
  40.  
  41.     You can also add the comand to you user-startup or copy the program
  42.     in the WBStartup directory of your Workbench disk or HD.
  43.  
  44.     In this version to close HotStartup you have just to run it
  45.     again.
  46.  
  47.  
  48. Configuration HotStartup:
  49.  
  50.     HotStartup need the file HotStartup.config in ENV:, S: or
  51.     in the same directory of the program.
  52.     You can create it with a Text Editor,or use the sample config
  53.     file included in this archive.
  54.  
  55.     It must contain this command: (in block capitals)
  56.  
  57.     DEVICE <exec_device> <unit> <AmigaDOS_devname>
  58.  
  59.     This add a new device to the list of devs to check.
  60.  
  61.     <exec_device> is the name of the Exec device which controls the drive
  62.                   (like trackdisk.device for floppies or cd.device for CDs)
  63.  
  64.     <unit> is the unit number
  65.  
  66.     <AmigaDOS_devname> is the name wich is used from CLI (like DF0:,PC1:,CD0:)
  67.  
  68.  
  69.     For example to ceck the internal floppy drive HotStartup.config must
  70.     contains:
  71.  
  72.     DEVICE trackdisk.device 0 df0:
  73.  
  74.  
  75.  
  76.  
  77.     There are other commands,but they aren't always needed.
  78.     If you don't use them,HotStartup uses hardcoded defaults.
  79.  
  80.     IMMEDIATE
  81.  
  82.     Tell HotStartup to check also the disks wich are ALREADY in the drives
  83.     when HS starts.
  84.  
  85.     WINDOW <consol_definition>
  86.  
  87.     Tell HS to use the console <console_definition>.
  88.     For example you can write:
  89.     WINDOW "CON:0/50//130/HotStartup window/CLOSE/WAIT"
  90.  
  91.  
  92.     ASKCONFIRM
  93.  
  94.     Tell HS to ask the user before executing the scripts.
  95.     It has been suggested me by Aaron Rock.
  96.  
  97.  
  98.     You can write commands without caution,but I suggest you to introduce
  99.     them with the ; (semicolon) character.
  100.  
  101.  
  102. Known Bugs:
  103.  
  104.     During long tests on my A1200 with GVP1230 at 40MHz + 4Mb Fast Ram,
  105.     on the A1200 with Blizzard 1220 of Simone Tellini,and on the Amiga
  106.     of Aaron Rock and Luca Danelon,we haven't found any bug.
  107.     However if you find a bug you should inform me. Thanks!
  108.     On my old Amiga 500 1.3 it crashes.
  109.  
  110.  
  111. The Future:
  112.  
  113.     This is my ToDo list (only for HotStartup,not for my life! ;-) )
  114.  
  115.       1) A grafic Interface to generate configs.
  116.          (I'm already working on it)
  117.  
  118.       2) Automatic check of every removable media of the system,
  119.          without using DEVICE command in hte config.
  120.  
  121.      I will also try to make HotStartup compatible with PowerAmiga
  122.      and other Amiga-like Operating Systems.
  123.      (but when will they arrive??????)  :-(
  124.  
  125.  
  126. History:
  127.  
  128.     v0.0 -> v0.5
  129.  
  130.     Not running version,never distributed,neither to beta-testers.
  131.  
  132.     v0.6 (17.7.96)
  133.  
  134.     First running version;never distribuited.
  135.  
  136.     Launch a HS process for each drive to check.
  137.     Use command line arguments instead of the config file.
  138.     Cause Enforcer Hits on Exit.
  139.  
  140.     v1.0 (17.8.96)
  141.  
  142.     HotStartup has been rewritten.
  143.     You've to launch only one HotStartup process;use a config file.
  144.     Don't cause Enforcer hits,however it has a bug: it opens a requester
  145.     if the disk inserted is not a valid DOS disk.
  146.  
  147.     v1.1 (10.9.96)
  148.  
  149.     All bugs fixed (thanks to Simone Tellini)
  150.     Use new commands in the configuration file.
  151.  
  152.     v1.2 (25.10.96)
  153.  
  154.     Uses less memory and don't slow down the Amiga.
  155.     It now checks drives once a second.
  156.  
  157.     v1.3 (08.01.97)
  158.  
  159.     First public release. :)))
  160.     Now the config file could be in ENV:,s: or in the
  161.     same directory of HotStartup.
  162.  
  163.     v1.4 (23.03.97)
  164.  
  165.     Changed closing method. Now you have to run HS again
  166.     to stop it. (never released)
  167.  
  168.     v1.5 (26.03.97)
  169.  
  170.     Added ASKCONFIRM command,as suggested by Aaron Rock.
  171.  
  172.  
  173. The Author:
  174.  
  175.     HotStartup has been written by Pietro Altomani.
  176.  
  177.     Fidonet MATRIX: 2:332/502
  178.  
  179.     Internet E-MAIL: altomanipietro@pragmanet.it
  180.  
  181.     WWW Home Page: http://www.pragmanet.it/hppersonali/user827/Pietro.htm
  182.  
  183.     Snail (Normal) Mail:  Pietro Altomani
  184.                           P.O.Box 82
  185.                           42016 Guastalla (RE)
  186.                           Italy
  187.  
  188. Thanks:
  189.  
  190.     Many thanks go to:
  191.  
  192.     - all people who works to the birth of the Amiga,the only real
  193.       Multitasking and Multimedia Computer (since 1985!). :-)
  194.  
  195.     - Simone Tellini,for the beta-testing,for the help,for the upload
  196.       on the Aminet.
  197.  
  198.     - Aaron Rock,the first who sent me an e-mail after
  199.       downloading HotStartup from the Aminet.
  200.  
  201.     - Luca Danelon,for the probable future including HotStartup
  202.       in the Amy Resource CD-ROM.
  203.  
  204.     - All the users who will send me comments,suggestions,bug-reports,
  205.       or who will tell me they're using HotStartup.
  206.  
  207.     - Wouter van Oortmerssen for the Amiga E compiler.
  208.  
  209.     - Urban Muller,for the Aminet,without which the Amiga couldn't
  210.       be so live three years after the C= disaster.
  211.  
  212. Legal Note:
  213.     THERE  IS  NO  WARRANTY  FOR  THE  SOFTWARE  TO  THE  EXTENT  PERMITTED BY
  214. APPLICABLE  LAW.   EXCEPT  WHERE OTHERWISE STATED IN WRITING THE COPYRIGHT
  215. HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY
  216. OF  ANY  KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
  217. THE  IMPLIED  WARRANTIES  OF  MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  218. PURPOSE.   THE  ENTIRE  RISK  AS  TO  THE  QUALITY  AND PERFORMANCE OF THE
  219. SOFTWARE IS WITH YOU.  SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE
  220. COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  221.  
  222. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
  223. ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE SOFTWARE
  224. AS  PERMITTED  BELOW, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL,
  225. SPECIAL,  INCIDENTAL  OR  CONSEQUENTIAL  DAMAGES ARISING OUT OF THE USE OR
  226. INABILITY  TO  USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA
  227. OR  DATA  BEING  RENDERED  INACCURATE  OR LOSSES SUSTAINED BY YOU OR THIRD
  228. PARTIES  OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER PROGRAMS),
  229. EVEN  IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
  230. SUCH DAMAGES.
  231.  
  232.     HotStartup is SolidarityWare: if you like it and use it
  233.     for more than a month
  234.     you should give a small donation to a Humanitarian Institution.
  235.     If you have access to the Internet I'd like to receive
  236.     an E-MAIL,too.
  237.     Thanks!
  238.  
  239.     You can distribute my program but you MUSTN'T modify anything.
  240.  
  241.  
  242. HotStartup Style Guide:
  243.  
  244.     These are the rules you have to respect in writing HotStartup scripts:
  245.  
  246.     1) If the script launches a apllication it have to use the command RUN.
  247.  
  248.     2) The scripts must ends with the command ENDSHELL
  249.  
  250.  
  251.     3) The scripts mustn't execute the funtion that must be
  252.        executed by the startup-sequence
  253.        (since the boot has already finished when HS starts)
  254.  
  255.  
  256. For Developers:
  257.  
  258.     If you are a developer (also if you write commercial Software) you can
  259.     distribute HotStartup with your package,but you MUSTN'T change anything.
  260.     I would like receive your package (if it's PD/Freeware/ecc..) or only a
  261.     message or a demo copy (I prefer the second... ;-) if it's Commercial.
  262.     Thank you!!
  263.