home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR4 / XEROG10.ZIP / XEROG.DOC < prev    next >
Text File  |  1993-07-27  |  4KB  |  111 lines
  1.                         XEROG.DOC - v1.0
  2.                   (C)1993 Tolgathian  Software
  3.  
  4.  
  5. Hello!
  6.  
  7. There are only two reasons you are reading this document. One, you
  8. needed XEROG for something and are reading the docs on how to use
  9. it; Two, you are a software magpie and cannot resist collecting
  10. yet another program that does you no good and absorbs disk space
  11. like the Blob. If you are described by the second reason, you have
  12. my sympathies as I too suffer this affliction to some degree.
  13. If you are described by the first reason, here we go:
  14.  
  15.  
  16.        = Legalus Stayvus Offus ad Legalus Nauseum =
  17.  
  18. Tolgathian Software hereby places this program and it's related
  19. documentation into the Public Domain as long as this document file
  20. remains with it and both remain unaltered. It may be archived and
  21. freely distributed across, through and in any medium. It may be
  22. distributed by commercial operations as long as no charge is made
  23. for the software - only a reasonable medium/processing charge may
  24. apply. Tolgathian Software and anyone related to it (i.e.: it's
  25. employees, members, and owners) provide this software as is, and
  26. no garauntee is made for it's proper operation and fitness for any
  27. purpose. The user understands and agrees that the user will not
  28. hold Tolgathian Software, it's employees, members, or owners
  29. responsible for any direct, incidental, related, consequential,
  30. or otherwise remotely conceived damages as the result of it's use
  31. or misuse.
  32.  
  33. Sorry to bore you with that stuff, but good heavens! People will
  34. sue the Public Works Department if they fall and hurt themselves
  35. while doing a handstand on a skateboard going downhill on a gravel
  36. sidewalk backwards with no helmet at rush-hour blindfolded.
  37. And some fool lawyer that should know better will help them do it!
  38. (Doctor! It hurts when I do this!)
  39.  
  40. Ok -
  41.  
  42. XEROG will make a copy of all or part of a file. It makes a byte
  43. by byte copy  and creates a file with the name you specify.
  44.  
  45. The command line looks like this:
  46.  
  47. XEROG [path]Original [path]Copy Start Stop [N]
  48.  
  49. Items in brackets are optional. The file to copy from is specified
  50. by Original. You may include a path if you wish. The file you
  51. want to create is specified with Copy. You may include a path if
  52. you wish. Please note that if you specify an already existing file
  53. then XEROG will copy over it and destroy it with no warning.
  54. You must specify a starting byte position in Original. If you want
  55. to copy from the begining of Original, you would put a 1 where
  56. Start is on the command line. You must also specify a stopping
  57. byte position in original for the copy to stop at. This byte will
  58. be included in the Copy. Put this number where the Stop is on the
  59. command line. There is an optional formatting number N at the end
  60. of the command line. This was included for our own purposes, but
  61. might be of some use to you. If you put a number here, XEROG will
  62. insert a carriage return and line feed every Nth byte in Copy.
  63.  
  64. Examples:
  65.  
  66. Assume you have a 36 byte long file called test.txt with this in it:
  67.  
  68. abcdefghijklmnopqrstuvwxyz0123456789
  69.  
  70. You want to copy the first 15 bytes to a file called test.xrg :
  71.  
  72. XEROG test.txt test.xrg 1 15
  73.  
  74. This will produce a file with this in it:
  75.  
  76. abcdefghijklmno
  77.  
  78. Now you want to copy from the 5th byte to the 20th byte:
  79.  
  80. XEROG test.txt test.xrg 5 20
  81.  
  82. This will produce a file with this in it:
  83.  
  84. efghijklmnopqrst
  85.  
  86. Suppose you want a CR/LF every 5th byte, starting from the 1st byte
  87. through the 25th byte:
  88.  
  89. XEROG test.txt test.xrg 1 25 5
  90.  
  91. This will produce a file with this in it:
  92.  
  93. abcde
  94. fghij
  95. klmno
  96. pqrst
  97. uvwxy
  98.  
  99.  
  100. Please note that in each of these examples, the previous test.xrg
  101. gets completely overwritten each time with the new improved test.xrg
  102.  
  103. Well, there you have it. XEROG has been extremely usefull to us in
  104. analyzing several large databases (310Mbytes+ !). We hope that it
  105. proves usefull to you too.
  106.  
  107. If you have any questions, comments, complaints, suggestions or
  108. gossip, contact Eli Kane on CompuServe 72223,1722.
  109.  
  110. Tolgathian Software - purveyors of fine no frills utilities.
  111.