home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 1992 August / info-mac-1992.iso / Help / accessing-files.txt < prev    next >
Text File  |  1992-09-15  |  4KB  |  87 lines
  1. To access binaries in the Info-Mac archive at sumex-aim, use your
  2. machine's ftp program.  Type "ftp sumex-aim.stanford.edu".  Use the
  3. account name "anonymous" (lower-case) and enter any password. Then
  4. "cd info-mac" to enter our directory. You should be able to transfer
  5. binaries with a statement like "get app/silly-paint.hqx".
  6.  
  7. NOTE:  Almost all files (even binaries) in the Info-Mac archive are in textf
  8. format, even though they may not be human-readable. Hence, a FTP transfer using
  9. a text-only option, often called ASCII, should work in all common cases.
  10.  
  11. In order to provide a reasonable level of performance and avoid causing
  12. Internet overload, there is a 35-user limit for anonymous ftp into
  13. sumex-aim during working hours, which we define as 8AM to 5PM Pacific
  14. time, Monday through Friday. When sumex is busy, use one of the many
  15. mirror archives around the world (see misc for a list of other archive
  16. sites, including sumex mirrors.)
  17.  
  18. Here are some simple commands to move you around the directory structure.
  19. This example assumes that you started in the /info-mac directory.
  20.     cd app         # move into the app directory
  21.     ls             # list the files there
  22.         get planet.hqx # transfer a file to your computer
  23.         cd ..          # move back up to the parent directory
  24.         cd help        # and so on...
  25.  
  26. Most Info-Mac files are stored in BinHex 4.0 format.  We have adopted the
  27. common practice of labeling such files with .hqx extensions.  To take these
  28. files and use them on your Macintosh, you must first run them through
  29. a program which will convert them from .hqx format into a regular Macintosh
  30. file. On Unix systems, you can use the mcvert program, stored as
  31. /unix/mcvert.shar. You can also do the conversion on your Macintosh by
  32. using any of a number of utilities, including BinHex 4.0, StuffIt, or
  33. Compact Pro. We recommend using Compact Pro because it is slightly more
  34. convenient and reliable than the other tools. Note: do NOT use BinHex 5.0
  35. as it is incompatible, for some very brain-damaged reasons.
  36.  
  37. Note that some of our files are large and have been split into smaller pieces
  38. so that they can be more easily mailed.  You must join them together before
  39. running BinHex or StuffIt. Hqx files can be edited as normal text; therefore,
  40. you can use any word processor or append command on your host to stitch the
  41. pieces together. There are some files in the /util directory to do this step
  42. for you (unity and united). Most such files are old, as we no longer split
  43. new submissions.
  44.  
  45. Many of our files also have been compressed to save space. You'll know that
  46. they have been when the file name after converting to Macintosh format ends
  47. with a .sit, .cpt, .sea, or .pit extension. Here is a table to help you
  48. with the reconstruction:
  49.  
  50. Extension    Created By    Recommended unpacker    Notes
  51.  
  52. .pit        PackIt II    StuffIt            obsolete format
  53. .sit        StuffIt        Compact Pro/StuffIt    has type SIT!
  54.         StuffIt Deluxe    Stuffit Expander    has type SITD
  55. .cpt        Compact Pro    Compact Pro
  56. .sea        various        itself (double-click on it to unpack)
  57.  
  58.  
  59. In summary, there are generally five steps to pulling .hqx files from our
  60. archives:
  61.     1. Transfer them to your computer with FTP.
  62.     2. Transfer them to your Macintosh somehow.
  63.         3. If necessary, put separate pieces together.
  64.     4. Run a de-binhexing utility to convert the .hqx files into either
  65.            real Macintosh files or compressed Macintosh files.
  66.     5. If they are compressed, use the appropriate decompression
  67.            program to decompress them.
  68. People using Unix may be able to skip steps 3 and 4 by using the program
  69. mcvert on their Unix system before transferring the program to their Macintosh.
  70.  
  71. If you don't already have BinHex 4.0, it would be easiest to get it from a
  72. friend or user group. Or, if you know how to do an 8-bit binary download, you
  73. can FTP it from us as /util/binhex4.bin. Unfortunately, a little bit of
  74. pulling yourself up by the bootstraps is required.
  75.  
  76. Please note that we cannot test software for reliability on all Macintosh
  77. configurations. As the software in this archive is generally non-commercial,
  78. it may be less reliable and more prone to crashes than you are used to.
  79.  
  80. We highly recommend that you maintain an active backup procedure to protect
  81. yourself even in the event of a system crash that results in the loss of
  82. some of your data. Download and use all software in this archive at your own
  83. risk.
  84.  
  85. The Info-Mac Moderators
  86. info-mac-request@sumex-aim.stanford.edu
  87.