Update source code for GPLv2 license

git-svn-id: https://svn.java.net/svn/j3d-core~svn/trunk@892 ba19aa83-45c5-6ac9-afd3-db810772062c

6 files changed, 48 insertions, 176 deletions

diff --git a/build-tools/MakeJ3dBuildInfo.java b/build-tools/MakeJ3dBuildInfo.java
deleted file mode 100644
index 3b7044e..0000000
--- a/build-tools/MakeJ3dBuildInfo.java
+++ /dev/null
@@ -1,127 +0,0 @@
-/*
- * $RCSfile$
- *
- * Copyright (c) 2007 Sun Microsystems, Inc. All rights reserved.
- *
- * Use is subject to license terms.
- *
- * $Revision$
- * $Date$
- * $State$
- */
-
-import java.io.File;
-import java.io.FileOutputStream;
-import java.io.FileNotFoundException;
-import java.io.PrintStream;
-import java.text.DateFormat;
-import java.util.Date;
-
-/**
- * This application is used to dynamically create the source code for
- * the J3dBuildInfo class.  The J3dBuildInfo class contains a static
- * method that returns a build time stamp string. The time stamp
- * string is used by the VersionInfo class as part of the version
- * number stored in the VirtualUniverse "j3d.version" property.  It is
- * created dynamically so that the version number uniquely identifies
- * the build.
- */
-public class MakeJ3dBuildInfo {
-    private static final String srcName =
-	"javax" + File.separator +
-	"media" + File.separator +
-	"j3d" + File.separator +
-	"J3dBuildInfo.java";
-
-    public static void main(String[] args) throws FileNotFoundException {
-	// Parse command line arguments
-	String usage = "Usage: java MakeJ3dBuildInfo [-debug] [srcRootDir]";
-	boolean debugFlag = false;
-	String srcRoot = ".";
-
-	int idx = 0;
-	while (idx < args.length) {
-	    if (args[idx].startsWith("-")) {
-		if (args[idx].equals("-debug")) {
-		    debugFlag = true;
-		}
-		else {
-		    System.err.println(usage);
-		    System.exit(1);
-		}
-		++idx;
-	    }
-	    else {
-		break;
-	    }
-	}
-
-	// Now grab the root of the source tree, if specified
-	if (idx < args.length) {
-	    if (idx < (args.length - 1)) {
-		System.err.println(usage);
-		System.exit(1);
-	    }
-
-	    srcRoot = args[idx];
-	}
-
-	// Create the File object representing the path name to the
-	// output java source file
-	String outPathName = srcRoot + File.separator + srcName;
-	File file = new File(outPathName);
-
-	// Open the output java source file
-        PrintStream out = new PrintStream(new FileOutputStream(file));
-
-	// Create and format the time and date string for the current time
-	DateFormat df = DateFormat.getDateTimeInstance(DateFormat.SHORT,
-						       DateFormat.FULL);
-        Date buildDate = new Date();
-	String dateString = df.format(buildDate);
-
-	// Generate the java source code for J3dBuildInfo
-	out.println("package javax.media.j3d;");
-	out.println();
-	out.println("/**");
-	out.println(" * DO NOT MODIFY THIS CLASS.");
-	out.println(" *");
-	out.println(" * This class is automatically created as part of the build process");
-	out.println(" * by <code>MakeJ3dBuildInfo.java</code>.");
-	out.println(" */");
-	out.println("class J3dBuildInfo {");
-	out.println("    /**");
-	out.println("     * Constant that indicates whether or not this is");
-	out.println("     * a debug build.");
-	out.println("     */");
-	out.print("    static final boolean isDebug = ");
-	if (debugFlag) {
-	    out.println("true;");
-	}
-	else {
-	    out.println("false;");
-	}
-	out.println();
-	out.print("    private static final String BUILD_TIME_STAMP = ");
-	out.print("\"");
-	out.print(dateString);
-	out.println("\";");
-	out.println();
-	out.println("    /**");
-	out.println("     * Returns the build time stamp.");
-	out.println("     * @return the build time stamp");
-	out.println("     */");
-	out.println("    static String getBuildTimeStamp() {");
-	out.println("        return BUILD_TIME_STAMP;");
-	out.println("    }");
-	out.println();
-	out.println("    /**");
-	out.println("     * Do not construct an instance of this class.");
-	out.println("     */");
-	out.println("    private J3dBuildInfo() {");
-	out.println("    }");
-	out.println("}");
-
-	out.close();
-    }
-}
diff --git a/build-tools/VersionInfo.java b/build-tools/VersionInfo.java
index ffdb49e..60e32a3 100644
--- a/build-tools/VersionInfo.java
+++ b/build-tools/VersionInfo.java
@@ -1,9 +1,28 @@
 /*
  * $RCSfile$
  *
- * Copyright (c) 2007 Sun Microsystems, Inc. All rights reserved.
+ * Copyright 2004-2008 Sun Microsystems, Inc.  All Rights Reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
- * Use is subject to license terms.
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.  Sun designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Sun in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
+ * CA 95054 USA or visit www.sun.com if you need additional information or
+ * have any questions.
  *
  * $Revision$
  * $Date$
@@ -14,17 +33,17 @@ package javax.media.j3d;
 
 /**
  * The VersionInfo class contains strings that describe the implementation
- * and specification version of Java 3D.  These strings are made available
- * as properties obtained from the VirtualUniverse class.
+ * and specification version of the javax.media.j3d pacakge.  These strings
+ * are made available as properties obtained from the VirtualUniverse class.
  *
  * <h4>NOTE TO DEVELOPERS:</h4>
  *
  * <p>
- * Developers are required to do the following whenever they modify
- * Java 3D:
+ * Developers are strongly encouraged to do the following whenever they
+ * modify the 3D graphics API for the Java platform:
  *
  * <ol>
- * <li>The VENDOR_DEVELOPER string must be modified to
+ * <li>The VENDOR_DEVELOPER string should be modified to
  * indicate the name of the individuals or organizations who have
  * modified the source code.</li>
  *
@@ -32,25 +51,19 @@ package javax.media.j3d;
  * additional information about the particular build, but this is
  * not required.</li>
  *
- * <li>The strings denoted as being unmodifiable must <i>not</i> be
+ * <li>The strings denoted as being unmodifiable should <i>not</i> be
  * modified.</li>
  * </ol>
  *
  * <p>
  * The tags of the form @STRING@ are populated by ant when the project is built
  *
- * <p>
- * Additionally, developers are required to comply with the terms
- * of the Java 3D API specification, which prohibits releasing an
- * implementation of the Java 3D API without first licensing and
- * passing the TCK tests.
- *
  * @see VirtualUniverse#getProperties
  */
 class VersionInfo extends Object {
     /**
-     * Developer who has modified Java 3D.
-     * This string <i>must</i> be modified to indicate the name of the
+     * Developer who has modified the 3D graphics API for the Java platform.
+     * This string should be modified to indicate the name of the
      * individual(s) or organization(s) who modified the code.
      */
     private static final String VENDOR_DEVELOPER = null;
@@ -72,11 +85,7 @@ class VersionInfo extends Object {
 
 
     // -------------------------------------------------------------------
-    // The following set of constants must not be modified by developers.
-    //
-    // Only qualified licensees of the Java 3D API specification and
-    // TCK tests, who are releasing their own implementation of Java 3D
-    // are permitted to change these constants.
+    // The following set of constants should not be modified by developers.
     // -------------------------------------------------------------------
 
     /**
@@ -87,9 +96,10 @@ class VersionInfo extends Object {
     /**
      * This static final variable is used to enable debugging and
      * assertion checking during the development phase of a particular
-     * version of Java 3D. It is disabled for "opt" production builds
-     * (beta, release candidate, fcs, and patch builds). It is enabled
-     * for all "debug" builds and for daily and stable "opt" builds.
+     * version of 3D graphics API for the Java platform. It is disabled
+     * for "opt" production builds (beta, release candidate, fcs, and
+     * patch builds). It is enabled for all "debug" builds and for daily
+     * and stable "opt" builds.
      *
      * <p>
      * This parameter is controlled by ant via the build.xml file. The
@@ -116,14 +126,14 @@ class VersionInfo extends Object {
     private static final boolean useVerboseBuildTime = @USE_VERBOSE_BUILDTIME@;
 
     /**
-     * String identifying the type of  Java 3D build, one of:
+     * String identifying the type of build, one of:
      * "daily", "stable", "beta", "fcs", or "patch". The default value
      * is "daily".
      */
     private static final String BUILD_TYPE = "@BUILD_TYPE@";
 
     /**
-     * String identifying the build number of Java 3D in the format
+     * String identifying the build number in the format
      * "buildNN", where "NN" is the sequential build number, for
      * example, build47.  This string contain only letters and
      * numbers, It must not contain any other characters or spaces.
@@ -134,7 +144,7 @@ class VersionInfo extends Object {
     private static final String VERSION_BUILD = "@VERSION_BUILD@";
 
     /**
-     * String identifying the particular build of Java 3D, for
+     * String identifying the particular build of the 3D API, for
      * example, "-beta1", "-build47", "-rc1", "_01", etc. Note that
      * this includes the leading dash or underscore. It will typically
      * be empty for FCS builds. This string may only contain letters,
@@ -160,28 +170,25 @@ class VersionInfo extends Object {
     private static final String SPECIFICATION_VERSION = "1.5";
 
     /**
-     * Specification vendor. This should never change and must not
-     * be modified by developers.
+     * Specification vendor.
      */
-    private static final String SPECIFICATION_VENDOR = "Sun Microsystems, Inc.";
+    private static final String SPECIFICATION_VENDOR = "@SPEC_VENDOR@";
 
     /**
-     * Primary implementation vendor. This should only be changed by a
-     * platform vendor who has licensed the TCK tests and who is
-     * releasing their own implementation of Java 3D.
+     * Primary implementation vendor.
      */
-    private static final String VENDOR_PRIMARY = "Sun Microsystems, Inc.";
+    private static final String VENDOR_PRIMARY = "@IMPL_VENDOR@";
 
     /**
-     * Base version number.  This is the major.minor.subminor version
-     * number.  Version qualifiers are specified separately.  The
+     * Base version number. This is the major.minor.subminor version
+     * number. Version qualifiers are specified separately.  The
      * major and minor version <i>must</i> be the same as the specification
      * version.
      */
     private static final String VERSION_BASE = "@VERSION_BASE@";
 
     /**
-     * Boolean flag indicating that the version of Java 3D is
+     * Boolean flag indicating that the version of the 3D API is
      * experimental.  This must <i>not</i> be modified by developers.
      * All non-official builds <i>must</i> contain the string
      * <code>"experimental"</code> as part of the release name that
@@ -202,14 +209,6 @@ class VersionInfo extends Object {
     private static final String VENDOR;
 
     /**
-     * Build type string, one of "fcs", "fcs-patch", or "", that is
-     * appended to the end of the version string after the build
-     * identifier (and after the first space, which will automatically
-     * be added) and before the optional verbose time and date stamp.
-     */
-    private static final String BUILD_QUALIFIER = "@BUILD_QUALIFIER@";
-
-    /**
      * Verbose time and date stamp appended to the end of the version string.
      * This is appended to the version string
      * after the build identifier (and after the first space, which
diff --git a/build-tools/linux-amd64/script2.txt b/build-tools/linux-amd64/script2.txt
index 2e6a0d2..ea5fb16 100644
--- a/build-tools/linux-amd64/script2.txt
+++ b/build-tools/linux-amd64/script2.txt
@@ -15,7 +15,7 @@ while [ x$agreed = x ]; do
 done
 if [ ! -w `pwd` ] ; then
     echo "You do not have write permission to `pwd`"
-    echo "Java 3D installation failed"
+    echo "3D installation failed"
     exit 1
 fi
 outname=install.sfx.$$
diff --git a/build-tools/linux-i586/script2.txt b/build-tools/linux-i586/script2.txt
index 2e6a0d2..ea5fb16 100644
--- a/build-tools/linux-i586/script2.txt
+++ b/build-tools/linux-i586/script2.txt
@@ -15,7 +15,7 @@ while [ x$agreed = x ]; do
 done
 if [ ! -w `pwd` ] ; then
     echo "You do not have write permission to `pwd`"
-    echo "Java 3D installation failed"
+    echo "3D installation failed"
     exit 1
 fi
 outname=install.sfx.$$
diff --git a/build-tools/solaris-sparc/script2.txt b/build-tools/solaris-sparc/script2.txt
index 6cd859c..a9aafa8 100644
--- a/build-tools/solaris-sparc/script2.txt
+++ b/build-tools/solaris-sparc/script2.txt
@@ -15,7 +15,7 @@ while [ x$agreed = x ]; do
 done
 if [ ! -w `pwd` ] ; then
     echo "You do not have write permission to `pwd`"
-    echo "Java 3D installation failed"
+    echo "3D installation failed"
     exit 1
 fi
 outname=install.sfx.$$
diff --git a/build-tools/solaris-x86/script2.txt b/build-tools/solaris-x86/script2.txt
index 6cd859c..a9aafa8 100644
--- a/build-tools/solaris-x86/script2.txt
+++ b/build-tools/solaris-x86/script2.txt
@@ -15,7 +15,7 @@ while [ x$agreed = x ]; do
 done
 if [ ! -w `pwd` ] ; then
     echo "You do not have write permission to `pwd`"
-    echo "Java 3D installation failed"
+    echo "3D installation failed"
     exit 1
 fi
 outname=install.sfx.$$