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 4765329bbe0083df8eb20464b415916266f3fcee..d48ba9a8ea138f96dc3d51fe6c2cd665c2d6fcf4 100644 (file)
--- a/docs/msw/wince/readme.txt
+++ b/docs/msw/wince/readme.txt
@@ -1,92 +1,66 @@
 
   =================================================
 
   =================================================

-  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 Pocket PC 2002/2003,
-Smartphone 2002/2003, 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 in
 the wxWinCE topic in the wxWidgets reference manual.
 
 
 Information about the Windows CE port in particular can be found in
 the wxWinCE topic in the wxWidgets reference manual.
 

-Supported platforms
-===================

 
 

-These are the supported platforms at the moment:
-
-- x86 emulator build in eVC 3 and eVC 4.x
-- Pocket PC (StrongARM)
-- Smartphone (StrongARM)
-
-You can test the library and applications using the Pocket PC emulator 
-and/or Compaq iPAQ or other PDAs using Pocket PC.
-
-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.
-
-You can download the Smartphone 2002/3 and Pocket PC 2002/3
-SDKs separately.
- 

 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

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

-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.
+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):

 
 

-Open build/wince/wx.vcw, select an ARM or x86 target (or emulator
-target for eVC++ 4), and compile.
+<?xml version="1.0" ?>

 
 

-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.
+<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>

 
 

-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.
+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.

 
 

-To compile using the emulator on eVC++3:
+Then do

 
 

-- Open build/wince/wx.vcw, 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.
+cd %WXWIN%\build\bakefiles
+bakefile_gen -f msvs2008prj

 
 

-- Open samples/minimal/minimal.vcw, select the
-  WIN32 (WCE x86 Debug) configuration, select Pocket PC 2002 and
-  Pocket PC 2002 Emulation as before, add commdlg.lib to the link
-  flags, and compile. Do not add commdlg.lib if compiling for
-  Smartphone.
+to create all *vc9arm.vcproj files. After this, simply open the solution file
+in Visual Studio and build it.

 
 

-To compile using the emulator on eVC++4:
-
-- Open build/wince/wx.vcw, select the
-  WIN32 (WCE Emulator) Debug configuration, and compile.
-
-- Open samples/minimal/minimal.vcw with eVC++, select the
-  WIN32 (WCE emulator) Debug configuration, and compile.

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


@@ -97,15 +71,8 @@ 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:
 
 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.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.
 
 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
-==========
-
-All product names are used for identification purposes and are trademarks 
-or registered trademarks owned by their respective companies.
-