UNITSOFMEASUREMENT-25: Adjust spec document to recent code changes 
Updated JavaDoc
Task-Url: https://java.net/jira/browse/UNITSOFMEASUREMENT-25