@database "InternetSignup.guide"
@author "Fredrik Rambris"
@remark "$VER: InternetSignup Guide 0.9 (16.5.97)"
@WORDWRAP
@node MAIN "Welcome"

@{b}InternetSignup@{ub}

    This document contains all the information needed to use the InternetSignup program.

 @{"Copyrights    " LINK "COPYRIGHTS"}
 @{"Background    " LINK "BACKGROUND"}
 @{"Description   " LINK "DESCRIPTION"}
 @{"Installation  " LINK "INSTALLATION"}
 @{"Usage         " LINK "USAGE"}
 @{"Future        " LINK "FUTURE"}
 @{"History       " LINK "HISTORY"}
 @{"Author        " LINK "AUTHOR"}

@endnode

@node COPYRIGHTS "Copyrights"

 @{b}@{u} Copyright @{uu}@{ub}
InternetSignup © 1997 Fredrik Rambris
InternetSignup is freeware. It may be freely distributed as long as no fee is taken and as long as it's unmodified. Permission granted for Aminet to distribute it on the net, their CDs etc. It may not be included as a part of a product without my written permission!

 @{b}@{u} Disclaimer @{uu}@{ub}
The program executable and information above is provided "as is".  No representations or warranties are made with respect to the accuracy, reliability, performance, currentness, or operation of this software and information, and all use is at your own risk.  The author doesn't assume any responsibility or liability whatsoever with respect to your use of the program and information.

@endnode

@node BACKGROUND "Background"

A recently I got my self a news Internetprovider which used Microsoft's Internet Explorer Application Kit®. It allowed me to register the Internet-account within seconds. This is how it works:

In the box where a code which is individual for each Intenret-account. When I installed the software (on a PC) it installed Microsoft Internet Explorer® and then connected to my new provider with some generic logins and passwords and loaded MSIE which connected to a registration page at my provider. I was here asked to enter my code and then name, adress etc. My account details where then displayed and ready for print-out. I also could let it configure Windows95® automaticly and it worked very smoothly.

Now, I wanted to do this on my Amiga. I analysed the file which was sent (that MSIE autohandled) and made a program to analyse it and config Miami, YAM and mNews.

@endnode

@node DESCRIPTION "Description"

InternetSignup convert ISP-files generated by Microsoft Internet Explorer Application Kit when registrating an Internet acount online and convert it to configfiles for Miami, YAM and mNews (more to come... see @{"Future" LINK "FUTURE"}).
In short: It allows your Amiga to online-register Internet-acounts

@endnode

@node INSTALLATION "Installation"

[An installerscript will be written soon]

Shouldn't be too hard. Just copy the mainfile to wherever you like (I use NET: where all my other net-things are).
Copy the catalogfile to locale (Eg. LOCALE:Catalogs/Svenska)
Configure your browser MIME-types like the examples below. Don't forget to enter the whole path to the mainfile (eg. Net:InternetSignup)

@{"IBrowse" LINK pics/ibrowse.iff/main} - How I configured my IBrowse
@{"Voyager" LINK pics/voyager.iff/main} - How I configured my Voyager NG

@endnode

@node USAGE "Usage"

At the moment InternetSignup does only support CLI-arguments so you have to stick with CLI (or your web-browser) to use it. In a near @{"Future" LINK "FUTURE"}) it will support wb-arguments.

When just calling InternetSignup you get a copyright-notice and a argument template.
Here are the parameters

@{b}FILE@{ub} which ISP-file to read

@{b}PUBSCREEN@{ub} which Publicscreen to put the requester on
	eg. @{b}InternetSignup Ram:reg.ins MIAMI PUBSCREEN "Internet"@{ub}

@{b}ENV@{ub} enables reading the paths of the programs from a config-file in ENV: (env:InternetSignup.config). The program accept three paths in this file.
	@{b}miamipath=@{ub}
	@{b}yampath=@{ub}
	@{b}mnewspath=@{ub}
	one or more of these can be present in the configfile.
	eg. mNewsPath=Net:mNews
	
@{b}MIAMI@{ub}, @{b}YAM@{ub} and @{b}MNEWS@{ub} these are switches to enable configuration of corresponding program. Say you don't have YAM, you then just omit the YAM switch.

@{b}MIAMIPATH@{ub}, @{b}YAMPATH@{ub} and @{b}MNEWSPATH@{ub} These set the paths of where to write the configurationfiles.
	eg. mNewsPath Net:mNews


The path-selector is really smart in InternetSignup. It first checks if Miami: or YAM: are present and uses them if no other path is given. If ENV it reads the paths from env:InternetSignup.config but only if they exist. If Miami: is present and Miamipath= is absent in configfile, Miami: will be used. If MIAMIPATH is given on the commandline that will be used.
In short:	1. Default assigns
		2. ENV
		3. Commandline paths

You need atleast two arguments. ISP-file and a switch to the program you want to configure. You can ofcause have more than one.
Ex. @{b}InternetSignup ram:reg.ins MIAMI@{ub} will read in ram:reg.ins and configure Miami if the Miami: assign exists. A typical example could be to have the mNews path in env:InternetSignup.config, have Miami: and YAM: assigned and use ENV on the commandline.
Ex. @{b}InternetSignup ram:reg.ins ENV MIAMI YAM MNEWS@{ub}

@endnode

@node FUTURE "Future"

· WB support. Yep! The code is already structured to handle arguments from several places. This will allow you to have your programpaths and other default things in the icon as tooltyes. Also let the ISP file have an icon with InternetSignup as default tool etc. This gives much more flexibility to the program. This will be in the 1.0 version.

· Ability to configure IBrowse, VoyagerNG, MicrodotII, AmFTP.

· Script support. As of today it doesn't convert the scripts but uses a standard PAP/CHAP script (just dial and wait for carrier). This will be in 2.0 if there is a demand for it.

· GUI config? Don't think it's neccessary.

· Better english? =) Yep... this doc is flul of sppellkingh errrrrorssz.

· 3D engine to navigate through options? Isn't that Windows 2000?

· 060 optimised? Doh! Why?

· PPC and/or pOS version?  DEFINITLY!

@endnode
@node HISTORY "History"

@{u}Version 0.9@{uu}: @{b}FIRST VERSION@{ub}

@endnode
@node AUTHOR "Author"

This program and documentation is written by Fredrik Rambris. If you want to get in contact with me try these things:

    email:	boost@bigfoot.com  (prefered)
      irc:	BOOST on EfNet (/who *|*@*.algonet.se)
 homepage:	http://hem1.passagen.se/frambris @{"IBrowse" rxs "if show('P','IBROWSE') then do;address IBROWSE;'GOTOURL http://hem1.passagen.se/frambris';end"} @{"Voyager" rxs "if show('P','VOYAGER') then do;address VOYAGER;'OPENURL http://hem1.passagen.se/frambris';end"}
snailmail:	Fredrik Rambris
		Blåeldsv. 14a
		S-231 75  BEDDINGESTRAND
		SWEDEN

@endnode