See my comment above on the @param tag. Seems to equally apply to the return statement as well.