


			  CONTRIB READ ME FIRST



			   Hewlett-Packard Co.


       This product is not supported by	Hewlett-Packard	Company.
       For more	details, see the CONTRIB Data Sheet.

		   ____________________________________
		  |	      IMPORTANT	NOTE	      |
		  |				      |
		  |    You may NOT want	to install    |
		  |	  all files on CONTRIB.	      |
		  |    Names and locations of some    |
		  |   files in CONTRIB conflict	with  |
		  |	supported files	in HP-UX.     |
		  |				      |
		  | Read the Installation instructions|
		  |	 below before installing      |
		  |	  to make sure that you	      |
		  |		  DO NOT	      |
		  |	 overwrite existing files     |
		  |	 which you want	to keep.      |
		  |				      |
		  |___________________________________|


       1.  INSTALLATION

       The contents of this product may	be installed using the HP-
       UX tcio and cpio	commands.  Some	parts of CONTRIB are
       contained in Named Cpio Archives	(NCAs).	 These are located
       in usr/contrib/src and have the suffix '.nca'.  These may be
       unpacked	with the command 'cpio -icv < subsystem_name.nca'.
       Source for Gnuemacs (200/300 only) is additionally
       'compressed'.  It may be	unloaded by typing 'uncompress
       gnuemacs.nca.Z'.	 This will produce an NCA file which may be
       unpacked	as above.1

       To review the contents of CONTRIB, insert the tape in your
       cartridge tape drive, refered to	below as /dev/rct, and type
       the command:

	    cd /; tcio -i /dev/rct | cpio -itv



       __________

	1. Gnuemacs source requires about 6.5 MB of additional disc
	   space.  You needn't unpack the source: it is	provided
	   only	to comply with requirements of the author.












				  - 2 -



       This will produce a listing on stderr of	the contents of	the
       tape.

       To unload the contents of the tape without destroying any
       supported commands or files, type:

	    tcio -i /dev/rct | cpio -icvdf 'bin*' 'usr/bin*' 'usr/lib/mailx*' 'usr/lib/sendmail*'

       This will not unpack the	files required for sendmail, which
       may be provided in a supported version on your system.

       In general, to unpack the tape run the command

	    tcio -i /dev/rct | cpio -icvd patterns

       If you do not have sendmail, but	wish to	use the	one on
       CONTRIB,	use the	pattern	'usr/lib/sendmail*'.  In addition
       your will need to pick up the new mail facilities which
       support sendmail	(mail, rmail and mailx)	by using the
       patterns	'bin*' 'usr/bin*' 'usr/lib/mailx*'.

       All of the files	required for the 'notes' facility may be
       extracted with the pattern 'tmp*'.

       To extract everything from the tape, just leave patterns
       out.  This causes cpio to pick up all files on the tape.


       2.  DISK	REQUIREMENTS

       CONTRIB requires	about 12 Megabytes of disk space on the
       Series 500 and about 15 Megabytes on the	200/300.  See the
       footnote	for additional information.


       3.  REMOVAL

       After installation you may trim down disk requirements by
       selectively removing files.  Most files are located in the
       directory /usr/contrib.	Notable	exceptions are the mail
       routines	cited above and	the following:

		    __________________________________
		   | subsystem	  |  location	     |
		   |______________|__________________|
		   | notes	  |  /tmp/notesdir   |
		   | mkdev/lsdev  |  /usr/lib/devinfo|
		   | vt, ptydaemon|  /etc	     |
		   |______________|__________________|

       Be cautious when	removing files from locations other than











				  - 3 -



       /usr/contrib, since accidents may render	your system
       useless.	 You may also remove all of CONTRIB with the sysrm
       command,	but as a safeguard, the	fileset
       /etc/filesets/ACONTRIB has been altered so that you will
       have to edit it first to	reduce the risk	of accidental
       removal of critical files.  You should be able to recognize
       the fileset changes required by inspection of the file.
       Sysrm is	described in the TOOLBOX section of the	HP-UX
       System Administrators Manual.


















































