You are currently viewing a snapshot of www.mozilla.org taken on April 21, 2008. Most of this content is highly out of date (some pages haven't been updated since the project began in 1998) and exists for historical purposes only. If there are any pages on this archive site that you think should be added back to www.mozilla.org, please file a bug.



Bezilla logo
 |||  Home Team BeZilla Contact Us

Bezilla: How to Build

Notice
We need your help! If you can spare any time to help, please do. Start by reading the mozilla.org site. Pages like "Get Involved" or "Hacking" are a *MUST* read.
 
Requirements
These are the hardware and software needed in order to build a development version of Bezilla. The requirements to actually run the software are a lot less demanding but because there's presently no stable release available we are only providing the development configuration.

Hardware

  • BeOS Ready computer or hardware
  • BeOS R5 - Either the Personal Edition (with dev. tools) or Pro [ x86 only, For PPC we need volunteers ]
  • A lot of ram! You will need at least 128MB of virtual memory, and we recommended 128 or more of real physical RAM too!
  • Up to 1.5 / 2.0 gb disk space for the whole tree compiled with debugging. The source alone is around 380 megs!
  • A good net connection from BeOS to keep the sources in sync. The full download takes around 60 minutes via CVS over a cable connection.

Software

  • CVS

      Download cvs [ 548 kB ] and unpack it somewhere on your disk. Create a link inside your home/config/bin to the cvs binary. And test it's installation by starting the "Terminal" application and typing "cvs --version" inside the terminal from your home directory. You should get:

        Concurrent Versions System (CVS) 1.11 (client/server)
        
        Copyright (c) 1989-2000 Brian Berliner, david d `zoo' zuhn,
                                Jeff Polk, and other authors
        
        CVS may be copied only under the terms of the GNU General Public License,
        a copy of which can be found with the CVS distribution kit.
        
        Specify the --help option for further information about CVS
  • Perl

      Download perl [ 2.27 mB ] and unpack it somewhere on your disk. Start a terminal window and go to the newly created directory and *EXECUTE* from the terminal the script "install-perl". After the installation has completed you should create a link to the perl binary inside your home/config/bin directory. Then test it by starting the "Terminal" application and typing "perl --version" inside the terminal from your home directory. You should get:

        This is perl, version 5.005_03 built for BePC-beos
        
        Copyright 1987-1999, Larry Wall
        BeOS port Copyright Tom Spindler, 1997-1998
        
        Perl may be copied only under the terms of either the Artistic License or the
        GNU General Public License, which may be found in the Perl 5.0 source kit.
        
        Complete documentation for Perl, including FAQ lists, should be found on
        this system using `man perl' or `perldoc perl'.  If you have access to the
        Internet, point your browser at http://www.perl.com/, the Perl Home Page.
        
  • glib & libIDL

      Download glib & libIDL [ 837.8 kB ] and unpack it somewhere. Then start the "Terminal" application and go to the "glib-libIDL-beos" directory. And type inside the terminal:

        buildscript

      This will start creating the libraries and if successful, you'll see something like:

        **********************************************
        The support libraries have been built and installed, please set these environment
        vabiables before running the main Mozilla 'configure' script:
        export GLIB_CONFIG=/boot/home/glib-libIDL-beos/glib/bin/glib-config
        export LIBIDL_CONFIG=/boot/home/glib-libIDL-beos/libIDL/bin/libIDL-config
        **********************************************
        

      The "/boot/home/glib-libIDL-beos/glib/bin/" part of the display will probably be different on your machine.

  • ~/.mozconfig

      In order for Bezilla to compile on various platform, it uses a tool called "configure" which allow the creation of makefile based on template and also create a lot of define statement which can then be used by the code to act differently base on the capacity of the platform it's compiled on.

      In order to properly "configure" the Bezilla build system you'll need to create a new file inside your home directory called ".mozconfig". The content of this file should be:

        # sh
        # Build configuration script
        #
        # See http://www.mozilla.org/build/unix.html for build instructions.
        #
        # Options for 'configure' (same as command-line options).
        ac_add_options --enable-cpp-rtti
        # Remove the # in the next line for building a Mozilla without debug info.
        #ac_add_options --disable-debug
        

      This will tell to the build system to turn on RTTI (required by one of Be's library) functionality. If you don't do this step, you will be unable to compile the mozilla/gfx/beos section.

  • ~/setupbezilla

      In order to simplify the build process, you should create a file called "setupbezilla" inside your home directory. Running this file will set environment variables require for the build system to locate library such as glib and libIDL and also tell CVS where to find the server holding the source code of Bezilla. Create this file using a text editor and copy and paste this text:

        export GLIB_CONFIG=/boot/home/glib-libIDL-beos/glib/bin/glib-config
        export LIBIDL_CONFIG=/boot/home/glib-libIDL-beos/libIDL/bin/libIDL-config
        export CVSROOT=:pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot
        

      You should ensure that the first two line are the same as you have obtained inside the installation of the glib and libIDL output (in fact it's MOST likely that the "/boot/home/glib-libIDL-beos/" part may differ for you). Save the file under the name "setupbezilla" in your home directory.

 
Building Bezilla
Each time you want to build Bezilla, open a Terminal and run the script "setupbezilla" which should be located in your home directory if you've followed the software requirement properly. (the "~" is equivalent to /boot/home therefore if you saved the setupbezilla file somewhere else you may have to replace it with the actual path, the dot at the begining is to change the environment variables for this shell context and is important). 
    . ~/setupbezilla

Good, so now our environment variables knows where to find the glib and libIDL libraries and also where is the server holding the source code of Bezilla. In order to obtain the source code we need to login to the server. So type:

    cvs login

When prompted for the password, enter "anonymous". If you did it properly you should be back to the terminal prompt. You should then continue by extracting the main makefile from the code server with this command:

    cvs -z3 checkout mozilla/client.mk

This will create a directory called "mozilla" (you will receive an error if the name was already took for representing a file or is unreadable). Inside the mozilla directory you will find the file client.mk which is a makefile that has the instruction to download the source code, configure the build system and compile the code. You simply need to call it with what you want it to do.

So if you're a first timer, you'll need to extract all the source, configure the build system and then compile it. Lucky for you that's actually the default behavior of the client.mk. So if you don't pass argument it will do just that, download source, configure the build system and compile Bezilla. Let's try it:

    cd mozilla
    make -f client.mk
    

You're going to see the whole source tree being downloaded to your hard disk via CVS. When thats done the configure script will be run automatically and finally, the compilation will begin. This is a nearly 2 hour operation under a Pentium 500 Mhz with 256 megs of RAM, so get comfortable and patient.

 
Running Bezilla
To run it, just go inside the mozilla/dist/bin and type:
    ./run-mozilla.sh mozilla
    
You should definitely start it from a terminal, lot of debug information will appear inside the window. Then its time to start working. Debug it or ask for help, see the contact us section for more information on how to reach us.