X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ffecfa5aeb540b54914739dbb8603edbbd4c00a0..f84a986cfc6e512240b77fcdfbacc769b8a0cd02:/docs/palmos/readme.txt

diff --git a/docs/palmos/readme.txt b/docs/palmos/readme.txt
index 79a11db72f..faf280fc3f 100644
--- a/docs/palmos/readme.txt
+++ b/docs/palmos/readme.txt
@@ -1,3 +1,64 @@
+                              wxPalm README
+                              =============
+
+NB: wxPalm is currently in pre-alpha stage -- but it's already fun!
+
+I. Building wxPalm under Windows
+--------------------------------
+
+First, you need the freely distributable Palm OS Developer Studio available at
+
+                http://www.palmos.com/dev/tools/dev_suite.html
+
+Beware, its installation takes about 500Mb (+ 150 Mb of cygwin if not installed
+yet), so make sure you have enough disk space for it and for wxWidgets build
+tree (another 50Mb). Last tested set: PODS 1.2, SDK 6.1, wxWidgets 2.7.0.
+
+The Developer Studio is Eclipse-based and so is a GUI environment, however it
+is also possible to build Palm applications from the command line using the
+usual GNU tools. Both methods are covered below, choose one which you prefer.
+
+a) Using command line tools:
+    - If you have installed Developer Studio in a non default location (e.g.
+      d:\PalmOS), you will need to set the environment variables:
+
+                set TOOLS_DIR=D:/PalmOS/PalmOSTools/
+                set SDK_LOCATION=D:/PalmOS/sdk-6/
+
+      Don't use backslashes and don't forget the trailing slash. On the bright
+      side, spaces don't need to be escaped in any way.
+
+    - create a lib/gcc_lib/palmos/wx directory
+    - copy include/wx/palmos/setup0.h to lib/gcc_lib/palmos/wx/setup.h
+        TODO: modify Makefile to do it automatically
+
+    - ensure that the directories d:\PalmOS\PalmOSTools and the one containing
+      GNU tools (i.e. cygwin bin directory) are in your PATH
+
+    - go to build/palmos and run make
+
+    - you should end up with DebugSim/wxWidgets.prc: this is the Palm database
+      which you can load into the emulator
+
+    - to test it, run the emulator (you need PalmOS 6 one!) after seting
+      another env var:
+
+                set PALMSOURCE_SIM_PATH=wxWindows\build\palmos\DebugSim
+
+      wait until the emulator finishes to boot, right click it and choose
+      "Install" in the menu, select wxWindows.prc in the file open dialog.
+      You should see "Minimal App" with a familiar icon appear in the list,
+      click it and it should start.
+
+
+b) Using IDE:
+    TODO: write this after checking that the instructions below work
+
+
+
+
+Original note from William Osborne follow:
+
 wxWidgets 2.5.3 CVS 10-18-2004
 ------------------------------
 
@@ -63,4 +124,4 @@ the wxWidgets developer list or directly to me at wbo@freeshell.org
 
 Enjoy!
 William Osborne
-wbo@freeshell.org
\ No newline at end of file
+wbo@freeshell.org