WAPUniverse, a GNU WAP Browser for PalmOS. Copyright (c) 1999-2000 Filip Onkelinx

HTTP://WWW.WAPUNIVERSE.COM/
e-mail: filip@onkelinx.com

INSTALLING:
===========
!! DELETE OLDER VERSIONS BEFORE INSTALLING THIS RELEASE !!
If you downloaded the pre-compiled binary (wapuniverse.prc), just HotSync (tm) the produced WAPUniverse.prc to your handheld like any other prc-file. If you have a previous version installed, you MUST delete the old version !!
  
(see below for compiling instructions), 
TESTING:
========
In order to test WAPUniverse, you need to have a working internet connection using a Palm clip-on modem, a data capable mobile phone connected with a cable or using IrDA (infrared, PalmOS 3.3 or higher required) and access to a WAP Gateway.
Most mobile phone companies have WAP gateways installed and at the time of this writing, there are at least two public WAP gateways available on the internet (both are pre-configured):
195.58.110.201 (Ericsson Gateway) 
193.64.89.161 (Sonera Gateway)

If you want to serve your own WML files, you need to add the folowing MIME types to the Apache HTTP server:
Edit the srm.conf file (usually in /etc/httpd/conf) 
Locate the AddType section, and add the following section to the file: 

MIME Types for WAP 
AddType text/vnd.wap.wml .wml 
AddType image/vnd.wap.wbmp .wbmp 
AddType application/vnd.wap.wmlc .wmlc 
AddType text/vnd.wap.wmlscript .wmls 
AddType application/vnd.wap.wmlscriptc .wmlsc 
Save the file and restart the Apache HTTPd. 
If you do not have control over your Apache server, for instance if you are with an ISP, it is also possible to add a file called .htaccess to each directory where you have placed WML files. When the server reads files from this directory, it will serve them according to the rules in the .htaccess file. 

A typical .htaccess file will look something like this: 
DirectoryIndex index.html index.shtml index.php index.php3 index.phtml index.wml
addtype text/vnd.wap.wml wml 
addtype application/vnd.wap.wmlc wmlc 
addtype text/vnd.wap.wmlscript wmls 
addtype application/vnd.wap.wmlscriptc wmlsc 
addtype image/vnd.wap.wbmp wbmp 

COMPILING:
==========
WAPUniverse is being developed using the free GNU PRC-Tools, avaialable from: http://www.palmos.com/dev/tech/tools/gcc/

The IDE used is Falch.Net DeveloperStudio 2000 Palm Edition, available (free Beta) from http://www.falch.net/ . The WAPUniverse.FNP file is a project file for Falch.Net DevStudio. Alternatively, you should be able to build WAPUniverse with the supplied makefile. 

Disclaimer:
===========
WARNING! YOU CAN LOSE ALL DATA ON YOUR PALMOS HANDHELD BY RUNNING THIS ALPHA VERSION OF WAPUNIVERSE. YOU SHOULD BACK UP YOUR DEVICE BEFORE YOU RUN THIS SOFTWARE !

This is an alpha release of WAPUniverse, which means it is not feature complete and definitely not bug-free. USE AT YOUR OWN RISK !!

It is safer to test the software first on the PalmOS emulator, available from: http://www.palmos.com/dev/tech/tools/emulator/ 
(do not forget to enable 'Redirect Netlib calls to host TCP/IP'in Settings/Properties)

See the file 'BUGS.TXT' for a list of known bugs.


---------------------------------------------------------------------------
$Header: /cvsroot/wapuniverse/wapuniverse/INSTALL.TXT,v 1.6 2000/11/11 20:50:34 wapuniverse Exp $