java-common is documentation. Java Policy is ... policy. Java FAQ is something interesting. It should be updated. How about using XML Docbook, like Java Policy, instead of SGML debiandoc? Something like: http://www.baizid.org/cgi-bin/viewcvs.cgi/home/ahmed/work/debian/java-common/debian-java-faq/I have done it by hand (gvim) because I did not find a easy tool. It is not valid Docbook yet.