r3wp [groups: 83 posts: 189283]
  • Home
  • Script library
  • AltME Archive
  • Mailing list
  • Articles Index
  • Site search
 

World: r3wp

[!REBOL3]

Kaj
10-Jan-2011
[6832x2]
For what it's worth, the cURL binding supports proxies
Currently only through environment variables. I don't know if that 
works on Windows
Pavel
10-Jan-2011
[6834]
Kaj full respect to your effort, in the other hand the proxy seems 
not to be overcomplicated. it may be a good training task, in R2 
it has maybe 20 lines. question is if there is some architectual 
restriction (for example synchronous / asynchronous etc.)
Kaj
10-Jan-2011
[6835]
It sure would be nice if you implemented it
Ladislav
11-Jan-2011
[6836x2]
Remembering the function naming discussion from the !REBOL3 GUI group 
and seeing the 

http://curecode.org/rebol3/ticket.rsp?id=667&cursor=1#comments

I could not help but point out:


As I see it, not using the question mark *is* violating a naming 
principle that was explicitly stated. I know, that in REBOL we don't 
have to be that rigid, but, when we have explicitly stated a principle, 
we *should* stick to it. ( http://www.rebol.com/r3/docs/concepts/scripts-style.html#section-10
)
http://curecode.org/rebol3/ticket.rsp?id=1818&cursor=1
Pekr
11-Jan-2011
[6838x3]
The we should stick to principles. But I am not sure even Carl himself 
is strictly following the rules. In his doc he claims, that 'quit 
is as clear, as quit-system. Well, we have 'do, and we have 'do-browser, 
'do-service, where we are breaking on encapsulation rules, with excuses 
to not polutu 'do's name-space (not complicating it - because in 
other words, the proper way is to use refinements, as do-browser 
could be do/browser as well)


What is a bit tricky about question marks is, that the meaning is 
not clear enough,e.g. - modified? Does it stand for the logic value, 
returning the true or false, or does it stand for the return of modification 
date? How should user know?


That is just my opinion on this topic - sometimes things are not 
easy to sort-out. Rules are rules, and we should probably stick to 
them ... the other thing is, if we are not forgetting another rebol 
"rule" (or at least principle) - make things pop-out to your mind 
at first sight, if possible. So - what is more self-explanatory - 
faces?, or get-faces (or what was the suggestion alternative)?
Take my notes as just another point-of-view,not a counterclaim to 
what you stated ...
You second ticket is interesting indeed ....
Ladislav
11-Jan-2011
[6841x3]
The points you made are intelligent and need a discussion, so, here 
goes:
'quit vs. 'quit-system and 'do vs. 'do-browse: Carl just pointed 
out, that if the -system part was unnecessary, it shouldn't have 
been used. That is clearly not the case of 'do vs. 'do-browse, where 
the second part cannot be seen as unnecessary
Whether to prefer 'do-browser or do/browser - such a principle was 
not stated explicitly, so, we do not have any "guide" which one shall 
be preferred
Pekr
11-Jan-2011
[6844x3]
Well, I think I know why we went with do-*, open-* - simply to not 
overload those functions with refinements, and hence slowing them 
down ...
Carl should comment. The question is, if you can get his attention 
- he is not much active in R3 user-land last 2-3 months ....
I would suggest you going with faces? then, we can always change, 
while in alpha mode ....
Ladislav
11-Jan-2011
[6847x3]
modified? Does it stand for the logic value, returning the true or 
false, or does it stand for the return of modification date? How 
should user know?

 - the function name rarely suffices to inform the user what exactly 
 the function does. In such a case it is the task for the doc string 
 to inform the user, or, we should use two words, as described in 
 the doc.
(even the doc string may be insufficient, and an online documentation 
should be consulted in some cases)
As far as the 'faces? vs. 'get-faces names are considered, they both 
adhere to the function naming convention. The only advantage of the 
'faces? name is, that it is just one-word, so it is "more in the 
line" with the function naming convention in my opinion)
Pekr
11-Jan-2011
[6850]
just a note - actually, it was not get-faces, but faces-of, IIRC?
Ladislav
11-Jan-2011
[6851]
'get-faces was your original proposal, AFAIR. Nevertheless, the 'faces-of 
name, which looked as preferred by the majority, is clearly violating 
the above function naming convention.
Oldes
11-Jan-2011
[6852]
for me it's more important how it looks in code.. so it's for example:
	foreach face faces? window [ ... ]
vs.
	foreach face faces-of window [ ... ]
Ladislav
11-Jan-2011
[6853x3]
And, in fact, it is a C naming convention, except for the fact, that 
in C it would need to be faces_of
One of the possible solutions is to just add the *-of as an alternative 
convention, and have the option to choose. The only problem remaining 
is, that it uses two words instead of one.
What is interesting (and surprising me), is the fact, that, not reading/remembering 
the REBOL function naming convention, lots of people immediately 
were able to define any kinds of "ad hoc rules" which (purportedly) 
were in effect in Rebol for function naming, and used that as their 
argument why their preferred name was in accordance with the REBOL 
function naming convention.
Andreas
11-Jan-2011
[6856]
I always had the impression that the "word names" section in the 
style guide is more descriptive than prescriptive. To that effect, 
I'm very much in favour of documenting *-of as an alternate convention.
Pekr
11-Jan-2011
[6857]
We should state that in above ticket as na alternative, if already 
not there ...
Kaj
11-Jan-2011
[6858x3]
Sorry, but it makes no sense to interpret this optional convention 
strictly. If we do, we also have to do the following renames:
about? abs? absolute? alias? arccosine? arcsine? arctangent? as-binar? 
as-pair? as-string?
I hope you can find the rest yourself for b-z
Ladislav
11-Jan-2011
[6861]
about is not a noun as far as I know, abs is not a noun as well...
Kaj
11-Jan-2011
[6862]
Your previous argument, as I remember it, was that this convention 
applies to properties
Ladislav
11-Jan-2011
[6863]
no, my argument was, that we have a convention for naming functions
Kaj
11-Jan-2011
[6864x2]
Yes, a convention, not a low cut out in stone, and we already established 
that only a select subset of standard words conforms to it
a law
Ladislav
11-Jan-2011
[6866]
so what, your argument does not apply anyway, except for some nouns 
naming math operations
Kaj
11-Jan-2011
[6867]
So, it's not consistent
Ladislav
11-Jan-2011
[6868]
yes, that is what I pointed at using words-of, etc. as examples. 
Your examples do not apply, since they are either nouns naming math 
operations or not nouns at all.
Kaj
11-Jan-2011
[6869x2]
Every variable name is a noun, in principle. Do we have to use question 
marks on all variables?
Why would only math operations be excempt from this law?
Ladislav
11-Jan-2011
[6871]
it is hard to use a logic argument when you refuse to discern nouns 
from other words, but, in that case, you are unable to stick to the 
function naming convention anyway, and I don't know what do you want 
to discuss
Kaj
11-Jan-2011
[6872]
How am I refusing to discern nouns from other words?
Ladislav
11-Jan-2011
[6873]
Every variable name is a noun, in principle.
Kaj
11-Jan-2011
[6874x2]
How is that not true?
I mean variable in the sense of traditional programming languages
Ladislav
11-Jan-2011
[6876]
we do not have "variable names" we have words
Kaj
11-Jan-2011
[6877x3]
See above
foreach [cat? dog?] [1 2 3 4] [fight cat? dog?]
This would be the result of your rule
Ladislav
11-Jan-2011
[6880x2]
this would be the result?
*very unlikely*