java conventions; addl java doc