home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 551.lha / Chop_v0.92 / chop.doc < prev    next >
Encoding:
Text File  |  1991-09-08  |  3.4 KB  |  90 lines
  1. Chop v0.92 by Terry Brown, 1990,1991
  2.  
  3. Chops up files into smaller parts, in a variety of ways.
  4.  
  5. Briefly -
  6.  
  7.   Chop filename [-sn] [-bn] [-cn] [-Bs|-As] [-in] [-Ps] [-p]
  8.   
  9.   -sn  skip first n bytes, start from start if omitted
  10.   -bn  take only n byte chunks, take remainder of file if omitted
  11.   -cn  take only n chunks, take chunks to end of file if omitted
  12.   -Bs  after taking -bn bytes, take bytes until string s is reached
  13.   -As  after taking -bn bytes, take bytes until end of string s is reached
  14.   -in  buffer size n kilobytes, default 40, needs two of them
  15.   -Ps  string s is path and file name for output
  16.   -p   prompt before writing each file
  17.   
  18.   s must contain no spaces, ? matches anything, and `hh is a hex constant
  19.   
  20.   watch for shells which pre-expand wild cards etc.
  21.   
  22.   Eg. Chop dh0:bigText -b10000 -B`0A`20 -Pdf0:textBit -p
  23.   
  24.   breaks  bigText  into roughly 10000 byte pieces before lines starting with a
  25.   space,  saving them to df0:textBit.001, df0:textBit.002 etc., and giving you
  26.   a chance to change disks before each write.
  27.   (`0A`20 is hex for newline + space)
  28.   
  29. This  program  will drop the first n bytes of a file, cut a file into n byte
  30. chunks, or n byte chunks plus enough bytes to get to the next end of line or
  31. header,  useful if your chopping up text files.  And you can save to another
  32. device,  with  pauses  to change floppies if you're moving a larger than one
  33. floppy file etc.   It acheives  reasonable  speed  by  doing large reads and
  34. writes.  Generally really useful.
  35.  
  36. This  program  very  closely resembles Chop 3.1 for MSDOS, but believe it or
  37. not it was written before I saw the MSDOS version.  I guess the features for
  38. this sort of thing are fairly obvious :-).
  39.  
  40. If  you think the source is rough now, you should have seen it before it was
  41. tidied up :-).  It may occasionally produce a zero length file, but not very
  42. often.   Also,  if  it  runs  out  of buffered data while testing one of the
  43. search strings, it may say 'Out of range search for end of target', this may
  44. mean  a  file  will  not  be split where it should of been, but will be very
  45. rare.   (In  fact  I don't think it can happen at all since I decided not to
  46. implement  the  multi-character wildcard bit).  If it says this, it probably
  47. just means it reached the end of file while testing a search string.
  48.  
  49. A few examples...
  50.  
  51. chop dh0:downloads/BBS.cap -b1 -B`0AFrom -Pdh0:msgs/Msg
  52.  
  53. would  take  a  list of messages captured from a BBS in the file BBS.cap and
  54. place the separate messages in dh0:msgs/ as Msg.1, Msg.2 etc., assuming each
  55. message had From at the start of a new line at the beginning.
  56.  
  57. ...well alright, just one example :-)
  58.  
  59. Bug reports, comments etc. etc. to 
  60.  
  61. tb@tbnode.equinox.gen.nz or brownt1@lincoln.ac.nz
  62.  
  63. --- boring bits ---------------------------------------------------------
  64.  
  65. Chop  is  freely redistributable, but may not be sold for profit (ha ha).  I
  66. take no responsibility for any damage resulting from its use, use it at your
  67. own risk.  Where trade marks occur in this document, they are trade marks of
  68. the companies owning them.
  69.  
  70. --- revision history ----------------------------------------------------
  71.  
  72. 0.92
  73.  
  74. * added preceeding zeroes to extensions in chopped bits (useful for joining
  75.   with csh etc.)
  76.   
  77. * stopped zero length files being created
  78.  
  79. 0.91
  80.  
  81. * fixed typo in help text
  82.  
  83. * added code to avoid crash when output file won't open
  84.  
  85. * checked for CHR(10)'s in parameters, as added by csh
  86.  
  87. 0.90
  88.  
  89. * added all features :-)
  90.