Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > comp.lang.java.programmer > #24117

Re: Indentation styles

Show all headers | View raw

On 05/16/2013 12:28 AM, Daniele Futtorovic wrote:
> On 15/05/2013 23:47, Arved Sandstrom allegedly wrote:
>> On 05/14/2013 08:07 AM, Daniele Futtorovic wrote:
>>> On 14/05/2013 03:16, Stefan Ram allegedly wrote:
>>>> Jim Gibson <jimsgibson@gmail.com> writes:
>>>>> To my limited knowledge Java is the only language whose originating
>>>>> vendor publishes an "official" formatting standard.
>>>>
>>>>         »By convention, method names should be a verb in
>>>>         lowercase or a multi-word name that begins with a verb
>>>>         in lowercase, followed by adjectives, nouns, etc.«
>>>>
>>>> http://docs.oracle.com/javase/tutorial/java/javaOO/methods.html
>>>>
>>>>     The followers thus should write:
>>>>
>>>> calculateSquareroot( calculateSquare( x )+ calculateSquare( y ))
>>>>
>>>>     . Now, Rob Pike has the correct guidelines for us:
>>>>
>>>>         »Procedure names should reflect what they do;
>>>>         function names should reflect what they return.«
>>>>
>>>> http://www.lysator.liu.se/c/pikestyle.html
>>>>
>>>>     , thus:
>>>>
>>>> print( square( 2 ))
>>>
>>> square( x ) creates a two-dimensional square with x pixel side length,
>>> right?
>>
>> In the context of a graphing package I might expect that. In the context
>> of a math package I would not.
>
> Which package the method belongs to, or what a package is "about", is
> hardly a generally readily discernible information. And you might have a
> package that does both...
>
> But generally speaking, you see what I mean, don't you? That condensed
> form is ambiguous; the further condensed, the more ambiguous any form
> will be. There is beauty and elegance in subtlety; there is a lot of
> onanism in it, too. For our trade, I believe the Jav has it right in
> recommending more paraphrasing and hence more determinism -- especially
> readily apparent determinism.
>
Bad choice of words on my part, my headspace when I wrote that wasn't 
Java, it was more general. Think "software package", not "Java package".

In general I agree with you. I would understand 'square' as a method 
name to mean the mathematical operation, provided that the argument type 
made sense. This actually follows Pike's guidelines: 'square' used as a 
verb with a numerical (integer, real, complex, matrix etc) argument has 
one well-known meaning. It's not actually ambiguous at all.

But if the method were to do something different other than squaring a 
number, yes, it should have a better name.

AHS

Back to comp.lang.java.programmer | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

Re: Indentation styles Daniele Futtorovic <da.futt.news@laposte-dot-net.invalid> - 2013-05-07 17:56 +0200
  Re: Indentation styles lipska the kat <"nospam at neversurrender dot co dot uk"> - 2013-05-07 17:39 +0100
    Re: Indentation styles Wojtek <nowhere@a.com> - 2013-05-07 13:35 -0700
      Re: Indentation styles Martin Gregorie <martin@address-in-sig.invalid> - 2013-05-07 21:29 +0000
        Re: Indentation styles Arved Sandstrom <asandstrom2@eastlink.ca> - 2013-05-08 17:56 -0300
          Re: Indentation styles Arne Vajhøj <arne@vajhoej.dk> - 2013-05-12 22:07 -0400
            Re: Indentation styles Gene Wirchenko <genew@telus.net> - 2013-05-13 11:02 -0700
              Re: Indentation styles Arne Vajhøj <arne@vajhoej.dk> - 2013-05-13 19:04 -0400
                Re: Indentation styles Jim Gibson <jimsgibson@gmail.com> - 2013-05-13 17:34 -0700
                Re: Indentation styles Lew <lewbloch@gmail.com> - 2013-05-13 17:44 -0700
                Re: Indentation styles lipska the kat <"nospam at neversurrender dot co dot uk"> - 2013-05-14 09:26 +0100
                Re: Indentation styles Jim Gibson <jimsgibson@gmail.com> - 2013-05-14 10:23 -0700
                Re: Indentation styles Arne Vajhøj <arne@vajhoej.dk> - 2013-05-17 19:43 -0400
                Re: Indentation styles Arne Vajhøj <arne@vajhoej.dk> - 2013-05-17 19:42 -0400
                Re: Indentation styles Arne Vajhøj <arne@vajhoej.dk> - 2013-05-13 20:53 -0400
                Re: Indentation styles Daniele Futtorovic <da.futt.news@laposte-dot-net.invalid> - 2013-05-14 13:07 +0200
                Re: Indentation styles Arved Sandstrom <asandstrom2@eastlink.ca> - 2013-05-15 18:47 -0300
                Re: Indentation styles Daniele Futtorovic <da.futt.news@laposte-dot-net.invalid> - 2013-05-16 05:28 +0200
                Re: Indentation styles Arved Sandstrom <asandstrom2@eastlink.ca> - 2013-05-17 19:44 -0300
                Re: Indentation styles Stanimir Stamenkov <s7an10@netscape.net> - 2013-05-26 20:35 +0300
      Re: Indentation styles Joerg Meier <joergmmeier@arcor.de> - 2013-05-08 00:00 +0200
      Re: Indentation styles Gene Wirchenko <genew@telus.net> - 2013-05-08 11:12 -0700
  Re: Indentation styles Daniele Futtorovic <da.futt.news@laposte-dot-net.invalid> - 2013-05-07 23:57 +0200

csiph-web