undefine _DEFINE_LIST before redefining it; also rename it to have WX prefix

[wxWidgets.git] / docs / msw / wince / readme.txt

diff --git a/docs/msw/wince/readme.txt b/docs/msw/wince/readme.txt
index 816003d1569add0b1c089e3f97d25c5d93fd4319..aa837604ccc2a7614e1e15ad8710249439adc000 100644 (file)
--- a/docs/msw/wince/readme.txt
+++ b/docs/msw/wince/readme.txt
@@ -1,21 +1,19 @@
 
   =================================================
 
   =================================================

-  Welcome to wxWidgets/CE 2.5.4
+  Welcome to wxWidgets/CE

   =================================================
 
   =================================================
 

-You have downloaded version 2.5.4 of the Windows CE port of
-the wxWidgets GUI library. This runs on PocketPC 2002,
-SmartPhone 2002, and Windows CE .NET 4.x.
+You have downloaded the Windows CE port of the wxWidgets GUI library.
+This runs on Pocket PC 2002/2003, Smartphone 2002/2003,
+Windows CE .NET 4.x, and Windows Mobile 5.

 
 More information about the wxWidgets project as a whole
 can be found at:
 
   http://www.wxwidgets.org
 
 
 More information about the wxWidgets project as a whole
 can be found at:
 
   http://www.wxwidgets.org
 

-Information about the Windows CE port in particular
-can be found here:
-
-http://wiki.wxwindows.org/wiki.pl?Developers_Notebook/WxWinCE
+Information about the Windows CE port in particular can be found in
+the wxWinCE topic in the wxWidgets reference manual.

 
 Supported platforms
 ===================
 
 Supported platforms
 ===================


@@ -23,28 +21,35 @@ Supported platforms
 These are the supported platforms at the moment:
 
 - x86 emulator build in eVC 3 and eVC 4.x
 These are the supported platforms at the moment:
 
 - x86 emulator build in eVC 3 and eVC 4.x

-- PocketPC (StrongARM)
+- Pocket PC (StrongARM)
+- Smartphone (StrongARM)
+- Windows Mobile 5

 
 

-You can test the library and applications using PocketPC emulator 
-and/or Compaq iPAQ or other PDAs using PocketPC
+You can test the library and applications using the Pocket PC emulator 
+and/or Compaq iPAQ or other PDAs using Pocket PC.

 
 Compiler installation
 =====================
 
 
 Compiler installation
 =====================
 

+1. Embedded Visual C++
+----------------------
+

 Get the Visual C++ embedded (FREE) from Microsoft website
  http://msdn.microsoft.com/vstudio/device/embedded/download.asp
  
 You must use Embedded Visual C++ 3.0 or Embedded Visual C++ 4.x.
 Get the Visual C++ embedded (FREE) from Microsoft website
  http://msdn.microsoft.com/vstudio/device/embedded/download.asp
  
 You must use Embedded Visual C++ 3.0 or Embedded Visual C++ 4.x.

- 
-Install selecting only the two target platforms used:

 
 

-- WCE x86em (PocketPC emulation)
-- WCE ARM (PocketPC StrongARM)
+You can download the Smartphone 2002/3 and Pocket PC 2002/3
+SDKs separately.

 
 

-You can install other targets but you will need
-to create new configurations for them in the
-wxWidgets project files.
+2. Visual Studio 2005
+---------------------

 
 

+VS 2005 Professional is required to write Windows Mobile 5 applications, although Pocket PC
+2003 applications should also run on Mobile 5. VS 2005 must
+be purchased, and you can then download the Mobile 5 2005 SDK
+from Microsoft's site.
+ 

 wxWidgets/CE Configuration
 ================================
 
 wxWidgets/CE Configuration
 ================================
 


@@ -58,19 +63,30 @@ wxWidgets/CE Compilation
 
 NOTE: to generate targets not in the standard project files,
 you should rebuild the project files using Bakefile.
 
 NOTE: to generate targets not in the standard project files,
 you should rebuild the project files using Bakefile.

-See technote docs/tech/tn0016.txt for details.
+Also, if you are building from a CVS version of wxWidgets,
+you need to create eVC++ project files or get them from
+somewhere, such as the daily makefile builds here:
+
+http://biolpc22.york.ac.uk/pub/CVS_Makefiles/
+
+See technote docs/tech/tn0016.txt for details on using Bakefile,
+and you can get Bakefile from:
+
+http://bakefile.sf.net

 
 

-Open build/wince/wx.vcw, select an
-ARM or x86 target (or emulator target for eVC++ 4),
-and compile.
+Open build/wince/wx.vcw, select an ARM or x86 target (or emulator
+target for eVC++ 4), and compile.

 
 

-Then open samples/minimal/minimal.vcw, select an
-ARM, x86 or emulator target, and compile. You can
-use the emulator or real hardware to run the
-sample.
+Then open samples/minimal/minimal.vcw, select an ARM, x86 or emulator
+target, and compile. You can use the emulator or real hardware to run
+the sample.

 
 

-There may be long delays while VC++ computes dependencies, and expect
-to wait a long time for loading and saving the workspace. 
+There may be long delays while eVC++ computes dependencies, and expect
+to wait a long time for loading and saving workspaces. Do not attempt to
+save the wxWidgets library project file: it will take forever and generate
+a huge file, so make alterations either using Bakefile or by editing the
+project file with a text editor, and reloading. Sample project files are OK
+to save.

 
 To compile using the emulator on eVC++3:
 
 
 To compile using the emulator on eVC++3:
 


@@ -80,28 +96,55 @@ To compile using the emulator on eVC++3:
   and compile.
 
 - Open samples/minimal/minimal.vcw, select the
   and compile.
 
 - Open samples/minimal/minimal.vcw, select the

-  WIN32 (WCE x86 Debug) configuration, select Pocket PC 2002 and
-  Pocket PC 2002 Emulation as before, and compile.
+  WIN32 (WCE x86 Debug) configuration, and select Pocket PC 2002 and
+  Pocket PC 2002 Emulation as before.

 
 To compile using the emulator on eVC++4:
 
 - Open build/wince/wx.vcw, select the
 
 To compile using the emulator on eVC++4:
 
 - Open build/wince/wx.vcw, select the

-  WIN32 (WCE Emulator) Debug Unicode configuration, and compile.
+  WIN32 (WCE Emulator) Debug configuration, and compile.

 
 

-- Open samples/minimal/minimal.vcw with eCV 4.0, select the
+- Open samples/minimal/minimal.vcw with eVC++, select the

   WIN32 (WCE emulator) Debug configuration, and compile.
 
   WIN32 (WCE emulator) Debug configuration, and compile.
 

+Note: builds for the different SDKs (Smartphone, PPC, .Net)
+use the same directory and library names, so for the moment
+these builds cannot co-exist simultaneously.
+
+To use Visual Studio 2005, you need to allow VS to convert the projects
+first (but install all the SDKs you need to _before_ converting), and then
+you need to adjust the library settings of each wxWidgets and sample project.
+
+Edit the configuration properties for each configuration and in the Librarian,
+add a relative path ..\..\lib to each library path. For example:
+
+..\..\lib\$(PlatformName)\$(ConfigurationName)\wx_mono.lib
+
+Then, for a sample you want to compile, edit the configuration properties
+and make sure ..\..\lib\$(PlatformName)\$(ConfigurationName) is in the Linker/General/Additional
+Library Directories property. Also change the Linker/Input/Additional Dependencies
+property to something like:
+
+coredll.lib wx_mono.lib wx_wxjpeg.lib wx_wxpng.lib wx_wxzlib.lib wx_wxexpat.lib commctrl.lib winsock.lib wininet.lib
+
+since the library names in the wxWidgets workspace were changed
+by VS 2005.
+

 Status
 ======
 
 Status
 ======
 

-It's possible to create working PocketPC or Smartphone
+It's possible to create working Pocket PC or Smartphone

 applications with this port. For further information
 applications with this port. For further information

-about what has been done and what needs to be
-done, see the wxWinCE topic in the reference manual,
-and also:
+about how to use wxWidgets with Windows CE, and further
+work that needs to be done, see the wxWinCE topic in the
+reference manual, and also:

 
 http://wiki.wxwindows.org/wiki.pl?Developers_Notebook/WxWinCE
 
 
 http://wiki.wxwindows.org/wiki.pl?Developers_Notebook/WxWinCE
 

+The "Life!" demo in demos/life has some adaptations for
+wxWinCE, and also demonstrates how to make an installer for
+a Pocket PC application.
+

 Disclaimer
 ==========
 
 Disclaimer
 ==========