docblox/docblox — Issue #330: Add validation: show error if there is no @return tag whilst the function or method had a return keyword followed by a value
Author: mvriel
Created: 2011-12-24 18:48:43+00:00
State: open
Labels: Improvement

A @return tag is missing, when there is at least one occurrence of the word "return" in the function / method.
Important to note is that this only counts if the return keyword is followed by anything. An empty return counts as void and some coding standards are not inclined to include a '@return void'

This issue was part of #34 but was promoted as DocBlox currently does not know whether a return had occurred and this goes beyond the scope of mere validators.