Instructions for installing HTML online release notes
-----------------------------------------------------

These instructions will allow you to install the release notes for
the Networking Supplement Release 1.0 for SCO OpenServer Release 5.0
on a SCO OpenServer documentation server. It is assumed that you have
used ftp to copy the tar archive NETMS1.html.Z to a temporary location
on your system such as /tmp.
 
1.  Login as root on the machine that you use to serve documentation.

2.  Change directory to /usr/lib/scohelp:

	cd /usr/lib/scohelp

3.  Copy or move the tar archive NETMS1.html.Z to this directory.

4.  Extract the contents of NETMS1.html.Z into the subdirectory TCPMS:

	zcat NETMS1.html.Z | tar xvPf -

5.  Make the files readable to everyone:

	chmod -R a+r ./TCPMS  

6.  Make backup copies of the file dochome.html:

	cp dochome.html dochome.html.bak

    If you need to restore the contents of dochome.html from dochome.html.bak,
    use the command:

	cp dochome.html.bak dochome.html

7.  Edit the file dochome.html and insert the following lines before the line
    that contains the item </UL>:

	<LI>
	<A HREF=/TCPMS/CONTENTS.html>Networking Supplement Release 1.0</A>

    Save this version of the file.

Steps 8 through 11 are only necessary if you want to be able to perform
text searching on the release notes. Otherwise, skip to step 12:

8.  Make a backup copy of the file library.stz:

	cp library.stz library.stz.bak

    If you need to restore the contents of library.stz from library.stz.bak,
    use the command:

	cp library.stz.bak library.stz

9.  Edit the file library.stz and edit the definition of unixset to add an
    entry for TCPMS:

	unixset:
        name=UNIX Documentation
        members=OSAdminG,HANDBOOK,OSUserG,OSTut,PERFORM,TCPMS  

    This adds the release notes to the set of UNIX documentation that
    you can search.

10. Add the following lines to the end of the file library.stz, including
    a blank line to separate this entry from the previous entry:

	TCPMS:
        name=Networking Supplement Release 1.0
        index=TCPMS/TCPMS.ftindex
        set=unixset
        cgi_access=
        topics=TCPMS/TCPMS.stz

    This adds the book ``Networking Supplement Release 1.0'' to the list
    of books that you can search.

    Save this version of the file.

11. Stop and restart the scohelp server daemon using these commands:

	scohttp stop
	scohttp start

12. Run scohelp and test that you can read the release notes by clicking
    on the final item of those listed on the SCO Documentation Library
    home page. If the item does not appear, this may be because you were
    already running scohelp to view this page before you updated the file
    dochome.html. If you use a different home page, select Web Browser
    Mode from the Preferences menu, and open this URL:

	http://localhost/dochome.html 

    This assumes that you are running scohelp on the machine that is
    serving the documentation. Otherwise, substitute the name of the
    server for ``localhost''. 

Finally, remove the tar archive NETMS1.html.Z from /usr/lib/scohelp when
you are satisfied that the installation has been successful.