Hi,
I submitted a review for java-gnome and working on that made me think the Java guidelines needs work, so here's a suggested update:
https://fedoraproject.org/wiki/User:Abo/JavaPackagingDraftUpdate
=== Changes ===
Removed some occurances of a Unicode control character that didn't seem to belong there.
Fixed formatting of the text under "Jar file naming".
Hopefully clarified the text under "Directory structure".
Changed some occuranced of "<code>%{_xxx</code>}" into "<code>%{_xxx}</code>".
Changed -javadoc Group tag from "Development Documentation" to "Documentation".
Mostly rewrote the section on JNI packaging. (See wiki.)
Removed this text:
The <code>%{_jnidir</code>} rpm macro defines the main JNI jar repository. Like <code>%{_javadir</code>} it is declined in <code>-ext</code> and <code>-x.y.z</code> variants. It follows exactly the same rules as the <code>%{_javadir</code>}-derived tree structure, except that it hosts JAR files that use JNI.
<code>%{_jnidir</code>} usually expands into <code>/usr/lib/java</code>.
It seems to belong to the "The plan is to eventually..." part, but I don't really understand it. Explain and I'll add something back. :)
Partially rewrote the section on prebuilt binaries and the suggested % prep section. (See wiki.)
/abo