Use "MSW" and "Windows" more accurately to avoid confusion.

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

diff --git a/docs/msw/wince/readme.txt b/docs/msw/wince/readme.txt
index 7337d78c4a04c3111a985a62d86adde6fc41d04f..d48ba9a8ea138f96dc3d51fe6c2cd665c2d6fcf4 100644 (file)
--- a/docs/msw/wince/readme.txt
+++ b/docs/msw/wince/readme.txt
@@ -1,124 +1,78 @@
 
   =================================================
 
   =================================================

-  Welcome to wxWidgets/CE 2.5.2
+  Welcome to wxWidgets/CE

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

-You have downloaded version 2.5.2 of the Windows CE port of
-the wxWidgets GUI library. This runs on PocketPC 2002,
-SmartPhone 2002, and Windows CE .NET 4.x.
+This is the readme file for the Windows CE port of the wxWidgets GUI library
+which runs on Pocket PC 2002/2003, Smartphone 2002/2003, Windows CE .NET 4.x,
+and Windows Mobile 5. This port requires the use of Microsoft Visual Studio
+2005 and 2008, in particular eVC (Visual C++ Embedded) is not supported any
+longer.

 
 

-More information about the wxWidgets project as a whole
-can be found at:
+More information about the wxWidgets project as a whole can be found at:

 
 

-  http://www.wxwidgets.org
+  http://www.wxwidgets.org/

 
 

-Information about the Windows CE port in particular
-can be found here:
+Information about the Windows CE port in particular can be found in
+the wxWinCE topic in the wxWidgets reference manual.

 
 

-http://wiki.wxwindows.org/wiki.pl?Developers_Notebook/WxWinCE
-
-Supported platforms
-===================
-
-These are the supported platforms at the moment:
-
-- x86 emulator
-- PocketPC (StrongARM)
-
-You can test the library and applications using PocketPC emulator 
-and/or Compaq iPAQ or other PDAs using PocketPC
-
-Compiler installation
-=====================
-
-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 install other targets but you will need
-to create new configurations for them in the
-wxWidgets project files.

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

-You may wish to customize the following file
-before compiling wxWinCE:
+You may wish to customize the file include/wx/msw/wince/setup.h before building
+wxWinCE to disable any features that your program doesn't need and minimize the
+size of the library.

 
 

-include/wx/msw/wince/setup.h
-
-These are some of the Windows CE-specific settings
-you can adjust.
-
-wxUSE_POCKETPC_UI
-
-  If you are compiling with Windows CE .NET, you may
-  wish to emulate PocketPC behaviour (set it to 1), or
-  take advantage of the greater flexibility of
-  Windows CE .NET (set it to 0).
-  If 0, the PocketPC-specific toolbar class will be
-  used, which uses commandbar to combine the toolbar
-  and menubar in one control. If 1, the normal menubar
-  and toolbar behaviour will be used, as per
-  desktop Windows.
-
-wxUSE_SMARTPHONE
-
-  Set this to 1 if you wish to compile for the SmartPhone
-  platform (with eVC++ 3).

 
 wxWidgets/CE Compilation
 ================================
 
 
 wxWidgets/CE Compilation
 ================================
 

-Open src/msw/wince/wxWidgetsCE.vcp, select an
-ARM or x86 target (or emulator target for eVC++ 4),
-and compile.
-
-Then open samples/minimal/minimalCE.vcp, select an
-ARM, x86 or emulator target, and compile. You can
-use the emulator or real hardware to run the
-sample.
+Unless the archive you downloaded already included CE-specific project files,
+you first need to generate them yourself. For this please install bakefile
+(from http://www.bakefile.org/, see technote docs/tech/tn0016.txt for more
+details about it) and create the file build/bakefiles/Bakefiles.local.bkgen
+with the following contents for Visual Studio 2008 (replace 2008 with 2005
+everywhere for the previous version):

 
 

-There may be long delays while VC++ computes dependencies, and expect
-to wait a long time for loading and saving the workspace. 
+<?xml version="1.0" ?>

 
 

-To compile using the emulator on eVC++3:
+<bakefile-gen xmlns="http://www.bakefile.org/schema/bakefile-gen">
+    <add-formats>msvs2008prj(arm)</add-formats>
+    <add-flags files="wx.bkl" formats="msvs2008prj(arm)">
+        -o ../msw/wx_vc9arm.sln -DMSVS_PLATFORMS=pocketpc2003 -DCOMPILER_PREFIX=vc9arm
+    </add-flags>
+    <add-flags files="../../samples/*/*" formats="msvs2008prj(arm)">
+        -o $(INPUT_FILE_DIR)/$(INPUT_FILE_BASENAME_NOEXT)_vc9arm.sln -DMSVS_PLATFORMS=pocketpc2003 -DCOMPILER_PREFIX=vc9arm
+    </add-flags>
+</bakefile-gen>

 
 

-- Open src/msw/wince/wxWidgetsCE.vcp, select the
-  WIN32 (WCE x86) Debug Unicode configuration, close the dialog,
-  then select Pocket PC 2002 and Pocket PC 2002 Emulation on the toolbar,
-  and compile.
+Notice that this will create the output files in the directories using "vc9arm"
+prefix instead of the usual "vc" one which allows to build the normal wxMSW and
+wxCE in the same wxWidgets source tree. You're, of course, free, to use
+different names for the project files suffix and the output directories prefix
+if you wish.

 
 

-- Open samples/minimal/minimalCE.vcp, select the
-  WIN32 (WCE x86 Debug) configuration, select Pocket PC 2002 and
-  Pocket PC 2002 Emulation as before, and compile.
+Then do

 
 

-To compile using the emulator on eVC++4:
+cd %WXWIN%\build\bakefiles
+bakefile_gen -f msvs2008prj

 
 

-- Open src/msw/wince/wxWidgetsCE.vcp, select the
-  WIN32 (WCE Emulator) Debug Unicode configuration, and compile.
+to create all *vc9arm.vcproj files. After this, simply open the solution file
+in Visual Studio and build it.

 
 

-- Open samples/minimal/minimalCE.vcp with eCV 4.0, select the
-  WIN32 (WCE emulator) Debug configuration, and compile.

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

-Currently under development. For further information
-about what has been done and what needs to be
-done, see:
-
-http://wiki.wxwindows.org/wiki.pl?Developers_Notebook/WxWinCE
-
-Disclaimer
-==========
+It's possible to create working Pocket PC or Smartphone
+applications with this port. For further information
+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:

 
 

-All product names are used for identification purposes and are trademarks 
-or registered trademarks owned by their respective companies.
+http://wiki.wxwidgets.org/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.