Whole document tree
2.4. Java libraries
Libraries are not separated between developers (-dev) and users versions, since it is meaningless in Java.
Java libraries packages must be named libXXX[version]-java (without the brackets), where the version part is optional and should only contain the necessary part. The version part should only be used to avoid naming colisions. The XXX part is the actual package name used in the text below.
Their classes must be in jar archive(s) in the directory /usr/share/java, with the name packagename[-extraname]-fullversion.jar. The extraname is optional and used internaly within the package to separate the different jars provided by the package. The fullversion is the version of that jar file. In some cases that is not the same as the package version.
Some package must also provide a symbolic link from packagename-extraname.jar to the most compatible version of the available packagename-extraname-version.jar files.
All jar files must have a well-documented CLASSPATH, so that developers should know what to add to their wrappers.
This applies only to libraries, not to the core classes provied by a the runtime environment.