home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 595.lha / File-Chainer_V1.3 / File-Chainer_V1.3.doc < prev    next >
Text File  |  1980-01-22  |  9KB  |  212 lines
  1.                               ___    __
  2.                               \_ ile-\ hainer
  3.                                \      \__
  4.  
  5.                                 Version 1.3
  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). Someone proposed to use it to speedup the startup
  43.  by chaining sequentially executed files and only execute the file-chain
  44.  in the startup-sequence (this will minimize the drive-head movement
  45.  for the startup-sequence needs not to be examined between executing
  46.  two executable files.)
  47.  
  48.  [Hey, i am happy about every kind of feedback to this production,
  49.   when u think that I should know about it, write me what you do
  50.   use it for. (address below) ]
  51.  
  52.  Yeah that's great, but...
  53.  
  54.  
  55.  How do I use it ?
  56.  -----------------
  57.  
  58.  usage: FileChainer [DestFile File File {File}]
  59.  
  60.  eh? What does this mean? Well, let's explain it:
  61.  
  62.  The [ ] means the you can omit all parameters.
  63.  If you give parameters you must at least specify three filenames
  64.  (namely DestFile File1 File2). The first filename will be the name that
  65.  will be given to the file-chain when writing it. The other filenames
  66.  specify the files that will be linked to the file-chain.
  67.  The { File } means that u can specify so many filenames as you like to
  68.  or simply omit a further filename. The corresponding files will be
  69.  linked to the file-chain in the order you gave the pararmeters
  70.  In other words: you must give a destination-filename and as many 
  71.  filenames (at least 2) of files, that will be linked to the file-chain,
  72.  as you like to. Hmmm... let's have an example:
  73.  
  74.    FileChainer RAM:Test SYS:Demos/MyLatestDemo
  75.                SYS:AdditionalC/MyVirusChecker
  76.                SYS:Games/MyTicTacToe
  77.  
  78.  after pressing the big one (namely Return or Enter) File-Chainer will
  79.  ask you for an argumentline for each of the files you specified.
  80.  When you don't want specific parameters for a program, simply enter
  81.  nothing and press Return/Enter. If you don't have specified an
  82.  argument-line for a file, when running the resulting file-chain, this
  83.  file will be given the parameters you have given in the argument-line
  84.  for the file-chain itselves.                 Well, when no error
  85.  occurred you will find a file named Test in the Ram-disk.
  86.  When you should execute this file you will at first see MyLatestDemo,
  87.  then MyVirusChecker will look after some little programs that are
  88.  creeping around in your memory, and finally you can play MyTicTacToe.
  89.  After exiting MyTicTacToe you will return from RAM:Test.
  90.  
  91.  Another example
  92.  
  93.    FileChainer Ram:Test2 File1 File2 File3 File4 File5 File6
  94.  
  95.  will create Ram:Test2 than, if executed, will start the files
  96.  File1,..,6 in the following order:
  97.  File1, File2, File3, File4, File5, File6
  98.  
  99.  So, but what about the case if I omit all arguments ? Well, then the
  100.  File-Chainer will try to use requesters to let you specify the
  101.  filenames. So when you omit all parameters, File-Chainer will use
  102.  the REQ.library (of course you will need this library in your LIBS:).
  103.  You will need at least version 2 of REQ.library (I use revision 5).
  104.  
  105.  The first filerequester enables you to specify the destination name.
  106.  Note that this requesters border has another color than the following
  107.  requesters for you are warned that this requester asks for a filename
  108.  for writing something on your media.
  109.  If you cancel the requester you will stop File-Chainer and get
  110.  back where you came from. The following filerequester will ask you
  111.  for specification of the name of the file that will be executed
  112.  first (when starting the resulting file-chain). When u hit Cancel
  113.  you will exit with an error-message and get back where you came from
  114.  (remember that you must at least give two files that are to chain).
  115.  When you entered a filename another requester will ask you for a
  116.  further filename. You still can exit the File-Chainer when you cancel
  117.  this requester. When you entered a filename File-Chainer will bring up
  118.  a further requester every time you entered one more name.
  119.  Every requester that asks you for a file to chain in, will be followed
  120.  by a string-requester that asks you for an argument line for the last
  121.  specified file. Of course arguments are optional. When you cancel the
  122.  third (or higher) filerequester you cannot exit anymore, because File-
  123.  Chainer assumes that you are ready with your fileselection and will start
  124.  to create the filechain.
  125.  The filechain will be written to a file named as you entered first.
  126.  If there exists any file that is named the same as the file-chain
  127.  you will be asked to confirm to overwrite this file.
  128.  
  129.  
  130. Known Bugs:
  131. -----------
  132.  
  133. -not really a bug but caused by the fact that the files in the chain are
  134.  simply called by a jsr:
  135.  - arp-commands use exit() (but not rts) to leave, so after running
  136.    an arp-command in the chain the folling file can't be run (returns
  137.    simply to where it came from).
  138.  - executable files that do an "unintelligent" segment-splitting
  139.    (for starting as backgroundtask) cause an recoverable alert, because
  140.    their "unintelligent" method doesn't consider the hunks of the other
  141.    files. More intelligent would be to allocate memory, copy the own
  142.    hunks into and do a create process (yeah, Zaphod, your Include-
  143.    Completion works in every position of a file-chain!). I know I can't
  144.    demand to rewrite all these programs, so I must solve this problem in
  145.    future versions by doing a create-process on the hunks of each files, so
  146.    the files can't mess with segmentsplitting.
  147.  
  148.  if you should have found a bug, pleaze contact me (address b-low) for
  149.  i can fix it.
  150.  
  151.  
  152. Future enhancements, suggestions:
  153. ---------------------------------
  154.  
  155. -all bugs (know and not known) fixed ;-)
  156.  
  157. -WorkBench support (yuccck!) (simply the same like execution from CLI
  158.  without parameters, or if multiselected, chain all multiselected files).
  159.  
  160. -Script-files where we can define the files and the parameters
  161.  (would be the same effect like compiling a batch-file!)
  162.  
  163. -Overlay techniques for memory-handling (or freeing mem after running a file)
  164.  
  165. -File-Unchainer, that extracts all files from a file-chain.
  166.  
  167.  Please tell me which of these you would like to see implemented in future
  168.  versions of File-Chainer. If nobody wants any enhancements, there probably
  169.  won't be any, so contact me.
  170.  
  171. History:
  172. --------
  173.  
  174. V1.0: -this is it and there was none before, what did you expect ???
  175.  
  176. V1.1: -some minor bugs fixed (commandline parsing)
  177.       -now works on chip&fast-hunks, too
  178.       -not using ARP-Filerequester or own Requester when REQ.library couldn't
  179.        be opened (I simply hate this ARGGH-Filerequester)
  180.       -when starting File-Chainer without parameters all output of actions
  181.        will be supressed/redirected to requesters instead of CLI-window.
  182.  
  183. V1.2: -you can give each file an own argument-line
  184.  
  185. V1.3: -bug fixed: doesn't request an argument-line when having specified
  186.        too few files to link
  187.       -confirmation requested if our destfile would overwrite an existing
  188.        file with the same name
  189.       -holding all filenames (of the files that are included in the file-
  190.        chain) in a name hunk, for a File-Unchainer (if I should write it)
  191.        can extract the files under their original names (excluding path)
  192.  
  193. Thanx to:
  194. ---------
  195.  
  196. - Jay Miner for this froody machine.
  197. - Zaphod of HYPENOSIS for never beeing content with the current version
  198.   of File-Chainer, thus helping to improve it.
  199. - IRC for keeping me in contact with so many nice guys.
  200. - God for his much more froody creation'n'salvation.
  201.  
  202.  
  203.  If you wanna contact me, for whatever,
  204.  send an e-mail
  205.  to: i1100401 at dbstu1-rz.tu-bs.de    (internet)
  206.  or: i1100401 at dbstu1.bitnet         (bitnet)
  207.  or: i1100401 at dbstu1                (earn)
  208.  
  209.  
  210. December 12, 1991 Bilbo the first of Hypenosis.
  211.  
  212.