None Re: ruby module and class access using :: - calmze - com.googlegroups.sketchupruby

10 messages in com.googlegroups.sketchuprubyNone Re: ruby module and class access...

From	Sent On	Attachments
calmze	01 Jun 2008 10:12
Todd Burch - Katy, Texas	01 Jun 2008 14:37
calmze	01 Jun 2008 15:29
Todd Burch - Katy, Texas	01 Jun 2008 18:42
calmze	01 Jun 2008 20:26
Todd Burch - Katy, Texas	02 Jun 2008 05:03
David	02 Jun 2008 10:27
Todd Burch - Katy, Texas	02 Jun 2008 13:45
calmze	02 Jun 2008 16:26
Todd Burch - Katy, Texas	02 Jun 2008 19:18

Subject:	None Re: ruby module and class access using ::
From:	calmze (cal...@gmail.com)
Date:	06/02/2008 04:26:52 PM
List:	com.googlegroups.sketchupruby

Hey Todd.

I sent you an email earlier from cal...@gmail.com, but I haven't received a response yet.

I requested the code you used to run a java calculator applet from ruby (using some sort of javascript extension?), and the example test files from the docs.

Thanks.

On Jun 2, 4:45 pm, "Todd Burch - Katy, Texas" <mr.t...@gmail.com> wrote:

I am not a Google employee, just a "connected" long time user.

Google knows the doc needs improving, and that's one of the reasons they created the Ruby Doc Wiki. (See above link). So far, there's only been 4 people with access to the online wiki doc, 2 Google employees and two non-googlites. (Me and Rick). We (Rick and me) are part of the SketchUp beta program too, and report lots of bugs to Google through our development of free and commercial scripts.

As far as other doc, there really isn't much. I have received special doc as part of beta testing before, but that has to stay in the non- disclosure-agreement realm of my hard drive. Nothing earth shattering, and probably even obsolete now.

So, yes, we've all had to do some hacking, and we all help each other out as a community. When I get stuck, I email the Google developers I know. I pass any information on that I know when a request for it arises.

Since I'm not being paid or otherwise compensated for keeping the doc updated, I do it as I feel like it. The user interface for editing the doc sucks, so that another stimulant for procrastination for me as well.

Observers are new for V6, and the doc is literally non-existent. It's a shame it was released in the state it was, and Google hasn't provided any updates. However, I will thank Google for adding the Observer API, as I asked for it back in 2005.

Are either of you attending 3D BaseCamp? I will be there, presenting, and if you wanted to get together to talk about Ruby doc, I would welcome that meeting. We could probably wrangle a Google developer and/or Google development manager in there too.

Your theory about "more doc out there" might be true, but if there is more doc, I am not aware of it. There are now three different web sites with Ruby doc:

The one available through SketchUp Help->Ruby Help The one available through the Ruby Doc Wiki (above link) and the one available on Google Development web
site.http://code.google.com/apis/sketchup/docs/developers_guide/index.html

Now that Google has 3 separate web sites with doc in it, I have absolutely no clue how they will keep all 3 updated. Nor do I know how and when the doc that I update will ever make it into the SketchUp Ruby Help web site. (Probably another reason I have not done a full frontal assault on correctly and testing it all)

On several occasions I've considered writing a document about ruby programming with SketchUp, even as late as over this last weekend. It's just a time commitment that I'm not ready to make, and for an unknown benefit as well (other than it would force me to explore every API, several of which I have not used).

Todd

On Jun 2, 12:27 pm, David <Hab...@gmail.com> wrote:

I have to agree with the OP that the SU Ruby API docs are very poor. Considering that the purpose is provide a mechanism for users to write plugins, the poor state of the docs is unfortunate.

Frankly, there are so many areas that need to be fixed (eg, most of the observer documentation doesn't reflect the observer being documented, the AppObserver link isn't even reachable by me, the same is true for many other links).

I don't know whether you are a Google employee or not, so I don't want to blame you, but Google has really dropped the ball with this and other areas since they acquired SU.

I do believe that there is more information out there that is not available to just anyone writing SU plugins. I'd just like to know how to get it. And, I'm not referring to Ruby language documentation, that is readily available.

On Jun 1, 8:43 pm, "Todd Burch - Katy, Texas"

<mr.t...@gmail.com> wrote:

I stand in favor and in praise of the SketchUp Ruby API doc. After working with other OO frameworks, I think the developers did a fine job.

Is it perfect? No.

Is it complete? No.

Did I (and do I still) struggle with it? Yes.

But with all that, I still signed up to assist in being a caretaker of it (the doc). If there are specifics that you would like changed or added, post them here and I'll do my best to get your improvements into the doc.

Constants are not classes. I would suggest you read up on the Ruby language. The scope operator is a Ruby thing, not a SketchUp thing.

Todd- Hide quoted text -

- Show quoted text -