diff options
Diffstat (limited to 'build-tools/VersionInfo.java')
| -rw-r--r-- | build-tools/VersionInfo.java | 89 |
1 files changed, 44 insertions, 45 deletions
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 |