Re: [Fxruby-users] [ANN] Updated API Documentation

[Hugh S. S. E. E. <hg...@dm...>]

On Mon, 9 Jun 2003, Lyle Johnson wrote:

> Hugh Sasse Staff Elec Eng wrote:
>
> > true or false.  Does this affect the return value for <a method>?....
>
> OK, just made a note of this. But to answer the question, no, the return

Thank you.
>
> > seems, from looking at the draw methods, that you don't draw on an
> > FXCanvas, you draw on an FXDC.  [cf "How do you get down from an
> > elephant?"]  The media independence is good, but for someone coming
>
> Your point is well taken. A lot of the more interesting information
> about classes like FXDC is not their API in isolation, but rather how
> they plug into the surrounding framework and interact with other classes

Yes, that's better expressed than I put it.

> (like FXCanvas). At the least, I should be able to link to other classes
> and methods that RDoc knows about (i.e. a "see also" approach). Not sure

Thanks.
> what facilities, if any, RDoc provides for a more general solution to
> the challenge of cross-referencing related ideas.

I know it can have cross references, but I don't think it can
genrate them.
>
> By the way, thanks for making me look up the answer to the riddle. I
> will let others google for the answer as I did ;)

! I thought it had been around a while, so it would be well known.
:-)
>
> > I find myself wondering if this flexibility should be exposed
> > to every programmer, or whether a simpler wrapper might be useful
> > for the neophyte or the writer of the quick, throwaway bit of code.
>
> Which flexibility are you talking about? Attaching a device context (DC)
> to a canvas before you can draw into it?

Yes, for that particular case.  I'm not sure what others there are.
>
> > [...]creating FXRdoc, [...]
>
> Have you seen the class browser from FreeRIDE? It doesn't work exactly

Good point. I have to explore that.  Is it very tied to Scite, or
can I use it with Vim?
>
>
        Thank you
        Hugh