1/*
2 * Licensed to the Apache Software Foundation (ASF) under one
3 * or more contributor license agreements. See the NOTICE file
4 * distributed with this work for additional information
5 * regarding copyright ownership. The ASF licenses this file
6 * to you under the Apache License, Version 2.0 (the  "License");
7 * you may not use this file except in compliance with the License.
8 * You may obtain a copy of the License at
9 *
10 *     http://www.apache.org/licenses/LICENSE-2.0
11 *
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an "AS IS" BASIS,
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
17 */
18/*
19 * $Id$
20 */
21package org.apache.xalan;
22
23/**
24 * Administrative class to keep track of the version number of
25 * the Xalan release.
26 * <P>This class implements the upcoming standard of having
27 * org.apache.project-name.Version.getVersion() be a standard way
28 * to get version information.  This class will replace the older
29 * org.apache.xalan.processor.Version class.</P>
30 * <P>See also: org/apache/xalan/res/XSLTInfo.properties for
31 * information about the version of the XSLT spec we support.</P>
32 * @xsl.usage general
33 */
34public class Version
35{
36
37  /**
38   * Get the basic version string for the current Xalan release.
39   * Version String formatted like
40   * <CODE>"<B>Xalan</B> <B>Java</B> v.r[.dd| <B>D</B>nn]"</CODE>.
41   *
42   * Futurework: have this read version info from jar manifest.
43   *
44   * @return String denoting our current version
45   */
46  public static String getVersion()
47  {
48     return getProduct()+" "+getImplementationLanguage()+" "
49           +getMajorVersionNum()+"."+getReleaseVersionNum()+"."
50           +( (getDevelopmentVersionNum() > 0) ?
51               ("D"+getDevelopmentVersionNum()) : (""+getMaintenanceVersionNum()));
52  }
53
54  /**
55   * Print the processor version to the command line.
56   *
57   * @param argv command line arguments, unused.
58   */
59  public static void main(String argv[])
60  {
61    System.out.println(getVersion());
62  }
63
64  /**
65   * Name of product: Xalan.
66   */
67  public static String getProduct()
68  {
69    return "Xalan";
70  }
71
72  /**
73   * Implementation Language: Java.
74   */
75  public static String getImplementationLanguage()
76  {
77    return "Java";
78  }
79
80
81  /**
82   * Major version number.
83   * Version number. This changes only when there is a
84   *          significant, externally apparent enhancement from
85   *          the previous release. 'n' represents the n'th
86   *          version.
87   *
88   *          Clients should carefully consider the implications
89   *          of new versions as external interfaces and behaviour
90   *          may have changed.
91   */
92  public static int getMajorVersionNum()
93  {
94    return @version.VERSION@;
95
96  }
97
98  /**
99   * Release Number.
100   * Release number. This changes when:
101   *            -  a new set of functionality is to be added, eg,
102   *               implementation of a new W3C specification.
103   *            -  API or behaviour change.
104   *            -  its designated as a reference release.
105   */
106  public static int getReleaseVersionNum()
107  {
108    return @version.RELEASE@;
109  }
110
111  /**
112   * Maintenance Drop Number.
113   * Optional identifier used to designate maintenance
114   *          drop applied to a specific release and contains
115   *          fixes for defects reported. It maintains compatibility
116   *          with the release and contains no API changes.
117   *          When missing, it designates the final and complete
118   *          development drop for a release.
119   */
120  public static int getMaintenanceVersionNum()
121  {
122    return @version.MINOR@;
123  }
124
125  /**
126   * Development Drop Number.
127   * Optional identifier designates development drop of
128   *          a specific release. D01 is the first development drop
129   *          of a new release.
130   *
131   *          Development drops are works in progress towards a
132   *          compeleted, final release. A specific development drop
133   *          may not completely implement all aspects of a new
134   *          feature, which may take several development drops to
135   *          complete. At the point of the final drop for the
136   *          release, the D suffix will be omitted.
137   *
138   *          Each 'D' drops can contain functional enhancements as
139   *          well as defect fixes. 'D' drops may not be as stable as
140   *          the final releases.
141   */
142  public static int getDevelopmentVersionNum()
143  {
144    try {
145        if ((new String("@version.DEVELOPER@")).length() == 0)
146          return 0;
147        else
148          return Integer.parseInt("@version.DEVELOPER@");
149    } catch (NumberFormatException nfe) {
150           return 0;
151    }
152  }
153}
154