source: trunk/ccl/examples/cocoa/currency-converter/HOWTO.html @ 7709

Last change on this file since 7709 was 7709, checked in by mikel, 13 years ago

added several images for the HOWTO

File size: 5.0 KB
Line 
1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2          "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml">
4  <head>
5    <title>CurrencyConverter HOWTO</title>
6    <link rel="stylesheet" type="text/css" href="HOWTO_files/stylesheets/styles.css" />
7  </head>
8
9  <body>
10
11    <div class="title">
12      <h1>CurrencyConverter HOWTO</h1>
13    </div>
14
15    <div class="subtitle">
16      <h2>Creating Apple's <a
17      href="http://developer.apple.com/documentation/Cocoa/Conceptual/ObjCTutorial/index.html">
18            Currency Converter</a> example<br/>
19          with OpenMCL
20      </h2></div>
21
22    <div class="subtitle">
23      <img src="HOWTO_files/images/bosco.jpg"
24           width="48" height="48" border="0" alt="" 
25           border='0'/>
26    </div>
27
28    <div class="byline">
29      <p>by mikel evins</p>
30    </div>
31
32    <div class="body-text">
33      <p>This HOWTO guide explains how to use OpenMCL to create a
34      Cocoa application that is functionally identical to Apple's
35      <a
36      href="http://developer.apple.com/documentation/Cocoa/Conceptual/ObjCTutorial/index.html">
37        Currency Converter</a> example. The most important
38        difference between Apple's example and this one is that this
39        one is implemented in Common Lisp instead of Objective C. It
40        uses OpenMCL's Objective-C bridge to provide communication
41        between the Lisp code that you write and Apple's Cocoa
42        frameworks. The resulting application looks and acts just
43        like any other Cocoa application.</p>
44
45      <p>This HOWTO doesn't discuss all the background information
46      that Apple's tutorial covers. Instead, we assume that you have
47      Apple's document handy for reference, and we just describe the
48      specific steps needed to build the example using
49      Apple's InterfaceBuilder application and OpenMCL.</p>
50
51      <p>The current version of the OpenMCL Objective-C bridge
52      includes code that was formerly distributed separately as the
53      "Bosco" application framework. Because that framework has been
54      integrated with OpenMCL proper, it no longer exists as a
55      separate project. "Bosco" now names only the decorative rodent
56      at the top of this page.</p>
57    </div>
58
59    <div class="section-head">
60      <h2>Apple's Currency Converter Example</h2>
61    </div>
62
63    <div class="body-text">
64      <p>It will be helpful in understanding this example if you can
65      easily refer to Apple's <a
66      href="http://developer.apple.com/documentation/Cocoa/Conceptual/ObjCTutorial/index.html">
67        Currency Converter</a> example while working through this
68      HOWTO. You might consider opening a separate window or tab, and
69      keeping the Apple example handy while you work.</p>
70
71      <p>In some ways, the Lisp version of the example is simpler
72      than the Objective C example, but the basic concepts are the
73      same. In particular, the Lisp example follows the same
74      <a
75      href="http://developer.apple.com/documentation/Cocoa/Conceptual/ObjCTutorial/02Essence/chapter_2_section_4.html#//apple_ref/doc/uid/TP40000863-CH3-DontLinkElementID_6">
76        Model-View-Controller</a> paradigm that the Apple example
77        uses. If you are new to Cocoa programming, or if you are not
78        familiar with how it uses the Model-View-Controller paradigm,
79        it's probably a good idea to read through the Apple example
80        in full, paying special attention to the
81        Model-View-Controller section. Once you've done that, keep
82        the Apple pages handy in a window for easy reference.</p>
83
84      <p>This Common Lisp version of the Currency Converter example
85      uses Apple's InterfaceBuilder application to build a window and
86      main menu, and then uses Common Lisp code to load and operate
87      that user interface. The Common Lisp code relies on OpenMCL's
88      Objective-C bridge to provide communication between the running
89      Lisp code and Apple's Cocoa frameworks. Once the code is
90      complete, we use the BUILD-APPLICATION function to save a
91      working Cocoa application bundle. That bundle looks and acts
92      just like any other Cocoa application.</p>
93
94    </div>
95
96    <div class="section-head">
97      <h2>Requirements Before You Start</h2>
98    </div>
99
100    <div class="body-text">
101      <p>In order to build this example you will need:</p>
102
103      <ul>
104        <li><p>Mac OS X Tiger (version 10.4.x) or Mac OS X Leopard
105        (version 10.5.x)</p></li>
106        <li><p>Apple's XCode development tools</p></li>
107        <li><p>Apple's InterfaceBuilder application (included with XCode)</p></li>
108        <li><p>A recent version of OpenMCL</p></li>
109        <li><p>Clozure CL.app</p></li>
110        <li><p>The Apple <a
111      href="http://developer.apple.com/documentation/Cocoa/Conceptual/ObjCTutorial/index.html">
112        Currency Converter</a> example, for reference</p></li>
113      </ul>
114    </div>
115
116    <div class="nav">
117      <p><a href="HOWTO_files/pages/making_project.html">next</a></p>
118    </div>
119
120  </body>
121</html>
122
Note: See TracBrowser for help on using the repository browser.