Created HSEARCH-2944 In Progress to address the javadoc issue. Moving this ticket to 6, because it would involve breaking APIs. But I think it would be a good idea to consistently use longs.