[Mysql-cocoa-commits] CVS: Documentation/website archives.html,NONE,1.1 index.html,1.14,1.15
Brought to you by:
sergecohen
Menu
▾
▴
[Mysql-cocoa-commits] CVS: Documentation/website archives.html,NONE,1.1 index.html,1.14,1.15
|
From: Serge C. <ser...@us...> - 2003-08-25 22:10:26
|
Update of /cvsroot/mysql-cocoa/Documentation/website In directory sc8-pr-cvs1:/tmp/cvs-serv13928/website Modified Files: index.html Added Files: archives.html Log Message: Moved all the OLD updates to a new web page : archives.html. Modified the Files and Documentation sections of the main page (inedx.html) 2003-08-25; Serge Cohen. --- NEW FILE: archives.html --- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <HTML> <HEAD> <LINK REL=stylesheet TYPE="text/css" HREF="styles.css"> <TITLE>MySQL Cocoa Project : Updates Archives</TITLE> <META name="author" content="Serge Cohen"> <META name="copyright" content="2002, Serge Cohen"> <META name="keywords" content="free software, gnu, GNU, database, mysql, MySQL, Objective-C, objective-c, mac, macintosh, mac os x, Mac OS X, API, DB API, Cocoa, cocoa, MacOS X, MacOSX"> <META name="description" content="A project to implement an Objective-C API for MySQL to MacOS X Cocoa environment"> </HEAD> <BODY bgcolor="#ffffff" text="#000000" link="#0000ff" vlink="#00a800" alink="#ff1100"> <!--content start--> <h1>MySQL Cocoa project : Updates Archives</h1> <a name="home"><p>Home page of the MySQL Cocoa project can be found <a href="index.html">here</a></p></a> <p class="withlist"><em>24 December 2002:</em> Posted the file releases for the version 2.0 of the framework. This correspond to both a source and a binary release. This version of the framework has a new API:</p> <ul class="intext"> <li class="intext">The class prefix is changed to be MCP (for MySQL Cocoa Project), from the "longer" SMySQL (though the framework has not changed name, neither the main header SMySQl/SMySQL.h)</li> <li class="intext">I have added some categories on MCPConnection and MCPResult to implement shortcuts to obtains fast some result (for exemple a column of a table, or just the first element --Row 0, Colulmn 0--...)</li> <li class="intext">Also added a category on NSObject to provide a single method to check if an object is a instance of NSNull (used whenever a field is set to NULL in a retrieved table).</li> </ul> <p class="afterwithlist">I also have discontinued the distribution of <a href="Display">MySQL Display</a> application, mainly because their is a much better developed free software doing the same thing AND using the SMySQL framework <a href="http://cocoamysql.sourceforge.net/">CocoaMySQL</a>. At some point I'll try to implement a simple example application with a GUI, for easing the use of the framework.</p> <p><em>15 May 2002:</em> Important changes to the framework: The two connect (<code>connectToHost:.. connectToSocket:..</code>) method have been replaced by a single method (<code>connectWithLogin:password:host:port:socket:</code>). In the mean time the syntax of the list methods (<code>listDBs ...</code>) have been changed to look more like the SQL <code>SHOW</code> statments. Some shortcuts to such methods have been added. Any one using the framework should port to the new version, the interface will be kept until version 1.0 (with maybe adding method, but no removing nor renaming). This version is available on CVS and <a href="#sources">File Release</a>. At last a new binary of <a href="Display">MySQL Display</a> contain the last version of the framework.</p> <p><em>7 May 2002:</em> Cleaned up the methods from May 3rd, (databases, tables, fields list). Finished the proper encoding of the character sets (should run Ok with latin1, latin2, win1250, cp1251, euc_kr, sjis). Added methods to check the version of the protocole, the client library, the server, and to get info on the database server the host. The framework has been promoted to version 0.6.0. It's under CVS, but also on the <a href="#sources">File Release</a>.</p> <p><em>3 May 2002:</em> After suggestion from Bertrand Mansion I added a couple of method to get databases, tables, and fields (of a table) list. They works they way they should from the C API recommandation (specific function for DBs, and tables, standard query for fields). I also started to enhance the handling of the charset encoding (suggestion by John Guy). This feature is not yet fully implemented. The new version (0.5.4) is only available through CVS so far (see information from the <a href="http://sourceforge.net/cvs/?group_id=42424">sourceforge project page</a>).</p> <p><em>14 March 2002:</em> A new target for SMySQL framework exists. It gives you access to a all in one version of the framework: libmysqlclient is statically linked inside the framework... No more need for a root user to install the mysqlclient library. The version of libmysqlclient is 3.23.49 (the lataest stable version). As a test I have linked <a href="Display/index.html">MySQL Display</a> to this version of the framework, and it works perfectly (<a href="http://ftp1.sourceforge.net/mysql-cocoa/MySQL_Display_0.1.2.dmg.gz">Download</a>).</p> <p><em>13 March 2002:</em> There was a error in the <a href="Doc/HowTo_Build_MySQL.rtf">How To Build MySQL file</a>. This error is corrected (I forgot one command line to copy the /usr/share/libtool/ltconfig to ltconfig in th esource directory, before applying the patch). Now the instruction should run Ok. Some improovement can still be done in the patch: adding a proper prebinding adress, proper version... Still to be done. -Thanks to Camille for pointing the problem to me-</p> <p><em>28 February 2002:</em> The framework is now ready to be embeded in the application(s) using it,I still have a problem for statically linking the libmysqlclient, so use of SMySQL framework still needs the installation of libmysqlclient.dylib (which is done by MySQL_Cocoa_installers_0.5.2.dmg.gz). Now the <a href="Display/index.html">MySQL Display</a> should run.</p> <p><em>22 January 2002:</em> Few correction to the framework (v 0.5.1 now). I finally managed to create packages, so <em>the AutoStart package finally works</em>. There is also a new package installer : <em>Install MySQL Client</em>. This will install the client side of MySQL, the minimum required to run a C (or Objective-C !!!) client on your Mac OS X system. At last (but not least), I have written a new application using the framework to display queries in a GUI <a href="Display/index.html"><em>MySQL Display</em></a>. Even if it is still very basic this is (as far as I know) the first <em>free</em> GUI for MySQL on Mac OS X. I'm sure you'll want some modification for this GUI, send your whishes on the users mailing list. <p><em>3 January 2002:</em> First release is done, still have to put this web site in place. This is an alpha release, I've not been throught extensiv testing of the API. It works Ok for the couple of test application I've done. Indeed I'm looking forward for feed back from users. <em>For the moment the AutoStart package, which starts automatically MySQL at machine booting is not ready</em> due to some problems I have with package maker...</p> <!--content end--> <a name="team"><h2>Development Team</h2></a> <ul> <li>Serge Cohen (<a href="mailto:ser...@us...">ser...@us...</a>)</li> <li>Bertrand Mansion (<a href="mailto:ma...@us...">ma...@us...</a>)</li> </ul> <a name="links"><h2>Links</h2></a> <p>Here are some important links. Click away.</p> <div class="content"> <table> <tr><td colspan=2 class="head"> <p class="tablesechead">Database</p> </td></tr> <tr><td> <p class="link"><a href="http://www.mysql.com/">MySQL</a></p> </td> <td> <p class="linkinfo">Home of MySQL database server.</p> </td></tr> <tr><td colspan=2 class="head"> <p class="tablesechead">Cocoa API and Objective-C</p> </td></tr> <tr><td> <p class="link"><a href="http://developer.apple.com/techpubs/macosx/Cocoa/ObjectiveC/index.html">Objective-C home</a></p> </td> <td> <p class="linkinfo">Objective-C home at Apple</p> </td></tr> <tr><td> <p class="link"><a href="http://developer.apple.com/techpubs/macosx/Cocoa/SiteInfo/NewToCocoa.html">Introducing Cocoa</a></p> </td> <td> <p class="linkinfo">Introduction to the Cocoa API (Apple)</p> </td></tr> <tr><td> <p class="link"><a href="http://developer.apple.com/cocoa/index.html">Cocoa API home</a></p> </td> <td> <p class="linkinfo">API documentation home at Apple</p> </td></tr> <tr><td colspan=2 class="head"> <p class="tablesechead">Project related</p> </td></tr> <tr><td> <p class="link"><a href="index.html">Home Page</a></p> </td> <td> <p class="linkinfo">Latest updates and general infos on the project</p> </td></tr> <tr><td> <p class="link"><a href="http://www.sourceforge.net/projects/mysql-cocoa">Project page on SourceForge</a></p> </td> <td> <p class="linkinfo">Where to go to see the development.</p> </td></tr> <tr><td> <p class="link"><a href="http://cocoamysql.sourceforge.net/">CocoaMySQL</a></p> </td> <td> <p class="linkinfo">A very nice Generic GUI MySQL client (in Cocoa)... and it's free software!!</p> </td> </tr> </table> </div> <div class="center"><A href="http://sourceforge.net"> <IMG src="http://sourceforge.net/sflogo.php?group_id=42424&type=1" width="88" height="31" border="0" alt="SourceForge Logo"></A></div> </BODY> Index: index.html =================================================================== RCS file: /cvsroot/mysql-cocoa/Documentation/website/index.html,v retrieving revision 1.14 retrieving revision 1.15 diff -C2 -d -r1.14 -r1.15 *** index.html 19 Aug 2003 10:04:41 -0000 1.14 --- index.html 25 Aug 2003 21:53:21 -0000 1.15 *************** *** 23,29 **** --- 23,36 ---- <p><em>Documentation of the latest verison of the framework can be found <a href="SMySQL_doc/">here</a></em></p> + <!--Updates--> <a name="updates"><h2>Updates</h2></a> + <a name="archive"><p>Archives of the updates can be found <a href="archives.html">here</a></p></a> + + <p><em>25 August 2003:</em> Today I finally had the time to update the web site. The information you find here should now be up to date (especially the <a href="#files">Files</a>, <a href="#">Documentation</a> were completely outdated – I had no time to update them since I first wrote them in January 2002 –).</p> + + <p><em>20 August 2003:</em> Releases the version 2.2.1 of the framework: minor bug correction. The previous versions of the framework were not able to handle properly the integer with more than 32bits (MySQL BIGINT). This is now corrected (indeed the other branches of the framework are also corrected in CVS, so if you are still using the version 1, I encourage you to get the fix from CVS). Unfortunately I have not found a solution to know from the MySQL server if an retrieve integer is signed or not, hence the framework assumes always signed int: this can cause a trouble if you have a unsigned column (either for BIGINT or INT) and you are using number bigger than the maximum SIGNED number. Thanks to Lorenz Textor for pointing the bug to me.</p> + <p class="withlist"><em>18 August 2003:</em> Released the version 2.2.0 of the framework. The API is kept unchanged, the main difference is in the project organisation (in Project Builder). I also have tried to make the aim of each target more clear, and cleaned up the build-styles, in that respect I have defined 3 different names for each of the flavours (corresponding to 3 different targets) of the framework (which BTW have also changed):</p> <ol class="intext"> *************** *** 33,51 **** </ol> <p class="afterwithlist">Also modified the way the libmysqlclient static library is used, now a binary version of the library is distributed with the sources of the framework (the sources of the libmysqlclient used to be included in the project and compiled when building the framework). This way makes it easier if someone prefers to use it's own version of the libmysqlcleint library.</p> - <p class="withlist"><em>24 December 2002:</em> Posted the file releases for the version 2.0 of the framework. This correspond to both a source and a binary release. This version of the framework has a new API:</p> - <ul class="intext"> - <li class="intext">The class prefix is changed to be MCP (for MySQL Cocoa Project), from the "longer" SMySQL (though the framework has not changed name, neither the main header SMySQl/SMySQL.h)</li> - <li class="intext">I have added some categories on MCPConnection and MCPResult to implement shortcuts to obtains fast some result (for exemple a column of a table, or just the first element --Row 0, Colulmn 0--...)</li> - <li class="intext">Also added a category on NSObject to provide a single method to check if an object is a instance of NSNull (used whenever a field is set to NULL in a retrieved table).</li> - </ul> - <p class="afterwithlist">I also have discontinued the distribution of <a href="Display">MySQL Display</a> application, mainly because their is a much better developed free software doing the same thing AND using the SMySQL framework <a href="http://cocoamysql.sourceforge.net/">CocoaMySQL</a>. At some point I'll try to implement a simple example application with a GUI, for easing the use of the framework.</p> - <p><em>15 May 2002:</em> Important changes to the framework: The two connect (<code>connectToHost:.. connectToSocket:..</code>) method have been replaced by a single method (<code>connectWithLogin:password:host:port:socket:</code>). In the mean time the syntax of the list methods (<code>listDBs ...</code>) have been changed to look more like the SQL <code>SHOW</code> statments. Some shortcuts to such methods have been added. Any one using the framework should port to the new version, the interface will be kept until version 1.0 (with maybe adding method, but no removing nor renaming). This version is available on CVS and <a href="#sources">File Release</a>. At last a new binary of <a href="Display">MySQL Display</a> contain the last version of the framework.</p> - <p><em>7 May 2002:</em> Cleaned up the methods from May 3rd, (databases, tables, fields list). Finished the proper encoding of the character sets (should run Ok with latin1, latin2, win1250, cp1251, euc_kr, sjis). Added methods to check the version of the protocole, the client library, the server, and to get info on the database server the host. The framework has been promoted to version 0.6.0. It's under CVS, but also on the <a href="#sources">File Release</a>.</p> - <p><em>3 May 2002:</em> After suggestion from Bertrand Mansion I added a couple of method to get databases, tables, and fields (of a table) list. They works they way they should from the C API recommandation (specific function for DBs, and tables, standard query for fields). I also started to enhance the handling of the charset encoding (suggestion by John Guy). This feature is not yet fully implemented. The new version (0.5.4) is only available through CVS so far (see information from the <a href="http://sourceforge.net/cvs/?group_id=42424">sourceforge project page</a>).</p> - <p><em>14 March 2002:</em> A new target for SMySQL framework exists. It gives you access to a all in one version of the framework: libmysqlclient is statically linked inside the framework... No more need for a root user to install the mysqlclient library. The version of libmysqlclient is 3.23.49 (the lataest stable version). As a test I have linked <a href="Display/index.html">MySQL Display</a> to this version of the framework, and it works perfectly (<a href="http://ftp1.sourceforge.net/mysql-cocoa/MySQL_Display_0.1.2.dmg.gz">Download</a>).</p> - <p><em>13 March 2002:</em> There was a error in the <a href="Doc/HowTo_Build_MySQL.rtf">How To Build MySQL file</a>. This error is corrected (I forgot one command line to copy the /usr/share/libtool/ltconfig to ltconfig in th esource directory, before applying the patch). Now the instruction should run Ok. Some improovement can still be done in the patch: adding a proper prebinding adress, proper version... Still to be done. -Thanks to Camille for pointing the problem to me-</p> - <p><em>28 February 2002:</em> The framework is now ready to be embeded in the application(s) using it,I still have a problem for statically linking the libmysqlclient, so use of SMySQL framework still needs the installation of libmysqlclient.dylib (which is done by MySQL_Cocoa_installers_0.5.2.dmg.gz). Now the <a href="Display/index.html">MySQL Display</a> should run.</p> - <p><em>22 January 2002:</em> Few correction to the framework (v 0.5.1 now). I finally managed to create packages, so <em>the AutoStart package finally works</em>. There is also a new package installer : <em>Install MySQL Client</em>. This will install the client side of MySQL, the minimum required to run a C (or Objective-C !!!) client on your Mac OS X system. At last (but not least), I have written a new application using the framework to display queries in a GUI <a href="Display/index.html"><em>MySQL Display</em></a>. Even if it is still very basic this is (as far as I know) the first <em>free</em> GUI for MySQL on Mac OS X. I'm sure you'll want some modification for this GUI, send your whishes on the users mailing list. - <p><em>3 January 2002:</em> First release is done, still have to put this web site in place. This is an alpha release, I've not been throught extensiv testing of the API. It works Ok for the couple of test application I've done. Indeed I'm looking forward for feed back from users. <em>For the moment the AutoStart package, which starts automatically MySQL at machine booting is not ready</em> due to some problems I have with package maker...</p> <!--/Updates--> --- 40,43 ---- *************** *** 59,100 **** <a name="files"><h2>Files</h2></a> ! <p>The easiest way to get these things to run now is to get the Install MySQLClient package, which is in a gziped image disk (along with the AutoStart package and the <a href="Display/index.html">MySQL Display application</a>).<em> Next paragraphs explain the "old" way</em>.<br> <em>Remark:</em> the library in this package is given a pre-binding adress, which is not the case of the result you'll have if you compile your own</p> - <p>First you have to install mysql in a way you can link the mysqlclient library with your code. You'll find mysql source at the <a href="http://www.mysql.com/">MySQL</a> homepage, and instruction for compilation <a href="Doc/HowTo_Build_MySQL.rtf">here</a>, or on the Documentation package on the SourceForge page.</p> - <p>Then you have to get the SMySQL package, and compile it, then if every thing get Ok, go in terminal and read <a href="Doc/TO_INSTALL.txt">TO_INSTALL</a> which explain how to make the "final" install. This should as well install the documentation of the framework.</p> - <p>At last you can use the SMySQL_test package to test your install. You will have to make a new user, database and table in your MySQL server for the test application to work. Another way is to modify the connection parameters at the beginning of the program</p> <ul> <li>Binaries to install fast..</li> <ul> ! <li>Getting the MySQL Display application (alone and independent of any library): <a href="http://ftp1.sourceforge.net/mysql-cocoa/MySQL_Display_0.1.2.dmg.gz">Disk image</a>, MD5 : 5a082b108a8eba108b27d22bdc0a3b42</li> ! <li>Installing the Client side of MySQL, and getting the <a href="Display/index.html">MySQL Display application</a> (as a free bonus): <a href="http://ftp1.sourceforge.net/mysql-cocoa/MySQL_Cocoa_installers_0.5.2.dmg.gz">Disk image</a>, MD5: fc88e839717d3a478fa44c56387da908</li> ! </ul> ! <li><a name="sources">Mac OS X 10.1 or higher sources, version 0.5.3 r1 </a><! (note: not up to date, see CVS for version 0.5.2) !></li> ! <ul> ! <li><a href="http://ftp1.sourceforge.net/mysql-cocoa/SMySQL_0.7.0.tgz">SMySQL Framework v0.7.0r1</a>, MD5: a9480df166aae28fff56b79e205f4353</li> ! <li><a href="http://ftp1.sourceforge.net/mysql-cocoa/SMySQL_0.6.0.tgz">SMySQL Framework v0.6.0r1</a>, MD5: 685b6b4361936c4d9109d390686c6cdc</li> ! <li><a href="http://ftp1.sourceforge.net/mysql-cocoa/SMySQL_0.5.3.tgz">SMySQL Framework v0.5.3r1</a>, MD5: 536de45748d9db6218e7e4d3eecaea06</li> ! <li><a href="http://ftp1.sourceforge.net/mysql-cocoa/SMySQL_0.5.1.tgz">SMySQL Framework v0.5.1r1</a>, MD5: a0ecaf53275cc068002b8e45cb0b6695</li> ! <li><a href="http://ftp1.sourceforge.net/mysql-cocoa/SMySQL_0.5.tgz">SMySQL Framework v0.5.0r1</a>, MD5: 3608e6e298cb45836f793081e6f809ab</li> ! </ul> ! <ul> ! <li><a href="http://ftp1.sourceforge.net/mysql-cocoa/MySQL_Display_0.1.3.tgz">MySQL Display v0.1.3r1</a>, MD5: ec06db8c27ff8e53e4c1527024b829e8</li> ! <li><a href="http://ftp1.sourceforge.net/mysql-cocoa/MySQL_Display_0.1.2.tgz">MySQL Display v0.1.2r1</a>, MD5: 42bc3b8210541b166bac51a4d8a08aa7</li> ! <li><a href="http://ftp1.sourceforge.net/mysql-cocoa/MySQL_Display_0.1.1.tgz">MySQL Display v0.1.1r1</a>, MD5: 159f7032d426d5bc5eb9397402925482</li> </ul> <ul> ! <li><a href="http://ftp1.sourceforge.net/mysql-cocoa/SMySQL_test_0.7.0.tgz">SMySQL test application v0.7.0r1</a>, MD5: f10028eaa52a17425104274080eca413</li> ! <li><a href="http://ftp1.sourceforge.net/mysql-cocoa/SMySQL_test_0.6.0.tgz">SMySQL test application v0.6.0r1</a>, MD5: be4b368887698c2fd461d6df89423094</li> ! <li><a href="http://ftp1.sourceforge.net/mysql-cocoa/SMySQL_test_0.5.tgz">SMySQL test application v0.5.0r1</a>, MD5: 303fc130b0b6211283c2f3252c8dfd08</li> </ul> <ul> ! <li><a href="http://ftp1.sourceforge.net/mysql-cocoa/Documentation_0.5.3.tgz">Documentation and patches v0.5.3r1</a>, MD5: 420486b817e964550abf814f0b69a4ce</li> ! <li><a href="http://ftp1.sourceforge.net/mysql-cocoa/Documentation_0.5.tgz">Documentation and patches v0.5.0r1</a></li> </ul> - - <li>Patches</li> <ul> ! <li><a href="patches/ltconfig_1.2S.diff">lt_config_1.2S patche for ltconfig of /usr/share/libtool</a>, MD5: 959b0a944c809413f6c7e190c1f470af</li> </ul> --- 51,77 ---- <a name="files"><h2>Files</h2></a> ! <p>These files provides only the client side of <a href="http://www.mysql.com/">MySQL</a> (and only for Cocoa). If you want to install the server (as well as if you want the sources of the client library), the best thing is to go to the <a href="http://www.mysql.com/">MySQL site</a>. On this respect one has to know that nowadays MySQL install out of the box (binaries as well as from sources – if you have the developer tools –) on Mac OS X.</p> ! ! <!-- <p>It is easy to find on the web the instruction how to get the MySQL server running automatically when you start your Mac, still for the lazy or the one in hurry, I've posted here a small packages which enables that.</p> ... Still have to prepare the package...--> <ul> <li>Binaries to install fast..</li> <ul> ! <li>Getting the binaries of the SMySQL frameworks (version 2.2.1) : <a href="http://prdownloads.sourceforge.net/mysql-cocoa/SMySQL_bin_2.2.1.dmg?download">SMySQL_bin_2.2.1.dmg</a>, MD5 : e8958cea685920fb8cd712f7d166483e</li> ! <li>Getting the MySQL Display application (alone and independent of any library): <a href="http://prdownloads.sourceforge.net/mysql-cocoa/MySQL_Display_0.1.3_F0.7.0.dmg.gz?download">Disk image</a>, MD5 : ea4afc9a6a798776fb2d012de2fbd979. ! <p><em>Note:</em> The MySQL Display application is not developped anymore, the source is still available as a small examples of hte concept (it uses the API of version 1, whilst naming conventions changed in version 2). The binary is available to see how it performs without having to take care of the "obsolete" version 1 of the framework.<!-- Add a link to display page, and rewrite it to redirect to Cocoa MySQL from Lorenz... --></p> ! </li> </ul> + <li><a name="sources">Mac OS X 10.1 or higher sources, version 2.2.1 </a><!!></li> <ul> ! <li><a href="http://prdownloads.sourceforge.net/mysql-cocoa/SMySQL_src_2.2.1.dmg?download">SMySQL Framework v2.2.1 (dmg)</a>, MD5: ea7ed457bc64386513035588496accab</li> ! <li><a href="http://prdownloads.sourceforge.net/mysql-cocoa/SMySQL_src_2.2.1.tgz?download">SMySQL Framework v2.2.1 (tgz)</a>, MD5: dd450188cb7988618560d590c4b0cf28</li> </ul> <ul> ! <li><a href="http://prdownloads.sourceforge.net/mysql-cocoa/MySQL_Display_0.1.3.tgz?download">MySQL Display v0.1.3</a>, MD5: ec06db8c27ff8e53e4c1527024b829e8</li> </ul> <ul> ! <li>SMySQL test application does not exists anymore, now a small application is coming with the frameworks (CLI_Test)</li> </ul> *************** *** 104,115 **** <a name="docs"><h2>Documentation</h2></a> ! <p>Some of the documentation available Online can be found <a href="http://sourceforge.net/docman/index.php?group_id=42424">here on Sourceforge</a> (indeed not yet); the rest is below. You should probably read at least the How-to build MySQL.</p> ! <ul> ! <li>HOWTO: Build MySQL on OS X</li> ! <ul> ! <li><a href="Doc/HowTo_Build_MySQL.rtf">version 0.5.3</a> rtf format, MD5: c1911d90d4d523addb87cb2809d81bf1</li> ! </ul> ! </ul> <a name="lists"><h2>Mailing Lists</h2></a> --- 81,105 ---- <a name="docs"><h2>Documentation</h2></a> ! <p>Some of the documentation available Online can be found <a href="http://sourceforge.net/docman/index.php?group_id=42424">here on Sourceforge</a> (indeed not yet); the rest is below.</p> ! <h4>Vanilla, Strawberry or Chocolate... Which flavour do you want:</h4> ! ! <p><em>This info is also available in the README coming with the frameworks</em> (both in source and binaries distributions).<br> ! If you are a bit used to MacOS X programming (or if you have read the <a href="http://developer.apple.com/documentation/MacOSX/Conceptual/SystemOverview/">System Overview</a> from Apple, and more precisely the section dealing with <a href="http://developer.apple.com/documentation/MacOSX/Conceptual/SystemOverview/Frameworks/index.html">frameworks</a>), you probably already know that there is two main ways to link a framework from the application you are developing:</p> ! ! <ol> ! <li><em>System-Wide</em> (or User-Wide) visibility : If the framework is placed in one of the Library/Frameworks subfolder of the system, then any application (including command line tools) can use the framework (only launch by the user if it is in ~/Library/Frameworks).</li> ! <li><em>Bundled</em> within an application if it is in the Contents/Frameworks/ subfolder of the application bundle of a Cocoa Application (documented <a href="http://developer.apple.com/documentation/DeveloperTools/ProjectBuilder/ProjectBuilder.help/Contents/Resources/English.lproj/Frameworks/index.html">here</a>). Then only this application can see the framework</li> ! </ol> ! ! <p>Both of these possibilities have their own advantages and disadvantages. To make it short, on one hand System-Wide frameworks are the only ones that can be used by command line tools (which does not have a bundle, but are rather simple 'UNIX' executables), if you have a suite of program using the framework you have only one copy on your disk and you are sure all these applications uses exactly the same version of the framework. On the other hand, if you include the framework in the bundle of your application, then it is no longer relying on another component (the user don't need to install one more thing to use your software: it can be used directly 'out of the .dmg').</p> ! ! <p>Because their is no 'one best choice' on this issue, I distribute the framework in two (indeed three) flavours:</p> ! <ol> ! <li><em>SMySQL</em> and <em>SMySQL_static</em>: System-Wide version of the framework, respectively using the dynamic or static mysql client library (Note that the dynamic version of the library is not distributed in the package, so if you want to use SMySQL you have to install your own version of libmysqlclient.dylib).</li> ! <li><em>SMySQL_bundled</em>: A version of the framework which is made to be bundled within a Cocoa Application (statically linked to the mysql client library, so that it is as much self contained as possible).</li> ! </ol> ! ! <p>All these 3 flavours of the frameworks are build from the same sources (indeed they are just three different targets from the same ProjectBuilder project), with different options. They are all three included in the binary release (version 2.2 and higher).</p> <a name="lists"><h2>Mailing Lists</h2></a> *************** *** 126,131 **** <ul> <li>Serge Cohen (<a href="mailto:ser...@us...">ser...@us...</a>)</li> - <li>Bertrand Mansion (<a href="mailto:ma...@us...">ma...@us...</a>)</li> </ul> <a name="links"><h2>Links</h2></a> --- 116,121 ---- <ul> <li>Serge Cohen (<a href="mailto:ser...@us...">ser...@us...</a>)</li> </ul> + <a name="links"><h2>Links</h2></a> |
