home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1994 March / Source_Code_CD-ROM_Walnut_Creek_March_1994.iso / unix_c / readme.unx < prev    next >
Encoding:
Text File  |  1993-06-12  |  6.0 KB  |  147 lines
  1. Directories in the SIMTEL20 Unix-C Respository
  2. ----------------------------------------------
  3.  
  4. All the software in the UNIX-C repository is stored in subdirectories of the
  5. directory PD6:<UNIX-C>.  You can "cd" to this directory and then issue a
  6. "dir" command to see a listing of all the subdirectories available to you;
  7. they will all be called "something.DIRECTORY".
  8.  
  9. The directories presently in the repository are as follows.  See the file
  10. 000-INDEX.TXT within each directory for a list of what it contains, or see
  11. the file PD6:<UNIX-C>000-MASTER-INDEX.TXT for a complete listing.
  12.  
  13. ARC-PROGS    - Software which implements the ARC library/archive utility
  14.           popular in the personal computer areas.
  15. BENCHMARKS    - Various programs for benchmarking UNIX and other systems.
  16. CALENDARS    - Programs for producing calendars, converting to and from
  17.           various date formats, reminder services, etc.
  18. CKERMIT        - The source for the latest UNIX versions of the KERMIT file
  19.           transfer protocol.
  20. CPM        - Utilities for moving data between UNIX and CP/M systems.
  21. DATABASE    - Database utilities.
  22. DIR-MGMT    - Tools for managing directory hierarchies.
  23. EDITORS        - Text editors.  GNU EMACS is stored in the GNU directory.
  24. FILE-MGMT    - Tools for manipulating files.
  25. GNU        - Software from Richard Stallman's GNU project.
  26. GRAPHICS    - Programs to do graphics, image processing, etc.
  27. INFO        - Miscellaneous text files that provide information about all
  28.           sorts of things.
  29. KERNEL        - Device drivers, system calls, and other things related to
  30.           the UNIX kernel.
  31. LANGUAGES    - Compileres, interpreters, cross-referencers, and subroutine
  32.           libraries for various programming languages, including Ada,
  33.           assembler, BASIC, C, Forth, FORTRAN, FP, LISP, LOGO,
  34.           Modula-2, OPS5, Pascal, and Smalltalk.
  35. MACINTOSH    - Software for moving data between UNIX systems and Apple
  36.           Macintoshes.
  37. MAIL        - Programs for manipulating and delivering electronic mail.
  38. NETWORKS    - Programs for dealing with networks such as TCP/IP.  UUCP
  39.           stuff is in the TELECOM directory.
  40. PRINTERS    - Device drivers and output filters for line printers, laser
  41.           printers, and so on.  Many programs here can be used to
  42.           convert from one format to another.
  43. SYSADMIN    - Tools for system administration.
  44. TAPES        - Programs for reading and writing magnetic tapes, performing
  45.           file system backups, etc.
  46. TELECOM        - Programs related to telecommunications, including stuff for
  47.           maintaining UUCP.
  48. TEXTPROC    - Tools for text processing - text formatters, spelling
  49.           checkers, etc.
  50. USENET        - Tools for sending, reading, and administering the USENET
  51.           network news.
  52. UTILS        - Miscellaneous utility programs that don't really fit into
  53.           one of the other categories.
  54. WINDOWS        - Windowing systems.
  55. XYZMODEM    - Programs which implement the XMODEM (and YMODEM and ZMODEM)
  56.           file transfer protocol.
  57.  
  58.  
  59. Handy Files to Know About
  60. -------------------------
  61. The following files may prove useful to you:
  62.  
  63. PD6:<UNIX-C>000-MASTER-INDEX.TXT
  64.     The master index of all files in the repository, including short
  65.     descriptions of what each one contains.
  66.  
  67. PD6:<UNIX-C>000-INTRO-UNIX-SW.TXT
  68.     This file.  Check it from time to time for any new information
  69.     about the repository.
  70.  
  71. PD6:<UNIX-C>NEW-ADDITIONS.TXT
  72.     A listing in the same format as the *-INDEX.TXT files of additions
  73.     to the repository since the last UNIX-SW mailing.  These additions
  74.     will also be represented in the *-INDEX.TXT files.  This is the
  75.     file which will be sent out to the UNIX-SW mailing list from
  76.     time to time (probably monthly or bi-monthly).
  77.  
  78. PD6:<UNIX-C>FILES.IDX
  79.     A listing of all the files and directories in the archive.
  80.  
  81. PD6:<UNIX-C.subdir>000-INDEX.TXT
  82.     A file list 000-MASTER-INDEX.TXT, except for the files in this
  83.     subdirectory only.
  84.  
  85.  
  86. Specifics on Transferring Files
  87. -------------------------------
  88. Most of the files in the UNIX-SW repository are ASCII files, and you can
  89. transfer them directly.  However, there are some types of files which
  90. are stored in TOPS-20 binary format, which cannot be transferred as ASCII
  91. files.  These files all have file types of .ARC, .TAR, .TAR-Z, or any
  92. other file type which ends in "-Z".
  93.  
  94. To transfer these files, you need to do something special before you use
  95. the FTP "get" command:
  96.  
  97.     - If you are on a TOPS-10, TENEX, TOPS-20, or ITS system, you can
  98.       use "image" or "paged" mode for ALL files you transfer.
  99.  
  100.     - If you are on a UNIX system, you should use "ascii" mode for
  101.       ASCII files, and "tenex" mode for binary files.  To do this,
  102.       you can enter:
  103.  
  104.           ftp> type ascii        for ASCII files, and
  105.  
  106.         ftp> type l 8        (that's lower-case-L 8) or
  107.         ftp> type tenex        for BINARY files
  108.  
  109.     - On MULTICS, you can use "ascii" mode for ASCII files, but
  110.       binary files require that you enter:
  111.  
  112.           user_ftp: !quote "type l 8"
  113.  
  114.       This will store the file with one 8-bit byte per 9-bit word.
  115.  
  116. If you cannot use "tenex" mode and have to use "binary" mode (which is
  117. "type l 32"), you should get a copy of PD6:<UNIX-C.UTILS>BINTNX.C or
  118. BINTNXVMS.C.  These programs convert files transferred in "binary"
  119. format to "tenex" format, like they should be.
  120.  
  121.  
  122. Submitting Software to the UNIX-C collection
  123. --------------------------------------------
  124. If you have a program you'd like to submit to the repository, please
  125. send a message to Action@WSMR-SIMTEL20.ARMY.MIL.  In the message,
  126. describe the program, what version(s) of UNIX it runs on, what it's
  127. for, and so on.
  128.  
  129.  
  130. The Obligatory Cover-Our-Behinds Statement
  131. ------------------------------------------
  132. All the software in the UNIX-SW repository is provided AS IS with NO
  133. WARRANTY.  We cannot guarantee that it is good for any particular
  134. purpose, or even that it works.
  135.  
  136. I make an attempt to examine the software submitted to me to at least
  137. make sure it doesn't contain Trojan horses and what-have-you, and the
  138. moderator of comp.sources.unix, where a lot of this stuff comes from,
  139. also does this.  But, as with all free software written by strangers,
  140. MAKE SURE YOU KNOW WHAT YOU'RE INSTALLING BEFORE YOU INSTALL IT!
  141.  
  142.  
  143. Final Words
  144. -----------
  145. If you have any questions, comments, or suggestions, please feel free
  146. to send mail to: Action@WSMR-SIMTEL20.ARMY.MIL
  147.