home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 576.lha / File-Chainer_V1.2 / File-Chainer_V1.2.doc.pp / File-Chainer_V1.2.doc
Text File  |  1991-12-05  |  8KB  |  187 lines

  1.                               ___    __
  2.                               \_ ile-\ hainer
  3.                                \      \__
  4.  
  5.                                 Version 1.2
  6.                                 -----------
  7.  
  8.                      Copyright 1991 by Bilbo the first
  9.                      ---------------------------------
  10.  
  11.  
  12.  What is it ?
  13.  ------------
  14.  
  15.  File-Chainer is an executable file, that cannot be started from WorkBench
  16.  via icons, but from CLI (as well as from any other program that doesn't
  17.  call File-Chainer by using the icon-information).
  18.  
  19.  Furthermore it's purpose is to enable you to create an executable file
  20.  out of a desired number of executable files. These executable files will
  21.  be executed in given order, when executing the resulting executable file.
  22.  "Hmm... This is what i use scripts for" you could say, but listen:
  23.  Of course the resulting executable file (in the folling text we wanna
  24.  call it the "file-chain") will NOT load the other files to execute them,
  25.  but it consists of them. What? Yeah, when you have loaded the file-chain,
  26.  you already have loaded with it all chained files. By the way let's have
  27.  another approach to the subject (a more technical one). The file-chain
  28.  consists of all hunks of the specified files that you wanted to link;
  29.  furthermore it includes an additional hunk that will (when starting the
  30.  file-chain) execute the other files in given order. This order is
  31.  specified by giving the arguments in a specific order.
  32.  
  33.  
  34.  What is it good for ?
  35.  ---------------------
  36.  
  37.  Well, tricky... I really don't know exactly. Sorry, but think about it
  38.  yourselves. Perhaps someone wants to link his little intro before
  39.  another program (remember good ole 64-times). It would be possible
  40.  to create a one-file-megademo out of several demos (but indeed you
  41.  would need lotsa memory because demos mostly are quite memory
  42.  consumptive).
  43.  
  44.  [Hey, i am happy about every kind of feedback to this production,
  45.   when u think that I should know about it, write me what you do
  46.   use it for. (address below) ]
  47.  
  48.  Yeah that's great, but...
  49.  
  50.  
  51.  How do I use it ?
  52.  -----------------
  53.  
  54.  usage: FileChainer [DestFile File File {File}]
  55.  
  56.  eh? What does this mean? Well, let's explain it:
  57.  
  58.  The [ ] means the you can omit all parameters.
  59.  If you give parameters you must at least specify three filenames
  60.  (namely DestFile File1 File2). The first filename will be the name that
  61.  will be given to the file-chain when writing it. The other filenames
  62.  specify the files that will be linked to the file-chain.
  63.  The { File } means that u can specify so many filenames as you like to
  64.  or simply omit a further filename. The corresponding files will be
  65.  linked to the file-chain in the order you gave the pararmeters
  66.  In other words: you must give a destination-filename and as many 
  67.  filenames (at least 2) of files, that will be linked to the file-chain,
  68.  as you like to. Hmmm... let's have an example:
  69.  
  70.    FileChainer RAM:Test SYS:Demos/MyLatestDemo
  71.                SYS:AdditionalC/MyVirusChecker
  72.                SYS:Games/MyTicTacToe
  73.  
  74.  after pressing the big one (namely Return or Enter) File-Chainer will
  75.  ask you for an argumentline for each of the files you specified.
  76.  When you don't want specific parameters for a program, simply enter
  77.  nothing and press Return/Enter. If you don't have specified an
  78.  argument-line for a file, when running the resulting file-chain, this
  79.  file will be given the parameters you have given in the argument-line
  80.  for the file-chain itselves.                 Well, when no error
  81.  occurred you will find a file named Test in the Ram-disk.
  82.  When you should execute this file you will at first see MyLatestDemo,
  83.  then MyVirusChecker will look after some little programs that are
  84.  creeping around in your memory, and finally you can play MyTicTacToe.
  85.  After exiting MyTicTacToe you will return from RAM:Test.
  86.  
  87.  Another example
  88.  
  89.    FileChainer Ram:Test2 File1 File2 File3 File4 File5 File6
  90.  
  91.  will create Ram:Test2 than, if executed, will start the files
  92.  File1,..,6 in the following order:
  93.  File1, File2, File3, File4, File5, File6
  94.  
  95.  So, but what about the case if I omit all arguments ? Well, then the
  96.  File-Chainer will try to use requesters to let you specify the
  97.  filenames. So when you omit all parameters, File-Chainer will use
  98.  the REQ.library (of course you will need this library in your LIBS:).
  99.  You will need at least version 2 of REQ.library (I use revision 5).
  100.  
  101.  The first filerequester enables you to specify the destination name.
  102.  Note that this requesters border has another color than the following
  103.  requesters for you are warned that this requester asks for a filename
  104.  for writing something on your media.
  105.  If you cancel the requester you will stop File-Chainer and get
  106.  back where you came from. The following filerequester will ask you
  107.  for specification of the name of the file that will be executed
  108.  first (when starting the resulting file-chain). When u hit Cancel
  109.  you will exit with an error-message and get back where you came from
  110.  (remember that you must at least give two files that are to chain).
  111.  When you entered a filename another requester will ask you for a
  112.  further filename. You still can exit the File-Chainer when you cancel
  113.  this requester. When you entered a filename File-Chainer will bring up
  114.  a further requester every time you entered one more name.
  115.  Every requester that asks you for a file to chain in, will be followed
  116.  by a string-requester that asks you for an argument line for the last
  117.  specified file. Of course arguments are optional. When you cancel the
  118.  third (or higher) filerequester you cannot exit anymore, because File-
  119.  Chainer assumes that you are ready with your fileselection and will start
  120.  to create the filechain.
  121.  ATTENTION! The filechain will be written to a file named as you
  122.  entered first WITHOUT caring if there is another file named the same.
  123.  Any file that is named the same as the file-chain will be overwritten.
  124.  So be careful when entering the destination-name.
  125.  
  126.  
  127. Known Bugs:
  128. -----------
  129. -not really a bug (the files in the chain are simlpy jsr'ed):
  130.  arp-commands use exit() (but not rts) to leave, so after running
  131.  an arp-command in the chain the folling file can't be run (returns
  132.  simply to where it came from).
  133.  
  134.  if you should have found a bug, pleaze contact me (address b-low) for
  135.  i can fix it.
  136.  
  137.  
  138. Future enhancements, suggestions:
  139. ---------------------------------
  140.  
  141. -WorkBench support (yuccck!).
  142.  
  143. -Confirmation requester before overwriting the DestFile
  144.  
  145. -Script-files where we can define the files and the parameters
  146.  (would be the same effect like compiling a batch-file!)
  147.  
  148. -Overlay techniques for memory-handling (or freeing mem after running a file)
  149.  
  150. -File-Unchainer, that extracts all files from a file-chain.
  151.  
  152.  Please tell me which of these you would like to see implemented in future
  153.  versions of File-Chainer. If nobody wants any enhancements, there probably
  154.  won't be any, so contact me.
  155.  
  156. History:
  157. --------
  158.  
  159. V1.0: -this is it and there was none before, what did you expect ???
  160.  
  161. V1.1: -some minor bugs fixed (commandline parsing)
  162.       -now works on chip&fast-hunks, too
  163.       -not using ARP-Filerequester or own Requester when REQ.library couldn't
  164.        be opened (I simply hate this ARGGH-Filerequester)
  165.       -when starting File-Chainer without parameters all output of actions
  166.        will be supressed/redirected to requesters instead of CLI-window.
  167.  
  168. V1.2: -you can give each file an own argument-line
  169.  
  170. Thanx to:
  171. ---------
  172.  
  173. - Jay Miner for this froody machine.
  174. - IRC for keeping me in contact with some many nice guys.
  175. - God for his much more froody creation'n'salvation.
  176.  
  177.  
  178.  If you wanna contact me, for whatever,
  179.  send an e-mail
  180.  to: i1100401 at dbstu1-rz.tu-bs.de
  181.  or: i1100401 at dbstu1.bitnet
  182.  or: i1100401 at dbstu1
  183.  
  184.  
  185. December 1, 1991 Bilbo the first of Hypenosis.
  186.  
  187.