Time-stamp: <28/04/02 09:26:15 keuchel@netwave.de>

This dir contains major improvements by Stephane Rouleau
<s.rouleau@videotron.ca>.  

You need the folloing stuff to use it:

Non-standard perl stuff (download from CPAN):

* XML::Writer
* Win32::API. I had to rename variables from na to PL_na in API.xs.

When you want to use the XML interface (xprofile.html):

* MSXML2/4.0 COM Objects (MSXML 4.0 SP1). Can be downloaded
  from Microsoft. You can download the (smaller) CAB file and register
  the dlls manually.

USAGE

* Create a new configuration in your project/makefile.

* Add a macro like _PROFILE to your CFLAGS. Call __profiler_dump() in
  your code before your program exits when _PROFILE is set. You can
  include profiler.h to get the proto for this funtion.

* Add /Gh option to the compiler flags.

* Add -map option to linker flags or enable the "Generate Mapfile"
  checkbox.

* Add proft.lib to the libraries.

* Run your program.

* Get the profiler.txt output file from your device (maybe with my
  cecopy program) and run in through the xprofile.pl script.

* Open xprofile.html in IE and load the xml file.

NOTES

* You should only instrument a single dll/exe file with /Gh.
  Multiple map file are not (yet) supported.

SAMPLE BATCH FILE

  ::- this needs my desktop tools...
  cecopy ce:/profile0.txt pc:.
  cedel /profile0.txt

  set profilerdir=h:/src/wince/profiler-rouleau
  perl %profilerdir%/xprofile.pl profile0.txt wince-arm-hpc-wce300/vim.map profile0.xml

