'by' has been removed and overall javadoc of the class improved - https://github.com/aheil/openhab/commit/66f591bbc002205077d0ecece0c34073ea651712