Is it necessary to warn about the @doc attribute for a private function

[jeramyRR]

@Nicd

Private functions do not have descriptions to display in programming tools when suggesting or looking up docs of a function, since they do not use the structured @doc that is used for that. It would be useful to see the description of a private function without scrolling.

This is another good point. Tooling picks up the @doc tags for functions, but doesn’t for regular comments.