I tried $ first, but it scans so close to an S that it hurt readability.

-----Original Message-----
From: Greg Hendershott [mailto:greghendersh...@gmail.com] 
Sent: Friday, July 03, 2015 11:53 AM
To: John Carmack
Cc: racket-users@googlegroups.com
Subject: Re: [racket-users] API function naming

One idea is to use $ as prefix.

It probably connotes "command" among Unix-y folks, at least.

(Although I've seen $ used as a prefix in e.g. combinator libraries like 
Parsack, I don't think it has any universal meaning like that which would make 
it seem weird for your purposes?)


On Fri, Jul 3, 2015 at 12:41 PM, Greg Hendershott <greghendersh...@gmail.com> 
wrote:
> I'd avoid @ because it's used for "at-expressions", e.g. #lang 
> scribble or even simply #lang at-exp racket.
>
>
> On Fri, Jul 3, 2015 at 12:32 PM, John Carmack <jo...@oculus.com> wrote:
>> I am using a “cmd-name!” naming format for functions that are adding 
>> to the command list that will be communicated to the host program.
>>
>>
>>
>> (cmd-sound! WAV-FILE)
>>
>> (cmd-set-position! pos yaw-radians)
>>
>> Etc.
>>
>>
>>
>> I am considering using a terser naming convention, perhaps “@name”, 
>> so you would have:
>>
>> (@sound WAV-FILE)
>>
>> (@set-position pos yaw-radians)
>>
>> Etc.
>>
>>
>>
>> I would argue that while they do mutate global state by sticking 
>> something on a list, the list is never looked at except at the very 
>> end of the frame to hand it over to the host system, so they are more 
>> like a display / log function that a global state hazard, and having 
>> a syntax cue for functions that are going to impact the sensory presentation 
>> may be useful.
>>
>>
>>
>> Thoughts?  What symbols have the least historic baggage?
>>
>>
>>
>>
>>
>>
>>
>> --
>> You received this message because you are subscribed to the Google 
>> Groups "Racket Users" group.
>> To unsubscribe from this group and stop receiving emails from it, 
>> send an email to racket-users+unsubscr...@googlegroups.com.
>> For more options, visit 
>> https://urldefense.proofpoint.com/v1/url?u=https://groups.google.com/d/optout&k=ZVNjlDMF0FElm4dQtryO4A%3D%3D%0A&r=Kjg6LltY9QjkipKooaVldA%3D%3D%0A&m=3sT2b8Ee4ORHnImx7YLz8vXTDIljXVXZTGVhfs2xyPM%3D%0A&s=999028754ff1a2cbad33512421e2e5c7c1f27b6448cbb0ea4ca14c43f84d4ff5.

-- 
You received this message because you are subscribed to the Google Groups 
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to racket-users+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to