README

   1 ==============================================================================
   2 XWT README
   3
   4 ______________________________________________________________________________
   5 Documentation
   6
   7 If you're new to XWT, you should read the documentation in the order
   8 presented below:
   9
  10 - README [this file]
  11
  12       Start here. Includes a map of all other documentation and a
  13       description of the directory strucure
  14
  15 - The XWT home page [http://www.xwt.org/]
  16
  17 - The XWT tutorial [http://www.xwt.org/tutorial.html]
  18
  19       Gentle introduction to what XWT is, and how to write
  20       .xwt's. Good for anybody who wants to write XWT applications.
  21
  22 - The XWT reference [http://www.xwt.org/reference.html]
  23
  24       Precise, technical spec of exactly how XWT works. Assumes
  25       familiarity with XWT (ie, you've read the tutorial). This is the
  26       authoritative source for how an XWT engine should
  27       behave.
  28
  29
  30 ______________________________________________________________________________
  31 Directory Structure
  32
  33 /
  34    AUTHORS                - people involved in developing XWT
  35    README                 - this file
  36    COPYING                - copyright information for all files in this distro
  37    CHANGES                - the changelot
  38    TM                     - trademark information for XWT
  39    Makefile               - build file for gcc 3.3
  40    next.build             - the build id of the next build to be generated
  41    bin/                   - all binary stuff generated by xwt builds
  42    gcc/                   - build area for a custom copy of gcc3.3 and binutils2.13
  43        Makefile           - will download, configure, compile, and private-install gcc3.3/binutils2.13
  44        gcc.patch          - a patch to make boehm-gc work on Darwin (Mac OS X)
  45    lib/                   - any third-party binary stuff needed during the build process
  46        javago             - a copy of the javago post-compilation bytecode inliner
  47        netscape.jar       - minimal set of classes required for compiling against Netcape's Applet interfaces
  48        msjvm.jar          - minimal set of classes required for compiling against Microsoft's Applet interfaces
  49        jump.jar           - the jump2 bytecode-to-palmos translator
  50        libgcj-minimal.jar - a tiny portion of libgcj.jar; allows java->bytecode compilation without gcj
  51    src/                   - all java source files and xwt sources go here
  52        org/
  53            bouncycastle/  - the BouncyCastle Crypto Library
  54            mozilla/       - a copy of Rhino, the Mozilla JavaScript interpreter
  55            ijg/           - as part of the build process, the Independent JPEG Group's JPEG implementation gets put here
  56            xwt/builtin/   - .xwt's and .png's that are essential to bootstrapping the engine
  57            xwt/plat/      - platform-specific code
  58            xwt/util/      - misc utilities
  59            xwt/js/        - the XWT JavaScript Interpreter
  60
  61
  62 ______________________________________________________________________________
  63 Build Requirements
  64
  65 **** STOP! ****
  66
  67 Compiling the engine is Really Hard.  Unless you're planning on
  68 helping develop the engine, you probably don't need (or want) to
  69 compile it yourself!
  70
  71 There are pre-built, digitally signed binaries on http://dist.xwt.org/
  72 for every supported platform.  Please consider using those unless
  73 you're absolutely certain you need to go through the trouble of trying
  74 to get XWT to build.  You have been warned.  Please do not post to the
  75 mailing lists asking for help building XWT unless you're genuinely
  76 interested in helping to develop the engine.
  77
  78 Requirements:
  79     - jdk 1.4+
  80     - the standard set of POSIX utilities (wc, grep, find, make, etc)
  81
  82 Automatically-Downloaded components:
  83     - gcj 3.3+
  84     - binutils 2.13+
  85     * If you already have a suitably configured gcj 3.3 and binutils
  86       2.13+ you can set "gcc_path" to point at its installation
  87       location; otherwise the Makefile will download, configure,
  88       compile, and install gcc and binutils in xwt/gcc/
  89
  90 Optional components:
  91     - fastjar (builds archives faster)
  92     - jikes 1.18 (makes builds go much faster)
  93     * If jikes is in your $PATH, the Makefile will find and use it.
  94       Otherwise you can type 'make jikes' to download and build jikes.
  95
  96 Build Targets:
  97     - compile: compiles all .java files into bin/*.class
  98     - Win32:   Win95 OSR2 or later
  99     - Linux:   Linux 2.2 or later
 100     - Java2:   Any Java 1.2+ compliant JVM
 101     - Darwin:  Any Darwin-based OS (Mac OS X, OpenDarwin) with an X11 server
 102     - clean:   cleanup
 103