Directories in the SIMTEL20 Unix-C Respository
----------------------------------------------

All the software in the UNIX-C repository is stored in subdirectories of the
directory PD6:<UNIX-C>.  You can "cd" to this directory and then issue a
"dir" command to see a listing of all the subdirectories available to you;
they will all be called "something.DIRECTORY".

The directories presently in the repository are as follows.  See the file
000-INDEX.TXT within each directory for a list of what it contains, or see
the file PD6:<UNIX-C>000-MASTER-INDEX.TXT for a complete listing.

ARC-PROGS	- Software which implements the ARC library/archive utility
		  popular in the personal computer areas.
BENCHMARKS	- Various programs for benchmarking UNIX and other systems.
CALENDARS	- Programs for producing calendars, converting to and from
		  various date formats, reminder services, etc.
CKERMIT		- The source for the latest UNIX versions of the KERMIT file
		  transfer protocol.
CPM		- Utilities for moving data between UNIX and CP/M systems.
DATABASE	- Database utilities.
DIR-MGMT	- Tools for managing directory hierarchies.
EDITORS		- Text editors.  GNU EMACS is stored in the GNU directory.
FILE-MGMT	- Tools for manipulating files.
GNU		- Software from Richard Stallman's GNU project.
GRAPHICS	- Programs to do graphics, image processing, etc.
INFO		- Miscellaneous text files that provide information about all
		  sorts of things.
KERNEL		- Device drivers, system calls, and other things related to
		  the UNIX kernel.
LANGUAGES	- Compileres, interpreters, cross-referencers, and subroutine
		  libraries for various programming languages, including Ada,
		  assembler, BASIC, C, Forth, FORTRAN, FP, LISP, LOGO,
		  Modula-2, OPS5, Pascal, and Smalltalk.
MACINTOSH	- Software for moving data between UNIX systems and Apple
		  Macintoshes.
MAIL		- Programs for manipulating and delivering electronic mail.
NETWORKS	- Programs for dealing with networks such as TCP/IP.  UUCP
		  stuff is in the TELECOM directory.
PRINTERS	- Device drivers and output filters for line printers, laser
		  printers, and so on.  Many programs here can be used to
		  convert from one format to another.
SYSADMIN	- Tools for system administration.
TAPES		- Programs for reading and writing magnetic tapes, performing
		  file system backups, etc.
TELECOM		- Programs related to telecommunications, including stuff for
		  maintaining UUCP.
TEXTPROC	- Tools for text processing - text formatters, spelling
		  checkers, etc.
USENET		- Tools for sending, reading, and administering the USENET
		  network news.
UTILS		- Miscellaneous utility programs that don't really fit into
		  one of the other categories.
WINDOWS		- Windowing systems.
XYZMODEM	- Programs which implement the XMODEM (and YMODEM and ZMODEM)
		  file transfer protocol.


Handy Files to Know About
-------------------------
The following files may prove useful to you:

PD6:<UNIX-C>000-MASTER-INDEX.TXT
	The master index of all files in the repository, including short
	descriptions of what each one contains.

PD6:<UNIX-C>000-INTRO-UNIX-SW.TXT
	This file.  Check it from time to time for any new information
	about the repository.

PD6:<UNIX-C>NEW-ADDITIONS.TXT
	A listing in the same format as the *-INDEX.TXT files of additions
	to the repository since the last UNIX-SW mailing.  These additions
	will also be represented in the *-INDEX.TXT files.  This is the
	file which will be sent out to the UNIX-SW mailing list from
	time to time (probably monthly or bi-monthly).

PD6:<UNIX-C>FILES.IDX
	A listing of all the files and directories in the archive.

PD6:<UNIX-C.subdir>000-INDEX.TXT
	A file list 000-MASTER-INDEX.TXT, except for the files in this
	subdirectory only.


Specifics on Transferring Files
-------------------------------
Most of the files in the UNIX-SW repository are ASCII files, and you can
transfer them directly.  However, there are some types of files which
are stored in TOPS-20 binary format, which cannot be transferred as ASCII
files.  These files all have file types of .ARC, .TAR, .TAR-Z, or any
other file type which ends in "-Z".

To transfer these files, you need to do something special before you use
the FTP "get" command:

	- If you are on a TOPS-10, TENEX, TOPS-20, or ITS system, you can
	  use "image" or "paged" mode for ALL files you transfer.

	- If you are on a UNIX system, you should use "ascii" mode for
	  ASCII files, and "tenex" mode for binary files.  To do this,
	  you can enter:

	  	ftp> type ascii		for ASCII files, and

		ftp> type l 8		(that's lower-case-L 8) or
		ftp> type tenex		for BINARY files

	- On MULTICS, you can use "ascii" mode for ASCII files, but
	  binary files require that you enter:

	  	user_ftp: !quote "type l 8"

	  This will store the file with one 8-bit byte per 9-bit word.

If you cannot use "tenex" mode and have to use "binary" mode (which is
"type l 32"), you should get a copy of PD6:<UNIX-C.UTILS>BINTNX.C or
BINTNXVMS.C.  These programs convert files transferred in "binary"
format to "tenex" format, like they should be.


Submitting Software to the UNIX-C collection
--------------------------------------------
If you have a program you'd like to submit to the repository, please
send a message to Action@WSMR-SIMTEL20.ARMY.MIL.  In the message,
describe the program, what version(s) of UNIX it runs on, what it's
for, and so on.


The Obligatory Cover-Our-Behinds Statement
------------------------------------------
All the software in the UNIX-SW repository is provided AS IS with NO
WARRANTY.  We cannot guarantee that it is good for any particular
purpose, or even that it works.

I make an attempt to examine the software submitted to me to at least
make sure it doesn't contain Trojan horses and what-have-you, and the
moderator of comp.sources.unix, where a lot of this stuff comes from,
also does this.  But, as with all free software written by strangers,
MAKE SURE YOU KNOW WHAT YOU'RE INSTALLING BEFORE YOU INSTALL IT!


Final Words
-----------
If you have any questions, comments, or suggestions, please feel free
to send mail to: Action@WSMR-SIMTEL20.ARMY.MIL