=======================================================================
PURPOSE
=======================================================================
	Convert NCSA MOSAIC HOT lists to NETSCAPE HTML Bookmark files.
	Do NOT use on the MOSAIC.INI file.  If the URL hotlist is
	kept in the MOSAIC.INI file, the MENU information CAN be cut
	out of the MOSAIC.INI file, pasted in a new file, and then
	the new file CAN be processed.  The program must be run from
	DOS or a DOS Shell from within Windows.

=======================================================================
HOW TO
=======================================================================
Step:

0.	From Windows shell to DOS.

1.	Run ncsa2net.exe at the command prompt using the following
	syntax without the quotes:
	"ncsa2net boeing.hot > nboeing.htm"

	NOTE: the '>' output redirection character.  This is necessary
	or else the output will simply go to the screen and the
	"nboeing.htm" file will NOT be created.

	The mosaic.hot file is what ever hot list file you made
	with Mosaic.  Mosaic is packaged with the file "default.hot"
	and this may be the file you are using.  The file is found in
	the directory Mosaic is in.

2.	Move the resulting "nboeing.htm" file to the NETSCAPE directory.

3.	In the NETSCAPE menu system, navigate to the menu selection
	"Import".  The sequence is; Bookmarks -> View Bookmarks.. ->
	File -> Import.

4.	Select the "nboeing.htm" file you created with ncsa2net.exe and
	say "OK".

That's all there is to it!  You can now delete the "nboeing.htm" file and
the contents of this ZIP file.

=======================================================================
CONTENTS, PROGRAM STATUS & DISTRIBUTION
=======================================================================
	ncsa2net.c		C Source for program.
	ncsa2net.exe		DOS program.
	readme.txt		THIS FILE.
	changes.txt		What's new in the program.
	file_id.diz		BBS index file.
	makefile		Borland Turbo C makefile for DOS
	makefile.unx		gcc makefile for UNIX
	mosaicv1.hot		Mosaic v1.x HOT list sample file.
	boeing.hot		Mosaic v2.x HOT list sample file.

This is a FREE program.  Freely distribute this archive!
The C source is portable to UNIX machines.

=======================================================================
AUTHOR
=======================================================================
C Source written by Kevin Georgison.
105 Antrim Rd, Winnipeg, Manitoba, Canada
http://www.mbnet.mb.ca/~georgkev
georgkev@mbnet.mb.ca
ljs263@freenet.mb.ca

=======================================================================
PROGRAM CAPABILITIES & KNOWN BUGS 
=======================================================================
The ncsa2net.exe program will preserve the NCSA Mosaic HOT list menu
structure.  The NCSA Mosaic HOT list can have a maximum menu tree
structure of 64 levels deep.  The number of menus are unlimited.  Any
submenu MUST follow the menu it is contained in.

eg.

User Menu 3 is a submenu (Item1) of User Menu 0 and User Menu 3 follows
User Menu 0.

[User Menu0]
Menu_Name=Starting Points
Menu_Type=TOPLEVEL
Item0=Starting Points Document,http://www.ncsa.uiuc.edu/StartingPoints.html
Item1=MENU,UserMenu3
	.
	.
	.
[User Menu3]
Menu_Name=Home Pages
Item0=The University of Illinois,http://www.ncsa.uiuc.edu/UofI_intro.html
	.
	.
	.

If a submenu precedes the menu it is contained in, the submenu will be
processed as a "root level" menu and be excluded from the menu it should
have been contained in.  The menu structure of the NCSA MOSAIC HOT list
(boeing.hot) will not have been fully preserved in the new NETSCAPE
bookmark file (nboeing.htm) but the resulting NETSCAPE bookmark file
(nboeing.htm) can still be imported into the NETSCAPE book mark file
(bookmark.htm).

=======================================================================
			END OF DOCUMENT
=======================================================================
