Index: /trunk/ccl/examples/cocoa/currency-converter/HOWTO.html =================================================================== --- /trunk/ccl/examples/cocoa/currency-converter/HOWTO.html (revision 7708) +++ /trunk/ccl/examples/cocoa/currency-converter/HOWTO.html (revision 7709) @@ -15,5 +15,5 @@

Creating Apple's + href="http://developer.apple.com/documentation/Cocoa/Conceptual/ObjCTutorial/index.html"> Currency Converter example
with OpenMCL @@ -34,5 +34,5 @@ Cocoa application that is functionally identical to Apple's + href="http://developer.apple.com/documentation/Cocoa/Conceptual/ObjCTutorial/index.html"> Currency Converter example. The most important difference between Apple's example and this one is that this @@ -64,5 +64,5 @@

It will be helpful in understanding this example if you can easily refer to Apple's + href="http://developer.apple.com/documentation/Cocoa/Conceptual/ObjCTutorial/index.html"> Currency Converter example while working through this HOWTO. You might consider opening a separate window or tab, and @@ -73,5 +73,5 @@ same. In particular, the Lisp example follows the same + href="http://developer.apple.com/documentation/Cocoa/Conceptual/ObjCTutorial/02Essence/chapter_2_section_4.html#//apple_ref/doc/uid/TP40000863-CH3-DontLinkElementID_6"> Model-View-Controller paradigm that the Apple example uses. If you are new to Cocoa programming, or if you are not @@ -102,14 +102,12 @@

Index: /trunk/ccl/examples/cocoa/currency-converter/HOWTO_files/pages/building_ui.html =================================================================== --- /trunk/ccl/examples/cocoa/currency-converter/HOWTO_files/pages/building_ui.html (revision 7708) +++ /trunk/ccl/examples/cocoa/currency-converter/HOWTO_files/pages/building_ui.html (revision 7709) @@ -20,4 +20,8 @@ describes in detail how to do this.

+
+

Apple's Tutorial

+
+

Apple's tutorial explains how to use InterfaceBuilder to create the user interface, and how to use XCode to create project files and @@ -26,52 +30,97 @@ the part of the tutorial that explains how to use XCode.

-

Begin by launching InterfaceBuilder, which you will find in the - "/Developer/Applications/" folder. Create a new nibfile by using - InterfaceBuilder's "Starting Point" dialog. If the "Starting Point" - dialog doesn't appear when you launch InterfaceBuilder, you can - display it by choosing "New" from the File menu. Choose "Cocoa - Application", and click the "New" button to create the - nibfile.

+

We'll begin by using Apple's InterfaceBuilder application to + create a nibfile. The nibfile contains + archived versions of the Objective C objects that define the + application's user interface. When you launch an application, + Mac OS X uses the archived objects in the nibfile to create the + windows and menus you see on the screen.

-
- -
+

Start by locating Apple's InterfaceBuilder application. If + you installed Apple's Developer Tools, InterfaceBuilder should + be in the folder "/Developer/Applications/":

+ +
+ +
+ + +

NOTE: If you have not installed Apple's Developer Tools, you should + do that now. You will not be able to build the CurrencyConverter + example without them. The Developer Tools are distributed as an + optional install with Mac OS X 10.5 ("Leopard"). Look for the + "XCode Tools" package in the "Optional Installs" folder on the + Mac OS 10.5 install disk.

+ +

Once you have located InterfaceBuilder, double-click to launch + the application. InterfaceBuilder presents a window you can use + to choose a template for the nibfile you are going to create.

+ +
+ +
+ +

Click the "Application" icon and then click the "Choose" button to + create an application nibfile. InterfaceBuilder creates a new + application nibfile, but doesn't immediately save it. The + Objective C objects that represent the new application's + interface appear in a new untitled window:

+ +
+ +
+ +

The intial window and menubar also appear on the screen. The + new application's name appears in the menus as + "NewApplication". Save the new nibfile into the + "currency-converter" folder that you created earlier (on this + page). Give it the name "CurrencyConverter.nib".

+ +
+

NOTE: Most Objective C application projects use a main + nibfile called "MainMenu.nib", and if you use XCode to create + a new application project, it creates a nibfile with that + name. Apple's CurrencyConverter tutorial assumes that the + name of the main nibfile is "MainMenu.nib".

+ +

So, why do we tell you to use a different name? Clozure CL + has a main nibfile built into, whose name is + "MainMenu.nib". Normally you don't see it, and don't even + need to know that it exists. But the Clozure CL + application-building tools create a new application by + copying resources from the Clozure CL application, so that + your new application has available to it all the built-in + Clozure CL tools. In order to avoid any confusion between + your application's nibfile and the MainMenu.nib built into + Clozure CL, we ask you to name your nibfile + "CurrencyConverter.nib".

+ +

Just try to keep in mind that whenever Apple's tutorial + refers to the "MainMenu.nib" file, it means the file we have + named "CurrencyConverter.nib".

+
-

Save the nibfile in your "currency-converter" folder. Name it - "CurrencyConverter.nib". Apple's tutorial names it "MainMenu.nib", - but we won't use that name. When building an application with - OpenMCL, we gradually change the behavior of the OpenMCL application - until it behaves the way we want for our application. OpenMCL's IDE - already has a nibfile built into it with the name "MainMenu.nib", - and if we wanted to use that name for the CurrencyConverter - application, we would have to replace OpenMCL's "MainMenu.nib". It's - generally a good idea to avoid destroying or replacing things unless - you really have to, so, in order to preserve the OpenMCL nibfile, - give yours the name "CurrencyConverter.nib".

- -

Now you can use this nibfile to create your application's user - interface. When Apple's tutorial tells you to find and open the main - nibfile created by XCode, use your "CurrencyConverter.nib" - instead.

-

Skip straight to the part of Apple's tutorial -called Creating -the Currency Converter Interface. Read the introduction to +called Defining + the View: Building the User Interface. Read + the introduction to nibfiles, and follow the instructions to create the Currency Converter interface. (Remember that when the tutorial tells you to open and edit "MainMenu.nib", you will instead open and edit your "CurrencyConverter.nib".) When you reach the end of the section -called Defining -the Converter Class, you are done creating the interface for your +called Test + the Interface, and move on to the short section afterward + called What's Next, + you are done creating the interface for your application. Save your nibfile and continue with the next section of this HOWTO, on writing the Lisp code that provides the application's behavior.

-

-
-

start|previous|next

+

start|previous|next

Index: /trunk/ccl/examples/cocoa/currency-converter/HOWTO_files/pages/create_lisp.html =================================================================== --- /trunk/ccl/examples/cocoa/currency-converter/HOWTO_files/pages/create_lisp.html (revision 7708) +++ /trunk/ccl/examples/cocoa/currency-converter/HOWTO_files/pages/create_lisp.html (revision 7709) @@ -20,18 +20,11 @@ application to create and manage projects, to edit Objective C source files, and to build the final application. In this HOWTO, - Clozure's OpenMCL application takes the place of XCode. The - Lisp project structure is much simpler than the XCode project + the Clozure CL application takes the place of XCode. The Lisp + project structure is much simpler than the XCode project structure: to build the Lisp application we need only the nibfile created in the previous section, and a single Lisp source file.

-

Before you continue, make sure you have followed the - instructions - in this - sidebar on building the OpenMCL IDE. We'll use the IDE to - create and load Lisp files.

- -

Once you have a working IDE, launch it by double-clicking - the OpenMCL application. OpenMCL displays a Listener window:

+

Double-click Clozure CL to launch it. Clozure CL displays a Listener window:

@@ -51,5 +44,5 @@
-

start|next

+

start|previous|next

Index: /trunk/ccl/examples/cocoa/currency-converter/HOWTO_files/pages/making_project.html =================================================================== --- /trunk/ccl/examples/cocoa/currency-converter/HOWTO_files/pages/making_project.html (revision 7708) +++ /trunk/ccl/examples/cocoa/currency-converter/HOWTO_files/pages/making_project.html (revision 7709) @@ -41,5 +41,5 @@ application, though not all applications are as simple as this currency converter. For more complex applications it makes sense - to split you UI into several nibfiles, and to split your + to split your UI into several nibfiles, and to split your implementation into several source files. The basic principle remains the same, however: nibfiles define your user interface, Index: /trunk/ccl/examples/cocoa/currency-converter/HOWTO_files/pages/writing_lisp.html =================================================================== --- /trunk/ccl/examples/cocoa/currency-converter/HOWTO_files/pages/writing_lisp.html (revision 7708) +++ /trunk/ccl/examples/cocoa/currency-converter/HOWTO_files/pages/writing_lisp.html (revision 7709) @@ -18,6 +18,6 @@ Apple's example, the explanation of the Objective C code begins with the - section Implementing - Currency Converter.

+ section Bridging + the Model and View: The Controller.

The Lisp code in this section of the HOWTO is considerably @@ -208,5 +208,5 @@

-

start|next

+

start|previous|next

Index: /trunk/ccl/examples/cocoa/currency-converter/HOWTO_files/stylesheets/styles.css =================================================================== --- /trunk/ccl/examples/cocoa/currency-converter/HOWTO_files/stylesheets/styles.css (revision 7708) +++ /trunk/ccl/examples/cocoa/currency-converter/HOWTO_files/stylesheets/styles.css (revision 7709) @@ -33,4 +33,11 @@ } +.note { + font: 12pt Georgia, "Times New Roman", Times, serif; + margin-left: 6em; + margin-right: 6em; + text-indent: 0em; +} + .inline-image { text-align: center;