kenai_tools 0.0.7

data/spec/fixtures/data/sax2/Makefile

@@ -0,0 +1,77 @@
+# $Id: Makefile,v 1.3 2001/11/21 00:49:34 dbrownell Exp $
+#
+# This Makefile is in the Public Domain.
+#
+
+
+DOCTITLE="SAX: Simple API for XML"
+
+SOURCES		:= $(shell find src/org -name '*.java' -print)
+PACKAGE_INFO	:= $(shell find src/org -name '*.html' -print)
+ALL_SRC		:= $(PACKAGE_INFO) $(SOURCES)
+
+all: sax.jar javadoc
+
+sax.jar:	$(SOURCES)
+ifneq ($(findstring 1.1, $(JDK)),1.1)
+	mkdir -p classes
+	javac -d classes $(SOURCES)
+	cd classes; jar cf ../sax.jar org
+else
+	@echo "SAX needs JDK 1.2 features to compile."
+	@echo "However, it works with JDK 1.1 runtime environments."
+	@exit 1
+endif
+
+#
+# Javadoc
+#
+#	    -overview doc/overview.html
+
+javadoc:	$(ALL_SRC) # doc/overview.html
+ifneq ($(findstring 1.1, $(JDK)),1.1)
+	mkdir -p apidoc
+	javadoc -d apidoc \
+	    -J-Xmx64M -J-Xms64M \
+	    -windowtitle $(DOCTITLE) \
+	    -nodeprecatedlist -use \
+	    -bottom "<em>SAX is in the PUBLIC DOMAIN.</em> \
+		<br>See <a href="http://www.saxproject.org"> \
+		http://www.saxproject.org</a> for information and source \
+		code.  <br>This documentation was derived from that\
+		source code on `date "+%e-%b-%Y"`.\
+		" \
+	    -classpath "$(CPATH)$(SEP)src" \
+	    org.xml.sax org.xml.sax.helpers org.xml.sax.ext
+else
+	@echo "Requires JDK 1.2 (or later) javadoc."
+	@exit 1
+endif
+
+#
+# Release Engineering:  "full" release has source, jarfile, javadoc.
+#
+
+# override in environment, with "make -e"
+DIST_DIR =	sax2dev
+
+EXTRA		:= README Makefile COPYING ChangeLog
+
+sax2dist.jar: sax.jar javadoc $(EXTRA) $(ALL_SRC)
+	mkdir -p $(DIST_DIR)
+	for F in $(EXTRA) $(ALL_SRC) ;\
+	do \
+	    mkdir -p `dirname $(DIST_DIR)/$$F` ;\
+	    cp $$F $(DIST_DIR)/$$F ;\
+	done
+	cp -r apidoc sax.jar $(DIST_DIR)
+	# jar cMf sax2dist.jar $(DIST_DIR)
+	zip -qr9 sax2dist.jar $(DIST_DIR)
+	rm -rf $(DIST_DIR)
+
+#
+# housekeeping
+#
+clean:
+	rm -rf classes *.jar apidoc
+	find . '(' -name '*~' -o -name '.#*' ')' -exec rm -f '{}' ';'

data/spec/fixtures/data/sax2/README

@@ -0,0 +1,62 @@
+SAX 2.0.2 (sax2r3)
+2004-04-27
+
+This is another bugfix release for SAX2.  It makes minimal changes
+(mostly in features and properties) to make SAX2 compliant with the
+new XML 1.1 and Namespaces 1.1 recommendations, including Unicode
+normalization.  The changes are minor and should not affect most
+applications.
+
+One significant point is that this release flags a conflict (which
+already existed) between the JavaDoc for fatalError() and the JavaDoc
+for endDocument().  It is not currently clear whether a SAX
+implementation must invoke the endDocument() callback after reporting
+a fatal error, and the documentation simply mentions this fact and
+advises application writers not to rely on either behaviour until the
+ambiguity is resolved in the next major release.
+
+See CHANGES and ChangeLog for more details.
+
+
+- David Megginson (temporarily filling in for David Brownell)
+
+
+SAX 2.0.1 (sax2r2)
+29-January-2002
+
+    NOTE:  you're looking at a version which extends SAX 2.0.1 with a test
+    version of the "SAX2 Extensions 1.1" interfaces, in the org.xml.sax.ext
+    package.  It also includes some new feature flags.
+
+This is a bugfix release for SAX2, the second generation of the Simple
+API for XML.  Changes from the SAX 2.0 release can be summarized as:
+    - Numerous documentation improvements and clarifications.
+    - Bundling the optional "SAX2 Extensions 1.0" support.
+    - Bugfixes:
+	* Bugfixed classes include ParserAdapter, AttributesImpl
+	* Factory classes use the correct class loader (JDK 1.2 and later)
+	* Some exceptions were missing default constructors
+	* DefaultHandler was missing an exception spec
+	* Resetting handlers to their default values is legal
+    - Slightly less memory use in NamespaceSupport, AttributesImpl.
+    - Better configurability for the default XMLReader.
+    - NamespaceSupport enforces its declare-before-use constraint
+
+Other than bugfixes, the APIs have not been changed.  This is intended to
+be a drop-in replacement for the previous SAX2 release.  API-conformant
+code will not notice any differences.
+
+If you are using JDK 1.4, you should be able to copy "sax.jar" into
+the $JAVA_HOME/jre/lib/endorsed directory to have it replace the older
+version of SAX2 that is distributed with that JVM.  If you're using
+JRE 1.4, that path won't include the "jre".
+
+For more information, see the current home for SAX on the web:
+
+    http://www.saxproject.org
+
+As a SourceForge project, SAX now has public CVS access, a database
+for bugs and RFEs, mailing lists, and a web site.
+
+- David Brownell
+  dbrownell@users.sourceforge.net

data/spec/fixtures/data/sax2/build.xml

@@ -0,0 +1,68 @@
+<?xml version="1.0"?>
+<project name="sax2" default="jar" basedir=".">
+
+   <property name="src" value="src"/>
+   <property name="classes" value="classes"/>
+   <property name="jarfile" value="sax2.jar"/>
+   <property name="docs" value="docs"/>
+   <property name="javadoc" value="${docs}/javadoc"/>
+   <property name="version" value="sax2r3"/>
+   <property name="work" value="${version}"/>
+   <property name="zipfile" value="${version}.zip"/>
+
+   <target name="init">
+      <tstamp/>
+   </target>
+
+   <target name="prepare" depends="init">
+      <mkdir dir="${classes}"/>
+      <mkdir dir="${javadoc}"/>
+   </target>
+
+   <target name="compile" depends="prepare">
+      <javac srcdir="${src}" destdir="${classes}"/>
+   </target>
+
+   <target name="jar" depends="compile">
+      <jar jarfile="${jarfile}" basedir="${classes}"/>
+   </target>
+
+   <target name="javadoc" depends="prepare">
+      <javadoc sourcepath="${src}"
+               destdir="${javadoc}"
+               version="yes">
+         <package name="org.xml.sax"/>
+         <package name="org.xml.sax.ext"/>
+         <package name="org.xml.sax.helpers"/>
+      </javadoc>
+   </target>
+
+   <target name="dist" depends="jar,javadoc">
+      <delete dir="${work}"/>
+      <mkdir dir="${work}"/>
+      <copy todir="${work}">
+         <fileset dir=".">
+            <include name="BUGS"/>
+            <include name="build.xml"/>
+            <include name="ChangeLog"/>
+            <include name="README"/>
+            <include name="${jarfile}"/>
+         </fileset>
+         <fileset dir="${src}" excludes="**/Makefile"/>
+         <fileset dir="${classes}"/>
+         <fileset dir="${docs}"/>
+         <fileset dir="${javadoc}"/>
+      </copy>
+      <zip zipfile="${zipfile}"
+           basedir="."
+           includes="${work}/**"/>
+      <delete dir="${work}"/>
+   </target>
+
+   <target name="clean" depends="init">
+      <delete dir="${classes}"/>
+      <delete dir="${javadoc}"/>
+      <delete file="${jarfile}"/>
+   </target>
+
+</project>

data/spec/fixtures/data/sax2/src/SAXDump.java

@@ -0,0 +1,238 @@
+import org.xml.sax.*;
+import org.xml.sax.ext.*;
+import org.xml.sax.helpers.*;
+
+
+/**
+ * Poke at parsers and find out what features and properties
+ * they support, using the SAX2 (+extensions) standard list.
+ *
+ * @author David Brownell
+ * @version $Id: SAXDump.java,v 1.3 2002/07/29 23:07:40 dbrownell Exp $
+ */
+public class SAXDump
+{
+    private SAXDump () { }
+    
+    /**
+     * Pass a list of parser classes; each will be scanned.
+     * If not, parsers from a built-in list are scanned.
+     */
+    public static void main (String argv [])
+    {
+	if (argv.length == 0)
+	    argv = new String [] {
+		"com.jclark.xml.sax.SAX2Driver",
+		"gnu.xml.aelfred2.SAXDriver",
+		"gnu.xml.aelfred2.XmlReader",
+		"gnu.xml.util.DomParser",
+		"oracle.xml.parser.v2.SAXParser",
+		"org.apache.crimson.parser.XMLReaderImpl",
+		"org.apache.xerces.parsers.SAXParser",
+		};
+
+	for (int i = 0; i < argv.length; i++)
+	    checkParser (argv [i]);
+    }
+
+    private static final String		FEATURE_URI
+	= "http://xml.org/sax/features/";
+
+    private static final String		PROPERTY_URI
+	= "http://xml.org/sax/properties/";
+    
+    //////////////////////////////////////////////////////////////////
+
+    private static void
+    checkFeature (String id, XMLReader producer)
+    {
+	int	state = 0;
+
+	try {
+	    boolean	value;
+
+	    // align to longest id...
+	    final int	align = 35;
+
+	    for (int i = align - id.length (); i > 0; i--)
+		System.out.print (' ');
+	    System.out.print (id);
+	    System.out.print (":  ");
+
+	    id = FEATURE_URI + id;
+
+	    value = producer.getFeature (id);
+	    System.out.print (value);
+	    System.out.print (", ");
+	    state = 1;
+
+	    producer.setFeature (id, value);
+	    state = 2;
+
+	    producer.setFeature (id, !value);
+	    System.out.println ("read and write");
+
+	    // changes value and leaves it
+
+	} catch (SAXNotSupportedException e) {
+	    switch (state) {
+	      case 0: System.out.println ("(can't read now)"); break;
+		/* bogus_1 means can't reassign the default;
+		 * probably intended to be read/write
+		 */
+	      case 1: System.out.println ("bogus_1"); break;
+	      case 2: System.out.println ("readonly"); break;
+	    }
+	    
+	} catch (SAXNotRecognizedException e) {
+	    if (state == 0) 
+		System.out.println ("(unrecognized)");
+	    else
+		/* bogus_2 means the wrong exception was thrown */
+		System.out.println ("bogus_2");
+	}
+    }
+
+    private static void
+    showFeatures (XMLReader producer)
+    {
+	System.out.println ("FEATURES for "
+	    + producer.getClass ().getName ());
+
+	// must-have, default=false
+	checkFeature ("namespace-prefixes", producer);
+	// must-have, default=true
+	checkFeature ("namespaces", producer);
+
+	// lots of optional features
+	checkFeature ("external-general-entities", producer);
+	checkFeature ("external-parameter-entities", producer);
+	checkFeature ("is-standalone", producer);
+	checkFeature ("lexical-handler/parameter-entities", producer);
+	checkFeature ("resolve-dtd-uris", producer);
+	checkFeature ("string-interning", producer);
+	checkFeature ("use-attributes2", producer);
+	checkFeature ("use-locator2", producer);
+	checkFeature ("validation", producer);
+    }
+
+    //////////////////////////////////////////////////////////////////
+
+    private static void
+    checkProperty (String id, XMLReader producer, Object newValue)
+    {
+	int	state = 0;
+
+	try {
+	    Object	value;
+
+	    // align to longest id...
+	    final int	align = 20;
+
+	    for (int i = align - id.length (); i > 0; i--)
+		System.out.print (' ');
+	    System.out.print (id);
+	    System.out.print (":  ");
+
+	    id = PROPERTY_URI + id;
+
+	    value = producer.getProperty (id);
+	    System.out.print (value);
+	    System.out.print (", ");
+	    state = 1;
+
+	    producer.setProperty (id, value);
+	    state = 2;
+
+	    producer.setProperty (id, newValue);
+	    System.out.println ("read and write");
+
+	    // changes value and leaves it
+
+	} catch (SAXNotSupportedException e) {
+	    switch (state) {
+	      case 0: System.out.println ("(can't read now)"); break;
+		/* bogus_1 means can't reassign the default;
+		 * probably intended to be read/write
+		 */
+	      case 1: System.out.println ("bogus_1"); break;
+	      case 2: System.out.println ("readonly"); break;
+	    }
+	    
+	} catch (SAXNotRecognizedException e) {
+	    if (state == 0) 
+		System.out.println ("(unrecognized)");
+	    else
+		/* bogus_2 means the wrong exception was thrown */
+		System.out.println ("bogus_2");
+	}
+    }
+
+    private static void
+    showProperties (XMLReader producer)
+    {
+	System.out.println ("PROPERTIES for "
+	    + producer.getClass ().getName ());
+
+	DefaultHandler2		handler = new DefaultHandler2 ();
+
+	// all properties are optional
+	checkProperty ("declaration-handler", producer, handler);
+
+    // To check the dom-node property, we need an instance
+    // of an org.w3c.dom.Node.  Any one will do; but since
+    // we don't know what is installed, we try four likely
+    // suspects.
+
+    String[] domClassNames = {
+        "org.apache.crimson.tree.XmlDocument",
+        "org.apache.xerces.dom.DocumentImpl",
+        "gnu.xml.dom.DomDocument",
+        "oracle.xml.parser.v2.XMLDocument",
+    };
+    org.w3c.dom.Node node = null;
+    for (int i = 0; i < domClassNames.length; i++) {
+        try {
+            Class domClass = Class.forName(domClassNames[i]);
+            node = (org.w3c.dom.Node) domClass.newInstance();
+        }
+        catch (ClassNotFoundException e) { continue; }
+        catch (InstantiationException e) { continue; }
+        catch (IllegalAccessException e) { continue; }
+        catch (ClassCastException e)     { continue; }
+    }
+
+    // If none of the classes yielded a workable instance,
+    // just skip the test.
+    if (node != null) {
+        checkProperty ("dom-node", producer, node);
+    }
+
+	checkProperty ("lexical-handler", producer, handler);
+	checkProperty ("xml-string", producer, "<root/>");
+    }
+
+    //////////////////////////////////////////////////////////////////
+
+    private static void
+    checkParser (String classname)
+    {
+	XMLReader	producer = null;
+
+	try {
+	    producer = XMLReaderFactory.createXMLReader (classname);
+
+	    showFeatures (producer);
+	    System.out.println ("");
+	    showProperties (producer);
+
+	} catch (Exception e) {
+	    if (producer == null)
+		System.err.println ("(can't create " + classname + ")");
+	    else
+		e.printStackTrace ();
+	} finally {
+	    System.out.println ("");
+	}
+    }
+}