[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: Questions in/on the code [was: svn commit: r33900 - trunk/subversion/libsvn_wc]

From: Justin Erenkrantz <justin_at_erenkrantz.com>
Date: Wed, 29 Oct 2008 10:17:13 -0700

On Wed, Oct 29, 2008 at 9:34 AM, Greg Stein <gstein_at_gmail.com> wrote:
> If I'm reading code, then I *want* those questions in there. It tells
> me to be wary. To find out more. That what I'm looking at my be
> suspect. It is INFORMATIVE.

At the risk of sounding like a broken AOL bot, ditto again. =)

It's a "here be dragons" caution light - it probably also indicates
that whomever wrote the code initially didn't do a very good job of
documenting/commenting the code in question. But, at least leaving a
breadcrumb comment would do just a smidge to resolving this. --
justin

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe_at_subversion.tigris.org
For additional commands, e-mail: dev-help_at_subversion.tigris.org
Received on 2008-10-29 18:17:28 CET

This is an archived mail posted to the Subversion Dev mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.