On Feb 17, 1:12 pm, leo <ponton....@gmail.com> wrote:
> @Andy
>
> > Why add comments?
>
> The API extracts the comments from the code. Therefore, the function
> should be comprehensively commented. Staying with the example of find,
> without reference to the deprecated function findNeighbours, it is not
> possible to see what parameters need to be passed without delving into
> the source.

Leo,

"> examples. Better would be comments in the cookbook, "

You're mixing up comments on book.cakephp.org with doc blocks on
api.cakephp.org
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"CakePHP" group.
To post to this group, send email to cake-php@googlegroups.com
To unsubscribe from this group, send email to 
cake-php+unsubscr...@googlegroups.com
For more options, visit this group at 
http://groups.google.com/group/cake-php?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to