How about making commented lines of code as part of method description in  javaDoc.