@(#)README	1.2 99/02/19

OK, here it is -- rough'n'ready example showing how to customize XML
data to display as a parse tree in Swing.

DATA:	rich_iii.xml two_gent.xml play.dtd

    Two Shakespeare plays with their simple DTD, from:
    ftp://sunsite.unc.edu/pub/sun-info/standards/xml/eg/

CONFIG:	show.props play.props

    Two config files, for a generic XML node view and one with a
    custom elements used for specified XML tags.

SOURCE:	UTSL!  ("Use the Source, Luke!")

    There's a pretty rough "GuiDemo" driver that gets configured
    to fire up a Swing JTree in a SplitPane.

    The rest of this is a few kinds of custom DOM elements, doing
    nothing fancy beyond acting like a swing.tree.TreeNode or
    handling a couple subsidiary tags.  TitledElement may be
    the most interesting place to start.

RUN MORE OR LESS BY TYPING:

    # JDK 1.1 (Swing 1.1 must be downloaded separately)
    jre -cp xml.jar -cp . -cp swingall.jar \
	project.GuiDemo play.props macbeth.xml 

    # JDK 1.2, UNIX/Linux/etc
    java -classpath .:xml.jar project.GuiDemo play.props macbeth.xml 

    # JDK 1.2, Win32
    java -classpath .;xml.jar project.GuiDemo play.props macbeth.xml 

IF YOU HAVE PROBLEMS:

    First, try running this from the command line (as above) rather
    than as an applet.  Not everyone has the current version of Swing
    set up so it runs correctly in their browsers, and most problems
    have been associated with such configuration issues.

    Second, remember that if you are using JDK 1.1 then the correct
    version of Swing (1.1) must be downloaded separately, and set up.
    This example will not work without the correct version of Swing.

    Third, keep in mind that the instructions here were debugged
    on UNIX/Linux, not Win32.  If you run on Win32, you'll need to
    translate some things -- frontlashes to backslashes, colons to
    semicolons -- before things like Makefiles will work correctly.
    A later version may include instructions and/or scripts better
    suited to Win32.

