home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Standards 1993 July / Disc.iso / inet / resguide / readme. < prev    next >
Encoding:
Text File  |  1992-11-05  |  9.9 KB  |  275 lines
  1.  
  2.                           How to Get and Use
  3.                                  the
  4.                         INTERNET RESOURCE GUIDE
  5.                     by FTP
  6.  
  7.  
  8.     This README document contains, first, a discussion of the Internet
  9. Resource Guide, and then (for those who need them), nitty-gritty
  10. details about PostScript files, FTP, and the Unix commands "compress,"
  11. "uncompress," and "tar."
  12.  
  13.     The Internet Resource Guide hierarchy is organized as follows.
  14.  
  15.     All FTP-able files are in the "resource-guide" directory.  The
  16. individual entries are organized by chapter and section.  Each chapter
  17. has its own directory, and each section has its own files, one for
  18. PostScript and one for plain text (ASCII).
  19.  
  20.     So, to retrieve both files for section 1.1 of chapter 1, you
  21. should use the "cd" (change directory) command to go to the
  22. appropriate "chapter.?" directory in the "resource-guide" directory,
  23. and then FTP the section files
  24.  
  25.     ftp> cd resource-guide/chapter.1
  26.         ftp> ftp section1-1.ps
  27.         ftp> ftp section1-1.txt
  28.  
  29.     To simplify retrieval of entire chapters and chapter updates, or of
  30. the entire resource guide, we have put compressed tar files in the.  
  31. "resource-guide" directory.
  32.  
  33.     The compressed tar files for the entire resource guide are
  34.  
  35.     resource-guide/resource-guide.ps.tar.Z      (PostScript)
  36.     resource-guide/resource-guide.txt.tar.Z      (Text)
  37.  
  38. The tar files for individual chapters include the recently updated
  39. sections; there is a file for PostScript versions and another file for
  40. text versions.
  41.  
  42.         resource-guide/chapter1-ps.tar.Z            (PostScript)
  43.         resource-guide/chapter1-txt.tar.Z            (Text)
  44.  
  45.     The most recent changes to each chapter are in files named
  46. chapter#-changes.tar.Z.  These include the Postscript and text versions,
  47. of only the most recently updated sections.  
  48.  
  49.         resource-guide/chapter1-changes.ps.tar.Z        (PostScript)
  50.         resource-guide/chapter1-changes.txt.tar.Z       (Text)
  51.  
  52.     Finally, there is a single compressed but not tarred Text file for
  53. the whole guide in the the resouce-guide directory.  
  54.  
  55.     resource-guide/wholeguide.txt.Z                 (Text)
  56.  
  57.  
  58.                 *       *       *       *       *       *
  59.  
  60.  
  61.                     NITTY-GRITTY INFORMATION ABOUT
  62.                POSTSCRIPT, FTP, COMPRESS, AND TAR FILES
  63.  
  64.    (If you already know all this, just skip the rest of this message.)
  65.  
  66.  
  67. A NOTE ABOUT POSTSCRIPT DOCUMENTS
  68.  
  69.     PostScript is a formatting language used to prepare documents for
  70. printing on advanced printers such as Apple LaserWriters and ... .
  71. PostScript files contain ASCII characters only, but are virtually
  72. unreadable because the text of the document is interspersed with
  73. numerous formatting commands and numeric symbols for printers'
  74. characters that are not part of the ASCII character set.
  75.  
  76. Do not attempt to print PostScript files unless you have a printer that
  77. is specifically designed for PostScript.
  78.  
  79.  
  80.  
  81. HOW TO USE THE FTP COMMAND
  82.  
  83.     You can FTP the resource-guide files from nnsc.nsf.net with a
  84. standard anonymous FTP connection:
  85.  
  86.         ftp nnsc.nsf.net
  87.  
  88.     (If you are using the Unix operating system, the command "ftp" must
  89. be typed in lowercase letters.  On other operating systems, it may be
  90. either uppercase or lowercase.)
  91.  
  92.     Important:  If you plan to use anonymous FTP, please note that the
  93. Internet Protocol (IP) addresses for NNSC.NSF.NET is now 128.89.1.178
  94. only.  If you have difficulty with the command "ftp nnsc.nsf.net" try
  95. using "ftp 128.89.1.178", instead.
  96.  
  97.     You will see a "banner" and be promted for your login:
  98.  
  99.         Connected to nnsc.nsf.net.
  100.         220 nnsc.nsf.net FTP server (Version 5.59 Mon May 14 13:48:21 EDT
  101.         1990) ready.
  102.         Name (nnsc.nsf.net:yourname):
  103.  
  104.     You should type "anonymous", and then use the password "guest".  The
  105. password will not be displayed on your terminal.
  106.  
  107.         Name (nnsc.nsf.net:yourname): anonymous
  108.         Password (nnsc.nsf.net:anonymous):
  109.         331 Guest login ok, send ident as password.
  110.         230 Guest login ok, access restrictions apply.
  111.         ftp>
  112.  
  113.     To see the FTP commands that are available to you, type ?  at the
  114. "ftp>" prompt.
  115.  
  116.     NOTE: Different operating systems have FTP commands with different
  117.     banners and commands.  Your FTP implementation may not look exactly
  118.     like the one shown here, but it should bave the same general
  119.     functionality.
  120.  
  121.     1)  Type the "status" command to check your file type.
  122.  
  123.             ftp> status
  124.             Connected to nnsc.nsf.net.
  125.             Mode: stream; Type: ascii; Form: non-print; Structure: file
  126.             Verbose: on; Bell: off; Prompting: on; Globbing: on
  127.             Hash mark printing: off; Use of PORT cmds: on
  128.  
  129.  
  130.     2A) IF YOU INTEND TO FTP ORDINARY TEXT FILES, including files that
  131.         end in ".txt" or ".ps", set your file type to ASCII.
  132.  
  133.         The ASCII setting is the same as TEXT.  This is the default.
  134.         Give the command
  135.  
  136.             ftp> type ascii
  137.             200 type set to A.
  138.  
  139.     2B) IF YOU INTEND TO FTP NON-ASCII FILES, including compressed files
  140.     that end in ".Z" or object files, set your file type to BINARY.
  141.  
  142.         The BINARY setting is the same as IMAGE.  Give the command
  143.  
  144.             ftp> type binary
  145.             200 Type set to I.
  146.  
  147.     3)  Change directory to the "resource-guide" directory:
  148.  
  149.             ftp> cd resource-guide
  150.  
  151.     4)  To get a listing of all the files in the resource-guide
  152.     directory, give the "dir" command (usually equivlent to the
  153.     "ls -ls" command on Unix systems).
  154.  
  155. ftp> dir */*
  156. ...
  157. -rw-rw-r--  1 12889    nnsc        11882 May 29 02:38 chapter.1/section1-9.ps
  158. ...
  159.  
  160.         section1-9.ps is in the chapter.1 directory.  Use the "cd"
  161.         command again.
  162.  
  163. ftp> cd chapter.1
  164. ftp> get section1-9.ps
  165.  
  166. HOW TO UNCOMPRESS AND EXTRACT THE tar.Z FILES
  167.  
  168.     Do not attempt to use the tar.Z files unless you have the Unix
  169. "compress" and "uncompress" commands and the "tar" command on your host
  170. computer, and your operating system is compatible with Berkeley Unix.
  171.  
  172. A.  HOW TO INSTALL A COPY OF THE ENTIRE RESOURCE-GUIDE
  173.  
  174.   A.1)  To install a new copy of the entire resource-guide, first use
  175.     the "mkdir" command to make a new directory named "resource-guide",
  176.     to hold the new files and directories:
  177.         mkdir resource-guide
  178.  
  179.     Now, "cd" to that directory
  180.         cd resource-guide
  181.  
  182.     FTP or copy the "ps" or "txt" tar file to that directory,
  183.     and type "ls -ls" to make sure it is there
  184.         ls -ls resource-guide.txt.tar.Z
  185.           216 ... nnsc       208871 Nov  6 10:30 resource-guide.txt.tar.Z
  186.  
  187.   A.2)  Use the  "uncompress" command to replace the compressed "Z" file
  188.         with a copy of the file as it was before "compress" was used:
  189.             uncompress -v resource-guide.txt.tar.Z
  190.             resource-guide.txt.tar.Z:  -- replaced with resource-guide.txt.tar
  191.  
  192.   A.3)  Use the command "tar -xvf" to replace the tar file with the
  193.     set of directories and files in the original directory.
  194.         tar -xvf resource-guide.txt.tar
  195.         
  196.     The tar command will display the names and sizes of all the
  197.         files that are extracted from the tar file.  When the command
  198.     is finished, your "resource-guide" directory will contain
  199.         a set of seven directories for Chapters 1 through 6 and M
  200.     the Internet Resource Guide.  The sections within each chapter
  201.     will be in individual files within the chapter directories.
  202.  
  203.     NOTE: The main directory for the Internet Resource Guide may
  204.               be given any name you wish; it does not have to be 
  205.               "chapter.2".
  206.  
  207.  
  208. B.  HOW TO INSTALL A COPY OF A SINGLE CHAPTER OF THE RESOURCE-GUIDE
  209.  
  210.   B.1)  To install a new copy of an entire chapter of the resource-guide,
  211.     for example, Chapter 2, first use the "mkdir" command to make a
  212.     new directory named "chapter.2", to hold the new files:
  213.         cd resource-guide
  214.         mkdir chapter.2
  215.  
  216.     Now, "cd" to that directory
  217.         cd chapter.2
  218.  
  219.     FTP or copy the "ps" or "txt" tar file to that directory,
  220.     and type "ls -ls" to make sure it is there
  221.         ls -ls chapter2-txt.tar.Z
  222.               33 ... nnsc        33693 Nov  6 10:30 chapter2-txt.tar.Z              
  223.  
  224.  
  225.   B.2)  Use the "uncompress" command to replace the compressed "Z" file
  226.         with a copy of the file as it was before "compress" was used:
  227.             uncompress -v chapter2-txt.tar.Z
  228.             chapter2-txt.tar.Z:  -- replaced with chapter2.txt.tar
  229.  
  230.   B.3)  Use the "tar -xvf" to replace the tar file with the set of
  231.         files in the original directory.
  232.         tar -xvf chapter2-txt.tar
  233.  
  234.     The tar command will display the names and sizes of all the
  235.         files that are extracted from the tar file.  When the command
  236.     is finished, your "chapter.2" directory will contain
  237.         a set of 27 (or more) files for the sections in Chapter 2.
  238.  
  239.     NOTE: The directory for the Chapter 2 files may be given any
  240.           any you wish; it does not have to be "chapter.2".
  241.  
  242.  
  243. C.  HOW TO INSTALL A "CHANGES" FILE IN YOUR RESOURCE-GUIDE DIRECTORY
  244.  
  245.  
  246.   C.1)  To install a copy of the changes to a entire chapter of the
  247.     resource-guide, for example, Chapter 2, first cd to the
  248.     directory that holds the files for Chapter 2.
  249.         cd chapter.2
  250.  
  251.     FTP or copy the "ps" or "txt" tar file to that directory,
  252.     and type "ls -ls" to make sure it is there
  253.         ls -ls chapter2-txt.tar.Z
  254.               33 ... nnsc        33693 Nov  6 10:30 chapter2-txt.tar.Z
  255.         
  256.     Allow the other files to remain in the directory.
  257.  
  258.   B.2)  Use the "uncompress" command to replace the compressed "Z" file
  259.     with a copy of the file as it was before "compress" was used:
  260.     uncompress -v chapter2-txt.tar.Z
  261.         chapter2-changes-txt-tar.Z:  -- replaced with chapter2-changes-txt.tar
  262.  
  263.   C.3)  Use the command "tar -xvf" to replace the tar file with the
  264.     set of directories and files in the original directory.
  265.         tar -xvf chapter2-changes-txt.tar
  266.  
  267.     When the command is finished, the files with changes will 
  268.     have replaced the original files in the Chapter 2 directory.
  269.         You may be prompted to approve each replacement.
  270.  
  271.      For more information about the action of these commands, consult the
  272. manual for your Unix system, or give the commands "man compress" and
  273. "man tar" for online documentation.
  274.  
  275.