home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / archiver / shar / shar.doc < prev    next >
Text File  |  1989-08-25  |  5KB  |  99 lines
  1. 06600000000800
  2. 1
  3. 2
  4. F0110030
  5. 9[............................................................]011
  6. ÇNAME
  7. êsharÇ-createshellarchiveonAtariSTforextractionby
  8. /bin/sh(Unix)orwithêsharÇitself
  9.  
  10. SYNOPSIS
  11. êsharÇ[[-eo]archive][-abcmsuv][-pprefix][-ddelim]
  12. [files>archive]
  13.  
  14. DESCRIPTION
  15. êsharÇprintsitsinputfileswithspecialcommandlines
  16. aroundthemtobeusedbytheUnixBourneshell,/bin/sh,or
  17. êsharÇitselftoextractthefileslater.Theoutputcanbe
  18. filteredthroughtheshelltorecreatecopiesofthe
  19. originalfiles.
  20.  
  21. êsharÇallowsdirectoriestobenamed,andêsharÇprintsthe
  22. necessarycommands(mkdir&cd)tocreatenewdirectories
  23. andfillthem.êsharÇwillnotallowexistingfilestobe
  24. over-writteniftheshellarchiveisextractedwiththe
  25. BourneShell;suchfilesmustberemovedbytheuser.
  26.  
  27. 9[............................................................]011
  28. OPTIONS
  29. -aAlltheoptions.Theoptions:-v-c-b-pXXareimplied.
  30.  
  31. -bExtractfilesintobasenamessothatfileswithabsolute
  32. pathnamesareputintothecurrentdirectory.This
  33. optionhasstrangeeffectswhendirectoriesare
  34. archived.
  35.  
  36. -cCheckfilesizeonextractionbycountingcharacters.An
  37. errormessageisreportedtothepersondoingthe
  38. extractionifthesizesdon'tmatch.Onereasonwhythe
  39. sizesmaynotmatchisthatêsharÇwillappendanewline
  40. tocompleteincompletelastlines;êsharÇprintsa
  41. messagethatmentionsaddednewlines.Anotherreason
  42. whythesizesmaynotmatchisthatsomenetworkmail
  43. programsremovenon-whitespacecontrolcharacters.êsharÇ
  44. printsamessagethatmentionscontrolcharactersto
  45. theextractor.
  46.  
  47. -dUsethisasthe``endoffile''delimiterinsteadofthe
  48. default.Theonlyreasontochangeitisifyoususpect
  49. afilecontainsthedefaultdelimiter:SHAR_EOF.
  50.  
  51. -eExtractashellarchive.Filesstoredwithinanexisting
  52. shellarchivearewrittentodiskasseperatefiles.
  53. Directoriesarecreatedasneccessary.Alreadyexisting
  54. fileswillnotbeoverwritten.Options-c,-mor-v
  55. specifieduponcreationoftheshellarchivearenot
  56. regarded.
  57.  
  58. -mResettheexactprotectionmodesoffileswhentheyare
  59. extracted(usingthechmodprogram).Bydefault,the
  60. extractor'sdefaultfilemodesareused,andexecutable
  61. files(e.g.,shellscripts)aremadeexecutable.
  62.  
  63. -oExtractashellarchivewithoverwrite.Similartothe-e
  64. optionbutalreadyexistingfileswillbeoverwritten.
  65.  
  66. -pUsethisastheprefixtoeachlineofthearchived
  67. files.Thisistomakesurethatspecialcharactersat
  68. thestartoflinesarenoteatenupbyprogramslike
  69. mailers.Ifthisoptionisused,thefileswillbe
  70. extractedwiththestreameditorsedratherthancatso
  71. itismoreefficientandportabletoavoidsettingthe
  72. prefix,thoughperhapslesssafeifyoudon'tknowwhat
  73. Çisinthefiles.
  74.  
  75. -sSilentrunning.Allcheckingandextraoutputisinhibi⑨
  76. ted.
  77.  
  78. -uArchivetheinputfileswiththeuuencodeformatfor
  79. laterextractionwithuudecode.Thiswillallowyouto
  80. sendfileswithcontrolcharactersinthem,butwill
  81. slowdowntheextracting.Youmustbesurethatthe
  82. receivingpartyhasaccesstouudecode.
  83.  
  84. -vPrintverbosefeedbackmessagesaboutwhatêsharÇisdoing
  85. tobeprintedduringextractionwiththeBourneShell.
  86. Sizesofplainfilesareechoedtoallowasimple
  87. validitycheck.
  88.  
  89. AUTHOR
  90. RainerKlute(highlybasedonUnixêsharÇbyGaryPerlmanand
  91. STêsharÇbyJ.Altstadt.
  92.  
  93. LIMITATIONS
  94. Theextractionalgorithmisnottooclever.Itonlyrecogni⑨
  95. zesfilenamesandthefilecontentsassuch.SoêsharÇdoes
  96. notregardanyoftheoptions-c,-mor-viftheywere
  97. specifieduponcreationofthearchive.
  98.  
  99.