home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / PASCAL / PT01.ZIP / ARCHIVE.MAN < prev    next >
Encoding:
Text File  |  1983-09-07  |  2.1 KB  |  78 lines
  1. .im man.im
  2. .NM archive maintain file archive
  3. .SY archive -cmd aname [ file ... ]
  4. .FU
  5. .ital archive
  6. manages any number of member files in a single file,
  7. .ital aname,
  8. with sufficient information that members may be selectively added, extracted,
  9. replaced, or deleted from the collection.
  10. .ital -cmd
  11. is a code that determines the operation to be performed:
  12.  
  13. .nf
  14. -c    create a new archive with named members
  15. -d    delete named members from archive
  16. -p    print named members on standard output
  17. -t    print table of archive contents
  18. -u    update named members or add at end
  19. -x    extract named members from archive
  20.  
  21. .fi
  22. In each case, the "named members" are the zero or more filenames
  23. given as arguments following
  24. .ital aname.
  25. If no arguments follow, then the "named members" are taken as
  26. .sf 6
  27. all
  28. .sf 0
  29. of the files in the archive, except for the delete command
  30. .ital -d,
  31. which is not so rash.
  32. .ital archive
  33. complains if a file is named twice or cannot be accessed.
  34. .br
  35. The
  36. .ital -t
  37. command writes one line to the output for each named member,
  38. consisting of
  39. the member name
  40. and a string representation of the file length, separated
  41. by a blank.
  42. .br
  43. The
  44. create command
  45. .ital -c
  46. makes a new archive containing the named files.
  47. The
  48. update command
  49. .ital -u
  50. replaces existing named members and adds new files onto
  51. the end of an existing archive.
  52. Create and update read from, and extract
  53. writes to, files whose names are the same
  54. as the member names in the archive.
  55. An intermediate version of the new archive file is first written to the
  56. file
  57. .ital artemp;
  58. hence this filename should be avoided.
  59.  
  60. An archive is a concatenation of zero or more entries,
  61. each consisting of a header and an exact copy of the original file.
  62. The header format is
  63.  
  64. .bold -h-
  65. .ital name length
  66.  
  67. .EG
  68. To replace two files in an existing archive, add
  69. a new one, then print the table of contents:
  70. .Q1
  71. archive -u archfile old1 old2 new1
  72. archive -t archfile
  73. .Q2
  74. .FUTURE
  75. It sure would be nice if the date last modified was kept for a file,
  76. and extract would keep that date.  As it stands now, doing an
  77. archive causes time/date information to be lost.
  78.