clue-2-0-0-development-beos-5-0

Main Repository Page

Development

Debugging

clue-2-0-0-development-beos-5-0 Download

Thumbnails:

Description:

About Clue:

The most comprehensive open-source BeOS GUI/API/Object tracing tool, allowing inspection on almost all of the BeOS native objects (309 ATM). Clue is analogous to printf, for BeOS programmers. Clue allows you to easily view printf-like statements from several apps. Clue separates the messages from different apps (even different instances of the same app) into a clean, easy to view window.

Clue is an Open Source (LGL) project, currently hosted on Source Forge:

http://sourceforge.net/projects/clue.

The General Mailing List is accessible on Source forge:

https://lists.sourceforge.net/lists/listinfo/clue-general.

Details of the CVS archive (which contains the latest compiling Clue) are at:

http://sourceforge.net/cvs/?group_id=101267

Debugging on Haiku just got easier on 20060626 Haiku runs the previous version clue-2-0-0-development-beos-5-0.

This development version contains 309 traceable BeOS objects. If you look at the documentation, all of the objects in bold have not been fully written yet, but they will work. Made some changes to the UI to allow more granular choosing of what objects will be sent.

You can start Clue at any time, it doesn't have to be started before you run your app. It's efficient in that the client app only sends data that matches the Event selection filter in Clue. The second you change your filter in Clue, it's applied immediately to all client apps.

The Clue trace statements are as minimal as possible and follow the printf format you already know. There are four different calls you can make: TRACE_CLASS, TRACE_METHOD, TRACE_OBJECT, and TRACE_SIMPLE. Here is an example:

TRACE_SIMPLE ((CC_APPLICATION, CR_INFO, "some number = %i", number));

With this small statement, the following items will be sent to Clue:

what Category it belongs to
what Event in that Category it belongs to
the class method name
the class name
the file name that the class exists in
the line number that generated the message
the thread id
an application-wide, unique sequence number
the date it was sent
the exact time it was sent
some programmer description for the event
and optionally (for TRACE_OBJECT only), detail data

The TRACE_OBJECT macro is like PrintToStream on steroids, but it is much more than that. TRACE_OBJECT allows for Inspection on many BeOS classes that don't have a PrintToStream function, or items that can't have a PrintToStream function like enums.

Included in the zip download is a sample application that shows how to easily program for Clue. Also included is extensive, graphical documentation on how to use and program for Clue.

Clue now exists in six different laguages: English, German, French, Russian, Portuguese, and Czech, with Spanish and Swedish coming soon. If I missed your language, there is an included file that you need to translate into your language, send it to me, and I will build your localized version.

Submitted On: