home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsd / extarct / !ReadMe next >
Encoding:
Text File  |  1995-08-20  |  3.9 KB  |  132 lines
  1. ExTARct - RISC OS tar file extractor.
  2.  
  3.  
  4. --- Copyright Notice
  5.  
  6. This software is Copyright 1995 Kevin F. Quinn
  7.  
  8. No warranty, express or implied, is made about the
  9. reliability or fitness for purpose of this software.  Use of
  10. the software is entirely at the user's own risk.  The author
  11. accepts no responsibility for any damage arising from use of
  12. the software.
  13.  
  14.  
  15. --- Software Licence
  16.  
  17. Permission is hereby granted for the user to execute the
  18. software, at no charge.  Distribution of the software is
  19. permitted provided that the software, including the
  20. executable, the source files and all documentation is
  21. unmodified.
  22.  
  23. Source code is provided so that users may inspect the source
  24. and compile the software themselves if required, to ensure
  25. that the executable contains no virus.
  26.  
  27.  
  28. --- Manifest
  29.  
  30. The software distribution contains the following files:
  31.  
  32. File         Size   Description
  33.  
  34. !ReadMe      4027   This file
  35. c.ExTARct   18973   C Source for most of ExTARct
  36. ExTARct     31663   Built binary executable
  37. h.tar         923   Header file defining tar blocks
  38. Makefile      686   Acorn C version 5 Makefile
  39.  
  40. If the distribution you have received does not match the
  41. above, please contact me at the address given at the bottom
  42. of this file.
  43.  
  44.  
  45. --- Description
  46.  
  47. ExTARct is a utility to facilitate the unpacking of tar
  48. archives under RISC OS, to overcome the 77-file per
  49. directory limit that we appear to be lumbered with for the
  50. forseeable future.  It also swaps filenames and types where
  51. requested, using the filetype as a subdirectory name.
  52.  
  53.  
  54. --- Instructions
  55.  
  56. ExTARct is a command line utility.  Basically, I can't be
  57. bothered with making a fancy wimp front-end for what is
  58. essentially a widget that is likely to be used occasionally,
  59. by people porting software from other platforms.
  60.  
  61. It takes a tar file, and optionally a configuration file,
  62. and extracts the contents of the archive.  The configuration
  63. file lists the file types that should be "swapped", and also
  64. indicates which of these should be split into
  65. subdirectories.
  66.  
  67.  
  68. Syntax:
  69.   ExTARct [options] <tarfile>
  70.     where options are as follows:
  71.       -v            The ubiquitous verbose option
  72.       -d <number>   The number of files to one directory
  73.                     (default 60)
  74.       -t <filename> Filename listing types to swap, tagged
  75.                     for directory split
  76.                     (default is no swaps, no directory splits)
  77.       -l            List operations (i.e. file mappings) without
  78.                     doing anything really
  79.       -p <prefix>   Prefix for directory splits (default none)
  80.  
  81.  
  82. Which should be fairly self-explanatory.  The format of the
  83. configuration file is one filetype per line, with a "*"
  84. following all filetypes that should be split.  Lines
  85. starting with "#" are ignored.  Note that any '*'s must be
  86. separated from the filetype by whitespace.
  87.  
  88. An example configuration file:
  89.  
  90.  
  91. # List of types to invert for GNAT
  92. # Note that '*' indicates that files of that type also
  93. # get an extra directory (grr...)
  94. c
  95. h
  96. adb *
  97. ads *
  98. spt
  99. adt
  100.  
  101.  
  102. Where a tar archive entry is a link to another file,
  103. ExTARct will generate a !LinkFS link.  !LinkFS can be
  104. obtained from all good free software archives.
  105.  
  106.  
  107. --- "Features" (i.e. restrictions ;) )
  108.  
  109. Note that splitting up of directories is not done for all
  110. directories with more than the specified number of files -
  111. only for the swapped filetypes specified in the
  112. configuration file.  Future versions might do things more
  113. intelligently.  For now, the current operation is all I
  114. need, so it does the job I want it to do.
  115.  
  116. ExTARct also makes no attempt to resolve the filename length
  117. restriction.  To solve this problem, use !LongFiles,
  118. available from all good free software archives.  In the
  119. future, it is possible that a crunching option may be
  120. implemented, but I make no promises.
  121.  
  122.  
  123. --- Contacting the Author
  124.  
  125. If you have any suggestions, bug fixes, questions etc. or
  126. just want to contact me for the hell of it, send EMail to
  127. kevq@banana.demon.co.uk.  I welcome any feedback.
  128.  
  129.  
  130. Kevin F. Quinn
  131. August 1995
  132.