// 27-Mar-95 Guidance WWW-Browser

0. Preliminary remarks 
1. Installation
1.1. Unix
1.1.1. Way of Connection
1.1.2. Programs
1.2. Newton
1.2.1. The WWW-Brouser
1.2.2. Settings
1.2.2.1. Demo-mode
1.2.2.2. serial-mode
1.2.2.3. Modem-mode
1.2.2.4. modem-permanent-mode
2. Known Bugs/Problems

0. Preliminary remarks
The program is tested on a Newton MP100 and MP120 (with at least
120kBytes free memory) in conjunction with an Alpha-Workstation from DEC
or a SUN-Workstation (SUN-OS) and the right cable.


1. Installation

Unzip the file 'newton-www.gz' and untar it. It includes the following
files:
readme.txt		this file 
giftopbm		1-line-script to convert picts
			(it needs the programs 'pgmtopbm', 'ppmtopgm',
			'giftoppm')
server.alpha		DEC-Alpha-Binary for Unix OSF/1
newton.alpha		DEC-Alpha-Binary for Unix OSF/1
server.sunos		SUN-OS-Binary for Unix
newton.sunos		SUN-OS-Binary for Unix
w3.prj.pkg.hqx		Package for the Newton.
licence.txt 		The Licence

1.1. Installation - Unix

1.1.1. Way of Connection

Modem-Connection:
It must be possible to start the program server.XXX in the working
directory with the name 'server'. The working directory is the directory
where the
modem-connection ends after a login. (Normally your home-directory). If
you like to see graphics on the newton, you need the script 'giftopbm'
in the same directory, also (links or paths to) 'pgmtopbm', 'ppmtopgm',
'giftoppm'. 

Serial-Connection:
It must be possible to start the program server.XXX (with the name
server) in the directory,
where you started the program newton.XXX. The same is good for the
four graphic programs.
 
1.1.2. Programs

Program 'newton.XXX':
(Rename it into newton). This program gets a unix-command from a "file" and
starts it in a shell. It writes the result back to the same "file". As a
file we are using the serial port (/dev/tty00 (alpha) or /dev-ttya (SUN)). For a test, you
can use your own window (newton /dev/tty). Now you can use normal commands to
execute them with the newton-program.
(Abort - Ctrl-C).
 

Script 'giftopbm', programs 'giftoppm', 'pgmtopbm', 'ppmtopgm'
The script changes graphics to b&w-newton-readable-graphics. It builds
the file "tmp1" and removes it after it has done its work.
Without these programs you can read text, but no pictures. If you click
on an image-pointer you get an error-message. The graphic-programs can
be copied from a ftp-server or from somewhere in your system.


1.2. Installation - Newton

1.2.1. WWW-Browser

Copy the file w3.prj.pkg to the mac and change the type and creator to 
'pkg ' and 'pkgX' (if neccessary) (for example with ResEdit).

After that, copy it to the newton with the NCK or something similar. It
takes about 120000 Bytes on the Newton. 

At the newton just start it. It is almost selfexplaining and works like
the wellknown Mosaic or Netscape. 
There are a few exeptions: 
The newton-browser splits big files into parts and save them outside (at
the unix-side). This is, because the newton has not enough memory to
take all the data inside.) If the next-button is highlighted you can get the next
block by typing on it. In a block you can scroll normally with the two
arrow-buttons.


1.2.2. Settings

Preferences-Connection

You can choose between 4 modes:

1.2.2.1.: demo-mode
This mode is just to show someone the WWW-Browser. The pages you can see
are from the inside. You can check the functionallity of the program,
too.

1.2.2.2.: serial
Connect the Newton and the serial port of the workstation. Then start 
the program newton. Now you can use the newton to start the 
program server by clicking on underlined words.
Allow one minute to show the page from the newton.
Make sure that the unix port is at 9600 Baud, no parity!

1.2.2.3/4.: modem-modes
The data goes over telephone-wires. Connect the modem to the newton and
type in all information it needs into the preferences file. It works the
following way:
 The Login-"Script" checks the incoming text if it can find the '1. ID'. 
If so, it sends
the word typed behind the '1.' (and a <RETURN>). Then it checks
the text again with the '2. ID' and if it has success it types the word
behind '2.' (and a <RETURN>), and so on...
You can use four steps to connect to your host and login. Be aware that
your password is saved in the newton. After using the program change it
into another word. 
In very ID you need at least one character.
If you dont need any more IDs, set to your cursor, and just don't type in
anything in the text fields below. So the newton sends a few returns
in your unix-window and nothing important happens...
(We had a bit of a problem with that, so if  it doesn't work, change the ID-texts
(if possible...)).

Example:
The settings are:
Number: 0721-123456
1. Id: login:
1.: ira
2. Id: connect to:
2.: freedy
3. Id: :
3.: guest
4. Id: password:
4.: guest

Make sure that your cursor contains a '>' somewhere...
If you use modem(d) the modem dials only once and hangs	up the line
when you change the connection mode or when you quit the program.

2. Known Bugs/Problems

Modem-Connection: If the telephone is busy the WWW-Browser thinks,
everything is alright and is waiting for data. You can quit the
application or just change the buttons in the preferences-menu from
modem(d) to demo (wait a second) and back to modem(d). If that does not
work (and it should), restart the application or use the RESET-Button...

There is an error in the hotlist-function. Sometimes some of the
entries gets corrupted.

You need time!!!
It takes up to a minute, till you can see a page. If you click too fast
(two times on the same link), newton will tell you to wait.
So: click, wait, read, click, wait, read, click,
wait, read (and call Apple to ask them for a faster Newton), click,
wait,...

If you didn't install the graphic-programs, and you click on an image,
you get an error. After that, the back-Button doesn't work properly.

There are some problems with the textwindow. Sometimes the newton
does not show the textstyles properly, so you cannot see the links.
This bug is an error in the newton system and we found no workaround...
Just order the page again or click to where you think the links are.

...there are some other (hopefully smaller) bugs....



Have fun using the browser!!


Please, if you find a bug or if you have some install-problems, write
to:
newton@tk.telematik.informatik.uni-karlsruhe.de
If you have questions about licence and what happens next, write to:
stefan@tk.telematik.informatik.uni-karlsruhe.de