1 ==============================================================================
4 ______________________________________________________________________________
7 If you're new to XWT, you should read the documentation in the order
12 Start here. Includes a map of all other documentation and a
13 description of the directory strucure
15 - The XWT home page [http://www.xwt.org/]
17 - The XWT tutorial [http://www.xwt.org/tutorial.html]
19 Gentle introduction to what XWT is, and how to write
20 .xwt's. Good for anybody who wants to write XWT applications.
22 - The XWT reference [http://www.xwt.org/reference.html]
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
30 ______________________________________________________________________________
34 AUTHORS - people involved in developing XWT
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
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
62 ______________________________________________________________________________
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
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.
80 - the standard set of POSIX utilities (wc, grep, find, make, etc)
82 Automatically-Downloaded components:
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/
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.
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