Jemmy Versioning.
This document describes principles of version number changing in Jemmy.
Jemmy version.
Any different nondevelopment Jemmy build has own version number.
Jemmy version number contains two main parts:
major version, which is a first number in
version string and
minor version which is two last numbers divided by "." (for example,
in
2.0.4 version number:
2 is a
major version,
0 is a
minor version,
4 is a
micro version).
Minor version means large API changes, micro versiont is used to
indicate any improvement.
Some postfixes could be added to either signalize that version has been built from
branch or that it's a development version or it's an experimental version.
Development version.
Between Jemmy releases, CVS repository may have development Jemmy version.
Such versions have version number containing a number greater than
previous released version number and
".dev" suffix:
2.0.5.dev (for last released
2.0.4).
Branches.
Number of a version built from branch consist in
previous released version number
branch name
version number on branch
Example of such version number:
2.0.3.queue-branch.3, which means that
queue-branch branch started from
2.0.3 trunk version and
current build contains
3'rd version on branch.
Experimental versions.
Time from time it could be necessary o build Jemmy with experimental
changes. For example if bug is hardly reproducible, it's possible
to add some debug output and send a jar to the person able to reproduce it.
Such Jemmy versions have unique number (for example
2.0.4.treefix)
even though they are not normally checked into CVS repository.
How to get Jemmy version number.
If you have a
jemmy.jar got from Jemmy website, you can execute
"java -jar jemmy.jar" command to see Jemmy version number. You also can
execute
"java -jar jemmy.jar -f" to see full Jemmy version including
build number.
Otherwise (i.e. if you only have zip or just classes) you can execute next
command
"java -classpath <jemmy classes> org.netbeans.jemmy.JemmyProperties"
Jemmy version stored in
src/org/netbeans/jemmy/version_info file in
Jemmy source distribution.
Additionally, all version changes are described in
util/version_comments
file under
"#<version number>" mark.
How to get sources for known Jemmy version number.
CVS repository is marked by a simbolic tag each time Jemmy version number is
changed (this, of course not applicable to development versions).
Tag name looks like
"version-<major>-<first minor>-<second minor>-<postfix>".
For example:
version-2-0-4 for
2.0.4 version,
version-2-0-3-queue-branch-3 for
3'rd
version on queue-branch branch.
Package version.
Each jemmy package has own implementation version. It's, basicly, a date in
yy/MM/dd-hh:mm:ss format.
Read about package version specification
here.
Last modified: Tue Nov 5 20:08:16 PST 2002
