update java api comments