// 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 ). Then it checks the text again with the '2. ID' and if it has success it types the word behind '2.' (and a ), 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