hello world tutorial

[Martin DeMello]

One thing I'm missing is a "hello world" tutorial, something that
takes me step by step from opening up a fresh jazz install to creating
a standalone executable that prints "hello world" out to the console
and in a dialog box. Does such a thing exist anywhere? If not, could
someone please type up a step-by-step howto - I'm having trouble
getting started, and would rather understand what's going on than cut
and paste stuff from the samples. I'd be happy to add screenshots and
expand the text into a full-fledged tutorial once I've caught on.

martin

[Guillaume Cartier]

Getting started in Jazz can indeed be challenging.

The good news is that once you get over the first bump it is extremely easy to further learn by example using all the code introspection tools available in the Jedi IDE as almost everything available in Jazz is used somewhere in Jedi. For instance :

• You see a button that does something and are wondering how it works: press F8, move your mouse over the button, right-click and select "Edit Action" (or "Edit Action Handler" depending) and you'll be taken to the source code implementing that button.
• Same thing for menu items. Just open the menu, press F8, move your mouse over the item, right-click, ... (this doesn't work for menus on X11 unfortunately I think)
• If the code you are looking for happens through a shortcut, go to the Tools / View Shortcut Bindings... menu item (ctrl-shift-k), press the shortcut and double-click the desired binding and you'll be taken to the source code that implements that binding.
• Once in the code, as Jazz catalogs all source code for definitions and references, it should be very easy to navigate further. First, you might want to make sure your catalogs are up-to-date by going to the Tools / Catalogs Manager window and pressing Update (note that once this is done, the IDE will maintain your catalogs up-to-date automatically with any change you make to the source code, you just have to do this after pulling new changes). This done, just put the text selection in any symbol you want and press F12 to edit that definition or shift-F12 to view a list of all definitions using that symbol.

Hope this helps.

PS: Regarding an "Hello World" tutorial, I'll try and write one in the next few days and add it to the http://www.jazzscheme.org/tutorials.htm page. Once thing. Would you prefer a tutorial in pure Jazz or a tutorial from the standpoint of creating an application using Jedi?

Guillaume

[Martin DeMello]

On Sat, Oct 3, 2009 at 6:55 PM, Guillaume Cartier
<gcar...@jazzscheme.org> wrote:
> PS: Regarding an "Hello World" tutorial, I'll try and write one in the next
> few days and add it to the http://www.jazzscheme.org/tutorials.htm page.
> Once thing. Would you prefer a tutorial in pure Jazz or a tutorial from the
> standpoint of creating an application using Jedi?

What would the difference be? If you're talking about the "create new
project" skeleton, that's an excellent feature and should be
mentioned, but my problem with it was that I didn't really end up with
any sort of deep understanding about the code it generated, so a pure
tutorial would make a better starting point.

Thanks for the write up about exploring the code behind the IDE; I'm
looking forward to playing with that.

martin

[Guillaume Cartier]

Hi Martin,

I added a new "Hello World in many flavors!" section to the tutorials
page: http://www.jazzscheme.org/tutorials.htm.

By building up step by step to what the IDE automatically generates
for you when you create a new project, I hope it will help in getting
a better understanding of the underlying structure of repositories,
packages, modules, libraries and products.

Guillaume

[Martin DeMello]

thanks, guillaume, that looks excellent!

martin