On Mon, Oct 19, 2009 at 05:45, <chris_schm...@users.sourceforge.net> wrote:
> Revision: 20405
> http://qooxdoo.svn.sourceforge.net/qooxdoo/?rev=20405&view=rev
> Author: chris_schmidt
> Date: 2009-10-19 09:45:48 +0000 (Mon, 19 Oct 2009)
>
> Log Message:
> -----------
> [ASSIGNED - bug 2912]: Window restore method and events
> http://bugzilla.qooxdoo.org/show_bug.cgi?id=2912
>
> - removed "@return {void}" from API doc
>
Why? That's useful information. Don't forget that this information is not
used solely by the API viewer, but also by "real people" looking at the
documentation. If it doesn't say @return {something} then we have no way of
knowing whether it really doesn't return anything, or if someone just forgot
to add the @return documentation... which requires searching through the
code to see if, in fact, there is a returned value.
I would really appreciate having @return {void} left in the documentation.
Derrell
------------------------------------------------------------------------------
Come build with us! The BlackBerry(R) Developer Conference in SF, CA
is the only developer event you need to attend this year. Jumpstart your
developing skills, take BlackBerry mobile applications to market and stay
ahead of the curve. Join us from November 9 - 12, 2009. Register now!
http://p.sf.net/sfu/devconference
_______________________________________________
qooxdoo-devel mailing list
qooxdoo-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/qooxdoo-devel