[futurebasic] Re: [FB] [FB5] Documentation of window(_wndRef)

Message: < previous - next > : Reply : Subscribe : Cleanse
Home   : August 2009 : Group Archive : Group : All Groups

From: Robert Covington <artlythere@...>
Date: Thu, 6 Aug 2009 04:07:40 -0400
On Aug 6, 2009, at 4:03 AM, Robert Covington wrote:

>
> On Aug 6, 2009, at 1:38 AM, Brian Stevens wrote:
>
>>
>> On Aug 5, 2009, at 7:00 PM, Ken Shmidheiser wrote:
>>> Considering the importance of obtaining the current WindowRef for  
>>> Carbon controls, I would think it should be mentioned in the FB  
>>> Help Window function heading.
>>
>> Maybe it should have more prominence for some folks but maybe not  
>> for others.
>
> Say what??
>
>> FBers using nibs and CE would never use this statement to obtain a  
>> WindowRef. Some FBers using FB events and window numbers might not  
>> have occasion to use the function either.
>>
>> The first pass on the FB help was to weed out the obvious ( and  
>> even some of those were missed ) FB5 incompatibilities. That  
>> process took several months with several folks re-writing the  
>> descriptions and updating the brief examples in the ref to  
>> coincide with FB5. Mostly it was either removal or update. There  
>> was no attempt to reorganize the content based on priority or  
>> importance. Reference manuals typically are alphabetical tomes  
>> with no attempt to prioritize some text; Some things can be moved  
>> and the WindowRef function might be a candidate.
>>
>> At some point a programmer's ( something akin to the old FB II  
>> Handbook for those who remember that ) guide that covers subjects  
>> ( e.g. How to open/close/read/write files might be one good  
>> chapter ) and goes beyond what can be done in a reference manual  
>> ( which is the current focus ) and by its nature lends itself to  
>> more creative structuring for the target audience might be a worthy 
>> ( albeit large ) project.
>>
>> Brian S
>
>
> This over-analysis is way off into missing the point.   I would  
> think the correct response would be, "Thanks for the heads up,  
> we'll add the entry to correct the situation ASAP for the next  
> release."
>
> I was myself confused about the lack of an entry last time I was  
> looking for that , and NIB or anything has nothing to do with  
> whether a help file should include it.
>
> Robert

And now RP writes:

> You somehow missed it.
>
>    window function
>
>    Syntax:
>    WindowInformation = window(expr)
>    ...
>    ...
>    window(_wndPointer or _wndRef) returns a pointer to the Window  
> Record of the current output window.



I guess were  both out to lunch here.  Bleh! :(  ;)  I just don't get  
the over-analyis , for either this, or me posting a function just  
trying to help somebody else out.

Robert