                                                               
         *   ,-----.               *   ,-----.                               
          \ /.......\               \ /.......\                              
           \.........\               \.........\                              
           |..........)    ,-----.   |..........)   ,*  -.       ,-----.    ,-----.              
           |........./    /       *  |........./   /......\     /       *  /       *    
           |......../    (           |......../   /..=..=..\   (          (            
           | ------(      \          |`------"   :...@..@...:   \          \                 
           |        \      >-----    |           |..../\....|    `----.     >-----                
           |         \    /          |           :...(__)...:          \   /       
           |         |   (           |            \.\____/./            ) (          
           |         |    \          |             \..,,../    \       /   \         
           |         |     `-----"   |              `----"      `-----"     `-----"        
  ,------- | ------- | ------------- | -----------------------------------------------,
 / README \_/       \_/             \_/     Copyright 2002-2003 (c) Eric Poncet      / 
"-----------------------------------------------------------------------------------"  


  ,-----------------------,
 / IMPORTANT INFORMATION /
"-----------------------"
PLEASE READ THIS DOCUMENT VERY CAREFULLY. IF THERE ARE SOME TERMS OF IT YOU DO NOT WISH TO ACCEPT, YOU MAY NEITHER INSTALL NOR USE REPOSE ON ANY PLATFORM OF ANY KIND.

  ,-------------,
 / Description /
"-------------"
RePose is part of the NanoTools, a collection of developer tools.
RePose is a tool for POSE.
RePose automagically detects when a PRC has been ReBuilt and ReInstalls it into POSE.
Its main PurPose :) is to make the compile-link-test process easier. It will save you thousands of boring manual ReInstalls of your PRC into POSE. Hence the name: RePose will repose your wrist and give your mouse a pause... RePose also stands for "Reload and Execute for POSE".
Please note that RePose should also work on a Palm OS Simulator, provided it's fully compliant with PalmOS Host Control API.
RePose is packaged with his companion "ReMake", which takes care of automatic ReCompilation the same way RePose takes care of automatic ReInstall.
For your convenience, RePose is also available in French, German and Spanish on my web site.

  ,--------------,
 / Key feature  /
"---------------"
RePose is available as a PRC, which means it runs on the emulator, just like any other PRC. The biggest advantage of this approach is that you can use RePose on any platform to which POSE has been ported (Mac, Linux, Win32...), whereas a desktop-based solution using C++, Java or any other language would imply more complex tasks (especially for me) like porting and testing.

  ,--------------,
 / Requirements /
"--------------"
* Palm OS Emulator, a.k.a. POSE. I've developed RePose on POSE v3.5 for Win32. Previous versions and other platforms should work as well, provided they comply with the Host Control API.
* Palm OS ROM version 3.3 or later. I've tested RePose with 3.3, 3.5, 4.0 and 4.1 ROMs.
* About 20K available memory
* A couple of minutes of your precious time to read this document, the onboard help and tackle the beast

  ,---------------,
 / Compatibility /
"---------------"
RePose doesn't use any platform-specific trick. Though its primary goal is to be used with POSE, it should also run with a simulator and it does run on a real device (though it doesn't make much sense, as POSE's Host Control API that access the desktop filesystem is not implemented in a real device).

  ,----------,
 / Contents /
"----------"
There is a bunchlet of files in the zip archive. Here they are:
README.txt				You're reading it
help_de.txt				German help file (also available in menu Options/Help of German PRC)
help_en.txt				English help file (also available in menu Options/Help of English PRC)
help_es.txt				Spanish help file (also available in menu Options/Help of Spanish PRC)
help_fr.txt				French help file (also available in menu Options/Help of French PRC)
ReMake					Script that takes care of automatic recompilation
RePose_de.prc			German version
RePose_en.prc			English version
RePose_es.prc			Spanish version
RePose_fr.prc			French version
RePose.gif				RePose in action! PRC just got rebuilt... RePose reinstalls it into POSE

  ,--------------,
 / Installation /
"--------------"
Just drag and drop RePose.prc into POSE. You can also right-click POSE, pick 'Install Application/Database' and 'Other...'

  ,-------------,
 / User manual /
"-------------"
For details on how to use RePose and ReMake, please read help file in your favorite language. For your convenience, the very same help file is also included in RePose, under menu "Options/Help".

  ,------------,
 / Known bugs /
"------------"
If you need to ReInstall RePose into Pose (phewwww:) then you MUST set RePose status to 'inactive' BEFORE ReInstalling it. If you do not, be *assured* that the ReInstalled RePose will conflict with the old RePose that was running in the background. 

  ,-----------------,
 / Version history /
"-----------------"
1.2, 03/24/03 - Multilingual support (English, French, Spanish, German)
1.1, 03/13/03 - Added help, greyscale+color support, improved stability
1.0, 02/22/03 - For my own use. Kinda like a good-working prototype.

  ,--------,
 / A wish /
"--------"
I do hope you'll find RePose and/or ReMake useful. If you're curious, I enjoy reading your suggestions...
Also, If you'd like to get more stuff on mobile programming, including for other platforms, be my guest at http://mobile.eric-poncet.com.

  ,-------------------,
 / Wanna contact me? /
"-------------------"
Cool! Whether you're happy or unhappy with this program, feel free to contact me.
Point your browser to http://mobile.eric-poncet.com/contact.html and drop me a quick line.

  ,---------------,
 / Any warranty? /
"---------------"
HA HA! I REALLY LOVE YOUR SENSE OF HUMOR! THE ANSWER IS: "NO WAY!". READ ON...
THERE IS NO WARRANTY. THIS PRODUCT IS OFFERED FOR DISTRIBUTION IN THE HOPE THAT IT PROVES USEFUL. IT IS BEING PROVIDED "AS IS" WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE, USE, PERFORMANCE, RESULT, NOR NONINFRINGEMENT OF THIRD PARTY RIGHTS.
THE USER ACCEPTS FULL RESPONSIBILITY FOR ANY DAMAGES, CONSEQUENTIAL, INCIDENTAL OR OTHERWISE, RESULTING FROM ITS USE. I ASSUME NO RESPONSIBILITY FOR ANY ACTIONS THIS PROGRAM TAKES, NOR ANY FORM OF DAMAGE OR LOSS OF ANY KIND YOU MAY SUFFER WHILE/WHEN/BY USING IT, NOR FOR ANY CLAIM BY ANY THIRD PARTY.

  ,-------------,
 / Legal stuff /
"-------------"
THIS PROGRAM IS COPYRIGHT (c) 2002-2003 BY ERIC PONCET. ALL RIGHTS RESERVED.
THIS PROGRAM IS OWNED BY HIS AUTHOR: ERIC PONCET.
THIS PROGRAM'S ARCHITECTURE, DESIGN, PACKAGING, USER INTERFACE AND SOURCE CODE CONSTITUTE VALUABLE TRADE SECRETS OF THE AUTHOR, WHO HAS EXCLUSIVE AND UNLIMITED INTELLECTUAL PROPERTY RIGHTS IN THIS PROGRAM. BY USING THIS PROGRAM, YOU AGREE NOT TO REVERSE ENGINEER, DISASSEMBLE, DECOMPILE, ANALYZE, TWEAK, BINARY-EDIT OR ALTER ANY BIT (in the sense "Binary digIT") OF IT IN ANY WAY.
THIS PROGRAM IS PROVIDED AS FREEWARE AND MAY BE DISTRIBUTED FREELY AS IS AND AS A WHOLE AND NOT AS PART OF ANOTHER PRODUCT OR SERVICE OF ANY KIND.
IF YOU WISH TO USE ALL OR PART OF THIS PROGRAM IN COMMERCIAL OR SHAREWARE SOFTWARE, YOU HAVE TO CONTACT ME.
SEE THE ABOUT DIALOG FOR DETAILS.
 
Palm(tm) is a registered trademark of Palm Computing Inc., 3Com Corporation or its subsidiaries. 
