git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@29996 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
		
			
				
	
	
		
			66 lines
		
	
	
		
			3.5 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			66 lines
		
	
	
		
			3.5 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
| wxWidgets 2.5.3 CVS 10-18-2004
 | |
| ------------------------------
 | |
| 
 | |
| This is a Palm OS 6 port of the wxWidgets toolkit.  Included in the source 
 | |
| package is the complete source necessary to build the Palm OS port using the 
 | |
| Palm OS Developer Studio.  Also included is the diff showing the changes that 
 | |
| need to be incorporated into the wxWidgets 2.5.3 CVS source tree before the 
 | |
| Palm OS port can be integrated.
 | |
| 
 | |
| I am releasing this port to the wxWidgets team under the terms of the wxWindows 
 | |
| license.  A copy of the wxWindows license is included in the source package.
 | |
| 
 | |
| No third party libraries or code were used in making this port.  The port consists 
 | |
| entirely of code I personally wrote combined with code that was included in the 
 | |
| wxWidgets 2.5.3 CSV source tree.  Whenever possible, I have used the Palm OS 6 API, 
 | |
| in places where the API was not practical to use, I wrote my own functions.
 | |
| 
 | |
| I am submitting this source package as an entry in the wxWidgets Palm OS 6 port 
 | |
| challenge.  Details on this challenge are available at http://www.wxwindows.org/palmos.htm
 | |
| 
 | |
| Please note that this port is in a very early state.  Currently the port 
 | |
| provides limited functionality for the wxFrame, wxMenu, wxStatusBar, 
 | |
| wxTopLevelWindow, and wxWindow classes.  The other classes in the wxWidgets 
 | |
| toolkit still need to be ported.  In it's current state, the Palm OS 6 port 
 | |
| is capable of running the minimal wxWidgets sample
 | |
| 
 | |
| The easiest way to see the port in action is to build the source package with 
 | |
| the Palm OS Developer Studio available at http://www.palmos.com/dev/dl/dl_tools/dl_pods/  
 | |
| Here are the steps that you need to follow to build the package:
 | |
| 
 | |
| 1) Unpack the ZIP file into a directory located within the Palm OS Developer 
 | |
|    Studio workspace directory.  The path to the folder should look something 
 | |
|    like this: "C:\Program Files\PalmSource\Palm OS Developer Suite\workspace\wxWidgets"
 | |
| 
 | |
| 2) Open Palm OS Developer Studio and click on File->Import.
 | |
| 
 | |
| 3) Select "Existing Project into Workspace" as the import source and click Next.
 | |
| 
 | |
| 4) On the next screen click the Browse button next to Project contents and select
 | |
|    the folder you unpacked the source package into.  Click on Finish to continue.
 | |
| 
 | |
| 5) You should now see the project listed in the Project pane on the right side of the 
 | |
|    window.  Click on the name of the project.  Now click on the Project menu and select
 | |
|    "Rebuild Project"
 | |
| 
 | |
| 6) After the build is complete, click on the Run menu and select ""  The Palm OS 6 simulator
 | |
|    should start.  If this is the first time you have used the simulator, you will be prompted  
 | |
|    to choose a ROM file.  You can find the ROM files in a folder like "C:\Program 
 | |
|    Files\PalmSource\Palm OS Developer Suite\sdk-6\tools\Simulator\6.0.1\ROM"  It doesn't 
 | |
|    really matter whether you choose a Release or a Debug ROM (the debug ROM generates extra 
 | |
|    reports when an application crashes.)
 | |
| 
 | |
| 7) You should see the Palm logo appear in the simulator window.  You may get a dialog box 
 | |
|    asking you to choose a language.  Click OK to continue.  You should see the simulator 
 | |
|    initialize the built-in Palm applications.  After a few moments, the wxWidgets minimal 
 | |
|    sample should start.  Have fun!
 | |
| 
 | |
| Since this source package was based on the wxWidgets 2.5.3 CVS source tree dated October 18, 
 | |
| 2004 I don't anticipate any problems with merging the sources into the 2.5.3 source tree.
 | |
| 
 | |
| If you have any questions or comments about the port, please feel free to send an email to 
 | |
| the wxWidgets developer list or directly to me at wbo@freeshell.org
 | |
| 
 | |
| Enjoy!
 | |
| William Osborne
 | |
| wbo@freeshell.org |