+1

T.

Derrell Lipman wrote:
On Mon, Oct 19, 2009 at 05:45, <chris_schm...@users.sourceforge.net <mailto:chris_schm...@users.sourceforge.net>> wrote:

    Revision: 20405
http://qooxdoo.svn.sourceforge.net/qooxdoo/?rev=20405&view=rev
    <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-commit mailing list
qooxdoo-com...@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/qooxdoo-commit
------------------------------------------------------------------------------
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

Reply via email to