home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / t / tar / !tar / !Help < prev    next >
Encoding:
Text File  |  1993-08-26  |  6.4 KB  |  138 lines
  1.  
  2. !tar - Franz Philipps' front end to Frank Lancaster's tar
  3. =========================================================
  4.  
  5. On the command line, you say
  6.  
  7. tar [-]Commands[Options] ARCHIVE [LIST] [BLKS] [LEN] [-C DIR] object1 object2...
  8.  
  9. In the desktop, you control tar from 2 windows, in which
  10. you specify any Options and select the Command to be executed
  11.  
  12. There are 2 'modes' of operation
  13.  
  14. 1 Command line like: you type in the names of the objects
  15. 2 drag'n'drop
  16.  
  17. Commands and options can't be typed in, they are un/set in the 'tar' and
  18. 'tar options' window respectively
  19.  
  20. That's basically all
  21.  
  22. But 'basically' implies a 'but' so here it is
  23.  
  24. - I tested the prog mostly in the drag'n'drop mode with only a few options
  25.   set (those I use regularly)
  26.  
  27. - !tar maintains a scrap directory which will be wiped out on quit.
  28.   It is called tar`scrap and that name can only be changed by hacking
  29.   !tar.!RunImage. Its parent though is set in !tar.!Run to <Wimp$ScrapDir>
  30.   if defined and <tar$dir> otherwise, and so can easily be adapted.
  31.   On termination !tar.!RunImage executes "wipe <parent>.tar`scrap ~c~vrf" -
  32.   if someone has in/advertently set (the sys variable) 'parent' to 'adfs::$',
  33.   the effect wouldn't be as unpleasant as in "wipe <dir`name> ~c~vrf"
  34.  
  35. - In the drag/op mode !tar listens for DataLoad messages and collects the
  36.   incoming object names in the tar`scrap.tar`list file. When the DataLoad
  37.   chain breaks, "tar l tar`list" is executed. The options get written
  38.   into tar`list on the 1st DataLoad msg in the chain and when the 'l' option
  39.   is set, it will be ignored. If you want a "tar l my`own`list", name the
  40.   list and 'go'
  41.  
  42. - When creating a new archive/appending objects to an existing one by the
  43.   drag/op method, all objects come from come from the same filer window, ie.
  44.   they are in the same directory. !tar selects that dir and executes
  45.   something like 'tar cf archive *', that is the archived objects don't
  46.   have their absolute path names anymore, so you can 'untar' such an archive
  47.   into a dir of your choice. If you WANT to keep pathnames, list the full
  48.   object names in the 'Objects' writable and 'go'
  49.  
  50. - As I do not know how to restore the Currently Selected Directory (@)
  51.   to the Previously SD when the change was to another filing system
  52.   (*back won't do in this case), you shouln't rely on the @ being unchanged
  53.   when !tar runs
  54.  
  55. - When untar'ing a TARchive (tar archive) with nude objects, the extracted
  56.   objects go into the tar`scrap directory. This is wiped beforehand, so you
  57.   can be sure it only contains objects belonging to the archive you're just
  58.   extracting from. Of course, full pathnamed objects will go to where they
  59.   came from
  60.  
  61. - !tar starts Frank's tar via a Wimp_StartTask. A command window will pop
  62.   up and some info be displayed. Usual cmnd window controls: ⇧Shift+Ctrl to
  63.   stop scrolling, Ctrl alone to slow it down. When tar finishes the window
  64.   disappears. If you want to it keep it for some reason, hold ⇧Shift down
  65.  
  66. - !Help is supported, but on tar options you'd better read the doc file
  67.   tar`help is started by !tar when !tar gets a HelpRequest message from !Help
  68.   but tar`help isn't running yet. It dies with both !tar and !Help and can
  69.   also be terminated from the Tasks window
  70.  
  71. - When using compression, some sys vars must be set up - again, read the
  72.   documentation as I've only defined tar$scrap (must be set if compressing)
  73.   The compress prog came with the tar package so I throw it in, though
  74.   I don't see any advantages in using tar this way, inasmuch as there is the
  75.   arc/!Spark/!ArcFS troika which does it better anyway. But the tar/gzip
  76.   dvoika is unbeatable in terms of attainable compression factors. In fact,
  77.   I wrote !tar to speed up the 100=150 process:
  78.     unarc an arc/!Spark/!ArcFS archive
  79.     collect extracted objects into a TARchive
  80.     gzip it
  81.   whom I fed with 100 'Bytes free &00000 =      0' disks and it spat out
  82.                    50 'Bytes free &00000 =      0' disks and
  83.                    50 'Bytes free &c7000 = 815104' disks (800 kg A310 drives)
  84.   (well, it's probably a 100=130 process, but this isn't bad either)
  85.  
  86. - !tar uses Interface' pointer changing feature; as this requires calling
  87.   an Interface SWI every 0-event, a PollIdle with a 0-event distance of
  88.   20/100 s is used - you can see the delay. Change dt% in !RunImage if annoyed
  89.   There are other ... eh ... peculiarities with the pointer changing
  90.   its shape - well, you can't have everything
  91.  
  92. - !tar has no icon bar icon, but you can 'iconize' it and put anywhere on
  93.   screen
  94.  
  95. - A set of saved options can be loaded and the currently selected options
  96.   can be saved and will be used when you run !tar. If an 'Options' file
  97.   does not exist !RunImage generates a default set of options which is:
  98.   verbose listing of what's going on and nothing else
  99.  
  100. - !tar is a lone wolf - it won't let a second incarnation start up
  101.  
  102. - Put tar into !tar application directory or into a location on the Run$Path
  103.   (for example, a library)
  104.  
  105. - Usual WimpSlot note: with a 4 Mt machine, I can't go below a 32k WimpSlot
  106.   The uncrunched !RunImage is 17.5k big, so it won't run in a 24k slot either
  107.   Crunching with BasCrunch 1.02 not 'Building multiple-statement lines'
  108.   reduced this to ~10k, but I had first to conver all SICK-style & in assembler
  109.   chunks to the more civilized dcd (=equd). !RunImage still coulnd't find
  110.   a file called `_'` , I too, so I gave up (don't need it anyway)
  111.  
  112. - Some stuff I do not like and you won't too - so I will try to improve it
  113.   and not mention further. Perhaps one thing: when no command is selected
  114.   and you drop an object onto the 'tar' window, its full name is inserted
  115.   into the 'Objects' writable. Can't see any useful application of this
  116.   and also can't remember now why I coded it in, but I could one day and
  117.   will regret then having it deleted
  118.  
  119. If there's something that really annoys you e-mail to
  120.  
  121. ig06@rz.uni-karlsruhe.de
  122.  
  123. (but say that it's for franz, better franz philipps, as there are currently
  124. several people parasiting on my account) and I will see w.i.c.d.
  125.  
  126. The @-flaw I can't extinct, as on Aug 26th 1993, the number of arrived
  127. old-ro2-(RISC OS 2)-PRMs-people-don't-need-anymore is still 0.0
  128. This, surely, is because the postal indices in Germany have changed a couple
  129. of weeks ago and you wasn't sure whether your parcel will reach me. Now
  130. you know it will but don't have the index, so here at last is the alleviation
  131.  
  132. Franz Philipps
  133. Koeslinerstr. 71 A
  134. 76139 Karlsruhe
  135. Germany
  136.  
  137. (immer gerade aus, an der zweiten ampel rechts)
  138.