From f77419e98959e8b21de7108cfa7a7332ae495fe4 Mon Sep 17 00:00:00 2001 From: curcuru Date: Wed, 9 Jan 2002 20:01:23 +0000 Subject: [PATCH] New build system for whole xml-commons project Top-level xml-commons/build.xml creates distro out of all sub-sub-projects README.html updated with forrest 1.5 look and more info which.xml and external/build.xml simplified with minor updates; outputs are still the same git-svn-id: https://svn.apache.org/repos/asf/xml/commons/trunk@225943 13f79535-47bb-0310-9956-ffa450edef68 --- README.html | 206 ++++++++++++++++++++++++++++------------ build.xml | 92 ++++++++++++++++++ java/external/build.xml | 38 +++++--- java/which.xml | 54 +++++------ 4 files changed, 283 insertions(+), 107 deletions(-) create mode 100644 build.xml diff --git a/README.html b/README.html index cb039e8..ae334f0 100644 --- a/README.html +++ b/README.html @@ -9,42 +9,93 @@ xml-commons README homepage + +
+ www.apache.org >  + xml.apache.org >  commons +

- - - - - -
Welcome to xml-commons!
-

The xml-commons is a new xml.apache.org subproject focused on common code and guidelines for xml projects. + +

+
Welcome to xml-commons!
+
+

xml-commons is a new xml.apache.org subproject!

+

xml-commons is focused on common code and guidelines for xml projects. It's first focus will be to organize and have common packaging for the various externally-defined standards code relating to XML - things like the DOM, SAX, and JAXP interfaces.

As the xml-commons community forms, we also hope to serve as a holding area for other common xml-related utilities and code, and to help promulgate common packaging, testing, documentation, and other guidelines across all -xml.apache.org subprojects

- +xml.apache.org subprojects.

+ +
+
+
In this document:
+
- - - - -
Commons Guidelines
+
Commons Guidelines

As the community forms, we need to formalize these guidelines, especially to differentiate 'requirements' from suggested 'guidelines'.

Shane's starting proposals:

@@ -54,28 +105,32 @@ xml-commons/ README.html - this file build.xml - overall build file for top-level items xdocs/ - top-level xml format docs about this project itself and our guidelines - (in stylebook format like xml-xalan uses, unless someone wants to volunteer to start - out with another format and maintain it) + (in whatever format xml.apache.org uses for site) docs/ - (not checked in) html format docs created by 'build docs' from xdocs java/ - root of all java-related files - build.xml - Ant build file for all java files (might call subsidiary build files) external/ - src root of all source files in java that come from external sources for example: the DOM, SAX, and JAXP files org/xml/sax/* org/w3c/dom/* javax/xml/* - - apache/ - src root of all source files in java that are apache-owned - tbd/ - java packages added as needed + external/build.xml - Ant build file for all external sources xdocs/ - xml format docs describing any java files, as needed + + {name}.xml - Ant build file for Apache-defined subproject(s) + future: resolver.xml: for Norm Walsh's entity resolver submission, when done + + src/ - root of Apache-defined Java code + src/org/apache/... etc + + which.xml - Ant build file for org.apache.env.Which utility + c/ - root of all C/C++ related files external/ - root of all externally-owned C/C++ sources - apache/ - root of all apache-owned C/C++ sources perl/ - root of all Perl related files etc. @@ -98,37 +153,68 @@ xml.apache.org subprojects to use the code that commons has. I.e. suggestions and ways to package this code vis-a-vis the other project's code in a common way.
  • Other shared xml.apache.org guidelines? Like documentation format, testing techniques/policies, etc.
    • +
    - - - - -
    Where can I download releases?
    -

    Since the community is still forming over May-June 2001, we don't have any releases yet. +

    DOM, SAX, and JAXP code
    +

    xml-commons primary goal is to provide Apache projects with a stable version of +XMl-related externally-defined standards-based code. This is mainly the various +interfaces that you use when programming XML from JAVA: DOM, SAX and JAXP for now.

    +

    This tree is rooted at xml-commons/java/external, and has a build.xml file. +Basic documentation from each external project is also checked in.

    +
      +
    • Current (Jan-02) status:
      • +
    • DOM L2 - full set of interfaces (including HTML stuff) from w3c.org
      • +
    • SAX 2.0 from megginson.com, plus minor bugfixes (note that SAX +is currently maintained at http://sax.sourceforge.net/, +we need to update and cross-check with them soon!)
      • +
    • JAXP 1.1.3-HEAD from Sun, with current bugfixes by edwingo@apache.org
      • +
    +

    Issues Jan-02: our current SAX and JAXP code may not pass the current +J2EE CTS test suite, since we have bugfixes above what those CTS tests +mandate. If you don't know what that is, you don't care; otherwise ask +on commons-dev for an update.

    +
    + +
    Apache-authored code: org.apache.env.Which, more?
    +

    xml-commons' secondary goal is to provide a project space for small +XML-related utilities that are being used in multiple other xml.apache.org +projects. In an effort to simplify and reduce dependency headaches, we'll +probably accept new projects only fairly slowly (this is in contrast to +the much more open jakarta-commons project). +In particular, code submitted here should probably have minimal dependencies: +possibly only depending on DOM/SAX/JAXP and Ant (for builds).

    +
      +
    • Current (Jan-02) status:
      • +
    • org.apache.env.Which - a simple environment check utility for +xml-related items in your JVM's environment: see xml-commons/java/which.xml
      • +
    • (to be submitted) Norm Walsh's entity resolver utility
      • +
    • (to be voted in) Jeff Turner's DOCTYPE changer
      • +
    +
    + + +
    Where can I download releases?
    +

    Our first 'preview' release is planned for early January-2002. We'll certainly announce our first releases over general@xml.apache.org as well as our project mailing list.

    +
    - - - - -
    How can I find out more?
    -

    We should have a project mailing list setup soon. Ask your questions or bring your suggestions -to xml-commons-dev@xml.apache.org. Subscription info coming soon...

    +
    How can I find out more?
    +

    We have a project mailing list setup - commons-dev@xml.apache.org. +Ask your questions or bring your suggestions there, or to general@xml.apache.org. +
    Send an email to commons-dev +
    Subscribe to commons-dev +
    Unsubscribe from commons-dev - - - - -
    Where can I get the code/CVS?
    +

    +
    + +
    Where can I get the code/CVS?

    The xml-commons repository is available thru normal and anonymous CVS, or through this nifty web interface.

    See xml.apache.org CVS overview.

    +
    - - - - -
    xml-subproject-proposal-commons-v1.1
    +
    xml-subproject-proposal-commons-v1.1
     List:     xml-apache-general
 Subject:  [VOTE] Proposal: new xml-commons subproject for standards-based files
@@ -285,14 +371,9 @@ proposal that I plagarized.  8-)
 
 - Shane shane_curcuru@lotus.com curcuru@apache.org
    +
    - - - - - - -
    xml-subproject-proposal-commons-v1.1-vote-count-26-Apr-01
    +
    xml-subproject-proposal-commons-v1.1-vote-count-26-Apr-01

    Below follows the votes cast to create this subproject

    ---- From open general@xml.apache.org mailing list through 3pm 26-Apr-01 ----
    Original proposal at: http://marc.theaimsgroup.com/?l=xml-apache-general&m=98752444702386&w=2 @@ -349,22 +430,25 @@ Goei edwingo@sun.com

    /xml-subproject-proposal-commons-v1.1-vote-count-26-Apr-01

    +
    - - - - - -
    Info About This Document
    +
    Info About This Document
    • Version: $Id$
    • Contributors:
    • Shane Curcuru
      • +
    • This document is currently a hand-coded HTML file for reasons of simplicity; we plan to use whatever xml format the xml.apache.org website uses in the future.
    • This document is stored in the xml-commons CVS repository
      • -
    • This document is currently a hand-coded XHTML file for reasons of simplicity.
      • -
    • /home/cvs/xml-commons/README.html
      • +
    • Checked in: /home/cvs/xml-commons/README.html
      • +
    • Live on xml.apache.org site: http://xml.apache.org/commons/index.html
    • View with CVSWEB
    +
    + +

    +
    +Copyright © 1999-2001 Apache Software Foundation. All Rights Reserved. +
    diff --git a/build.xml b/build.xml new file mode 100644 index 0000000..9405c77 --- /dev/null +++ b/build.xml @@ -0,0 +1,92 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/java/external/build.xml b/java/external/build.xml index 9c5c6d1..c1dc7b6 100644 --- a/java/external/build.xml +++ b/java/external/build.xml @@ -4,28 +4,37 @@ @author shane_curcuru@lotus.com @author Davanum Srinivas, dims@yaoo.com --> - - - - - + + + - - - - + + + + + + + + + + + + + + @@ -44,6 +53,7 @@ + @@ -55,8 +65,8 @@ sourcepath="${src.dir}" destdir="${build.javadocs.dir}" version="yes" - windowtitle="${external-module}" - doctitle="${external-module}" + windowtitle="${external.javadoc.title}" + doctitle="${external.javadoc.title}" bottom="This document is in the PUBLIC DOMAIN and comes with NO WARRANTY of any kind." /> @@ -75,7 +85,7 @@ - + @@ -83,8 +93,8 @@ - - + + - + - - - - - + + + - + - - + + @@ -53,16 +51,13 @@ Build file for org.apache.env.Which service. No dependencies. - - - @@ -74,26 +69,25 @@ Build file for org.apache.env.Which service. No dependencies. + - + - + - + - - - + - @@ -127,13 +120,13 @@ Build file for org.apache.env.Which service. No dependencies. - + - + - - - + - - - - + + + +