
                            Warpzilla - READ.ME
                            -------------------

Welcome to Warpzilla.

This file contains information you need to install Warpzilla,
additional information not included in Mozilla documentation,
and specific instructions for OS/2.

This README file is divided into the following sections:

   -  What is Warpzilla?
   -  Before You Install Warpzilla
       -Software Requirements
       -Hardware Requirements
   -  Getting Help
   -  Installing Warpzilla
       -Localhost
   -  Running Warpzilla
       -Commandline launch
       -Startup URL
       -Redirection
       -First-launch registration
       -Additional programs
   -  Acknowledgements
   -  License


What is Warpzilla?
------------------

Warpzilla is the OS/2 port of the Mozilla browser, editor and
mailnews client. It is open-source software governed by the
Mozilla Public License.

The components are designed for standards compliance, performance
and portability. This release is not the final product, but
a preview subject to the usual limitations of beta-quality software
such as missing features, incomplete functionality and sudden
crashes. Users are encouraged to detect and report problems.

The source code can be viewed online at http://lxr.mozilla.org.


Before You Install Warpzilla
----------------------------

   Software Requirements
   ---------------------

   OS/2 Warp 3 (fixpack 32 or newer)
   OS/2 Warp 4 (fixpack 6 or newer)
   OS/2 Warp Server Version 4.0 (fixpack 32 or newer)
   OS/2 Warp Server Advanced Version 4.0 (fixpack 32 or newer)
   OS/2 Warp Server Advanced SMP Feature (fixpack 32 or newer)
   OS/2 Warp Server for e-business (no fixpack required)
   WorkSpace On-Demand 2.0

   Warpzilla must be installed on a partition that supports
   long filenames, i.e. HPFS or JFS.

   To run a gcc build of mozilla, you need the EMX runtime (emxrt.zip
   at Hobbes or LEO) and, if you don't have pgcc installed, gcc2952m.dll
   available in:
   http://www.axess.com/users/sobotka/warpzilla/binaries/gcc2952m.zip.

   No extra files are needed for VisualAge builds.


   Hardware Requirements
   ---------------------

   A computer capable of running OS/2.


Getting Help
------------

You can visit our website at: http://www.mozilla.org/ports/os2
or our newgroup at news.mozilla.org, netscape.public.mozilla.os2.

If you're a developer, you might want to have a look at the new
documentation at http://developer.netscape.com/tech/gecko/ for
detailed information about the browser's capabilities.

To report bugs, please follow the procedure described in
http://www.axess.com/users/sobotka/warpzilla/bugs.html.


Installing Warpzilla
--------------------

1) Run install.exe to start the installation.
2) Follow the instructions by the installation.

There is no need to reboot after the installation is finished.

Profiles are stored in a Users50 subdirectory that gets created at the
same level as /bin, so it's best to install into a /warpzilla directory
to keep both together. This release should not be installed on top of any
previous Warpzilla installation.


   Localhost
   ---------

   You must have localhost configured on your system for mozilla to run.
   If you're not sure you do, type "ping localhost" at a command prompt.
   You should see:

        PING localhost: 56 data bytes
        64 bytes from 127.0.0.1: icmp_seq=0. time=0. ms

   If you don't, you can use TCP/IP configuration to set it.


Running Warpzilla
-----------------

   Open the Warpzilla folder on your desktop, and click on the icon for the
   component you want to launch.

   Commandline launch
   ------------------

   The main binary is mozilla.exe. The launch command takes the following form:

                mozilla [options] [URL] [redirection]

   Options

   -height <value>                 Set height of startup window to <value>.
   -h or -help                     Print this message. [See note below]
   -installer                      Start with 4.x migration window.
   -pref                           Start with pref window.
   -width <value>                  Set width of startup window to <value>.
   -CreateProfile <profile>        Create and start with <profile>.
   -P <profile>                    Start with <profile>.
   -ProfileWizard                  Start with profile wizard.
   -ProfileManager                 Start with profile manager.
   -SelectProfile                  Start with profile selection dialog.
   -nosplash                       Disable splash screen. [See note below]
   -quiet                          Disable splash screen.
   -chrome <url>                   Start with browser.
   -news                           Start with news.
   -compose <url>                  Start with messenger compose.
   -mail                           Start with mail.
   -jsconsole                      Start with Javascript Console
   -edit <url>                     Start with editor.
   -chat                           Start with an IRC chat client
   -addressbook                    Start with the addressbook.

   The -h or -help output has to be redirected to a file because this is a
   PM app. There's also a -v or -version option which doesn't work; those
   details are available from the "Help/About" menu.
   Splashscreen (bin/splash.bmp) display hasn't been implemented.


   Startup URL
   -----------

   If you want, you can specify a URL to load on launch. If you don't,
   you'll end up at the default:
   http://www.mozilla.org or whatever start page you select in Preferences.


   Redirection
   -----------

   When reporting problems, add "> mozilla.out 2>&1" or equivalent to the
   command to capture the output, and include it with any other relevant
   information.


   First-launch registration
   -------------------------

   The first launch always takes longer as the components (DLLs in /components)
   get registered. This creates component.reg, whose contents you can view by
   running "RegExport" (which itself takes an even longer time to run).


   Additional programs
   -------------------

   In addition to mozilla, /bin includes a variety of programs:

        xpcshell, a JavaScript (1.5) shell;
        nsinstall, a BSD-style install utility;
        xpidl, an IDL compiler;
        xpt_dump and xpt_link, a pair of xpt-file utilities;
        regExport, regxpcom and vreg, registration utilities;
        timebombgen, which you can use to play with timebombs;
        a few shell scripts.


Acknowledgements
----------------

Thanks to Bill Law and Dan Libby at Netscape for helping us get off
the ground way back when; John Fairhurst for giving us the frontend
and lots more; Joan Touzet for providing space on joyce and doing
the groundwork for a VAC 4.0 build; the team at IBM for taking care of
the check-in process, debugging, and contributing code, and particularly
Mike Kaply for taking on the chores of module owner; Dimitris 'sehh' 
Michelinakis for the installer; the good folks at Mozilla who've answered 
our questions, reviewed our code and helped get our patches into the tree;
and last but never least, all the people who've contributed to this project 
in one way or another over the past two-something years.


LICENSE
-------

Please see the LICENSE text file.


