Smalltalk › Squeak › Squeak - Dev

The Inbox: Sound-wiz.16.mcz

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

2 messages Options

Jerome Peace

The Inbox: Sound-wiz.16.mcz

The Inbox: Sound-wiz.16.mcz

"The difference between the almost right word & the right word is really a large matter--it's the difference between the lightning bug and the lightning." --Mark Twain

"Omit needless words. Omit needless words. Omit needless words." William Strunk, Jr. The Elements of Style

Hi Bert,

>Bert Freudenberg bert at freudenbergs.de
<...>
>But you seem to have missed the discussion that we do not want it to be named #sound, but #asSound. Please resubmit.
>
Actual I didn't miss that discussion. I just haven't completed it.

My first reaction was to think that if all I needed to do was change the name it would be effectively the same. Sitting with that thought I grew more uncomfortable.

It's true that there is a style for conversion that uses asXYZ. But it is also true that there are conversions that take place that avoid that style. One doesn't say "String new asWriteStream" one says "String new writeStream." Other examples abound if one cares to look for them. They don't call attention to themselves because they don't sound awkward as asXYZ sounds.

My original story was to implement #asSound but a big smile came on my face when I said "'click' sound play" aloud. I'd come as close to what I want my code to read like as I can make it. You've come with my thinking this far. Can I convince you to come the rest of the way?

The rest of the nits I am happy to fix. Thanks for the feedback.

Yours in curiosity and service, --Jerome Peace

Chris Muller-3

Re: The Inbox: Sound-wiz.16.mcz

I don't know if these other example are congruent with Jeromes but, we
also have:

3 hours + 4 minutes

and not

3 asHours + 4 asMinutes

In my personal image, I implemented, Integer>>#hundred, #thousand,
#million and #billion so I could write things like:

3 hundred million

instead of

300000000 or 3e8

It's just about "readability" and language-flow, that's all.

On Thu, Apr 22, 2010 at 9:28 PM, Jerome Peace
<[hidden email]> wrote:

> The Inbox: Sound-wiz.16.mcz
>
> "The difference between the almost right word & the right word is really a large matter--it's the difference between the lightning bug and the lightning." --Mark Twain
>
> "Omit needless words. Omit needless words. Omit needless words." William Strunk, Jr. The Elements of Style
>
> Hi Bert,
>
>>Bert Freudenberg bert at freudenbergs.de
> <...>
>>But you seem to have missed the discussion that we do not want it to be named #sound, but #asSound. Please resubmit.
>>
> Actual I didn't miss that discussion. I just haven't completed it.
>
> My first reaction was to think that if all I needed to do was change the name it would be effectively the same. Sitting with that thought I grew more uncomfortable.
>
> It's true that there is a style for conversion that uses asXYZ. But it is also true that there are conversions that take place that avoid that style. One doesn't say "String new asWriteStream" one says "String new writeStream." Other examples abound if one cares to look for them. They don't call attention to themselves because they don't sound awkward as asXYZ sounds.
>
> My original story was to implement #asSound but a big smile came on my face when I said "'click' sound play" aloud. I'd come as close to what I want my code to read like as I can make it. You've come with my thinking this far. Can I convince you to come the rest of the way?
>
> The rest of the nits I am happy to fix. Thanks for the feedback.
>
> Yours in curiosity and service, --Jerome Peace
>
>
>
>
>
>
>