<!doctype html public "-//W3C//DTD W3 HTML//EN">
<html><head><style type="text/css"><!--
blockquote, dl, ul, ol, li { padding-top: 0 ; padding-bottom: 0 }
--></style><title>Re: [KCP] SystemDictionary cleaning: Comments and
desi</title></head><body>
<blockquote type="cite" cite>The comment in the method is not only
badly spelled, it says # when<br>
it means @. I don't know who 'sw' is, but the method went in
on</blockquote>
<blockquote type="cite" cite>2002.06.10</blockquote>
<div><br></div>
<div>I don't know who he is either, but I agree he should be
shot.</div>
<div><br></div>
<div>FWIW, here's the comment in question, complete with the two typos
;-)</div>
<div><br></div>
<div><b>pointOrNilFrom: aString</b></div>
<blockquote><i>"Lightly parse aString, looking for either of two
syntaxes -- integers separated either by a # character or by a comma,
as illutrated by the following, which are equivalent:</i></blockquote>
<blockquote><i><x-tab>
</x-tab><x-tab> </x-tab>2 @
3</i></blockquote>
<blockquote><i><x-tab>
</x-tab><x-tab> </x-tab>2 ,
3</i></blockquote>
<blockquote><i>If the input fits one of these patterns, return the
Point object represented; anything else will result in nil being
returned.</i>"</blockquote>
<div><br></div>
<div><br></div>
<div>Incidentally, for those who may not know, a good way to discover
the history and the context of any method that you wish to delve into
is to look at the change-sets in which it occurs. To do this,
choose "change sets with this method" from the shifted
selector-list menu of a code tool that is pointed at the method.</div>
<div><br></div>
<div>If you do this for Utilities.pointOrNilFrom:, you'll immediately
get a change-sorter pointed at this method's originating change-set,
with the "preamble" showing. This will reveal who
wrote the code, and when, and why, and will show all the methods
involved, and there's also a remark there about a desired
improvement.</div>
<div><br></div>
<div>Cheers,</div>
<div><br></div>
<div> -- Scott</div>
<div><br></div>
<div><br></div>
</body>
</html>