[V4REV] Advice 2 about func names

[Robert Brenstein]

>On 5/13/05 1:45 PM, "Robert Brenstein" <rjb at robelko.com> wrote:
>
>>>>  The first variant proposed by Ruslan had Valentina_ as prefix for all
>>>>   calls, so at least it was painfully clear where they are coming from.
>>>>   The second variant has only V up front that is common and that makes
>>>>   me uncomfortable.
>>>
>>>  We will have:
>>>
>>>      Valentina_
>>>      Vdatabase_
>>>      Vtable_
>>>      VLink_
>>>      VSet
>>>      VServer
>>>
>>>  PLUS another action word.
>>>  You think this can conflict to somebody? I doubt.
>>
>  > In some projects, I use 'v' as prefix to denote local variables. I
>>  may not be the only one. There may be no direct name conflicts by
>>  certainly a confusion as to what is what is possible.
>>
>>  As I said in the other email, I would prefer
>>
>>       val
>>       valDatabase
>>       valTable
>>       valLink
>>       valSet
>>       valServer
>>
>>  That makes them all very clearly associated with Valentina without
>>  anyone having to think about it. Or am I the only one who cares?
>
>Problem with such way is that it will differ from
>
>REALbasic:  
>         VDatabase
>
>Director
>         VDatabase
>
>Java
>         VDatabase
>
>And so on...
>
>If others agree to have Vdatabase names I think we will go with such
>names...
>
>--
>Best regards,
>
>Ruslan Zasukhin

By pure coincidence, there are discussions on re-use list about 
databases and you must have noticed that the prefix for database 
handlers was revdb and then extended to revDatabase -- yes, even 
longer and more explicit. Yes, transcript is more verbose than other 
environments.

revDatabase clearly tells us that it is database call from rev IDE. 
And that is why I think valDatabase would be clearer than vDatabase 
by associating the name more explicitely with Val'entina and thus 
matching the environment and user expectations better.

Yes, Ruslan, we realize that it would be simpler for you to have same 
names in all environments, but... you are just producing it and we 
have to use it. And I doubt that Rev developers care much about how 
those functions are called in RealBasic or Director.

I mean, interally, you can call them whatever, but public interfaces 
(which it seems you would not be changing that often) would be better 
with longer prefix.

Of course, we can live with V only and get used to it, but I think 
setting it longer is in your own interest.

'nough said.

Robert