home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 Mobile / Chip_Mobile_2001.iso / palm / system / _palmemu / palmemu.exe / Docs / _ReadMe.txt < prev    next >
Encoding:
Text File  |  2000-08-14  |  5.6 KB  |  139 lines
  1. ========================================================================
  2. Read Me for the Palm OS Emulator
  3. Copyright (c) 1998-2000 Palm, Inc. or its subsidiaries.
  4. All rights reserved.
  5.  
  6. Please send bug reports, comments, suggestions, etc. to devsupp@palm.com
  7. ========================================================================
  8.  
  9. This document is the Read Me for the Palm OS Emulator (formerly known as
  10. Copilot).
  11.  
  12. Palm OS Emulator is an application that emulates the hardware for most
  13. Palm Computing Platform Hardware devices (e.g., Pilot, PalmPilot, Palm
  14. III, Palm V, Palm VII, etc.).  The Emulator runs on most standard
  15. desktop computers, includes those running Windows 95, Windows 98,
  16. Windows NT 4.0, Mac OS, and several flavors of Unix.
  17.  
  18. With the Palm OS Emulator, you can emulate the functions of a Palm
  19. hardware device, including running the built-in application, as well as
  20. installing and running 3rd party applications.
  21.  
  22. Palm OS Emulator is an Open Source project.  That means that the source
  23. code is available for you to peruse and modify.  If you make any
  24. changes that you think might benefit others, we urge you to consider
  25. sending them back to Palm Computing for inclusion in the main source
  26. code base.
  27.  
  28. You can find the Palm OS Emulator at:
  29.  
  30.     Stable:    <http://www.palmos.com/dev/tech/tools/emulator/>
  31.     Latest:    <http://www.palmos.com/dev/tech/tools/emulator/seeding.html>
  32.  
  33. You will also find this URL in the About Box for the Emulator.  The URL
  34. is an active hyperlink; you can usually just click on it to launch your
  35. Web browser and have it automatically access the Emulator home page.
  36.  
  37. We have much planned for the Palm OS Emulator.  For descriptions of some
  38. of the changes to appear in future releases, see the ERS (Engineering
  39. Resource Specification -- or something like that) in the Docs
  40. directory.
  41.  
  42. See also a couple of Emulator-related articles that appeared in the
  43. May/June 1998 issue of the Handheld Systems Journal (www.cdpubs.com --
  44. also included in the Docs directory in PDF format).
  45.  
  46.  
  47. Guide to the documentation files:
  48. ---------------------------------
  49. UsingPOSE.pdf
  50.     The official Poser documentation.  The current version documents
  51.     features up to Palm OS Emulator 3.0a3.  See the _News.txt or
  52.     _OldNews.txt files for changes since that version.
  53.  
  54. Bugs.txt
  55.     A small set of bugs that we think you need to know about.  Not
  56.     all known bugs are listed here -- just fairly relevent ones.
  57.  
  58. Building.txt
  59.     Instructions on how to build (compile) the Palm OS Emulator on
  60.     the various supported platforms.
  61.  
  62. Contributing.txt
  63.     Guidelines to follow (or at least consider) if you are thinking
  64.     of contributing to this Open Source project.
  65.  
  66. Credits.txt
  67.     List of people who have contributed to the Emulator project.
  68.  
  69. GPL.txt
  70.     Palm OS Emulator is an Open Source project distributed under and
  71.     protected by the GNU GENERAL PUBLIC LICENSE.  The text of the
  72.     license is included in this file.
  73.  
  74. News.txt
  75.     Blow-by-blow descriptions of changes made to the emulator as it
  76.     evolves over time.
  77.  
  78. OldNews.txt
  79.     News.txt was getting too big, so older entries have been archived
  80.     to this file.
  81.  
  82. ReadMe.txt
  83.     The document you're currently reading.
  84.  
  85. ToDo.txt
  86.     A short list of To Do items, for people wondering what features
  87.     are planned or for people wondering how they can contribute to
  88.     the project.
  89.  
  90. 12rollin.pdf
  91.     Handheld Systems Journal article written by the current Palm OS
  92.     Emulator engineer.  Covers the differences between the Palm OS
  93.     Emulator and Copilot, the program from which it was derived.
  94.  
  95. 13hewgil.pdf
  96.     Handheld Systems Journal article written by the original author
  97.     of Copilot.
  98.  
  99.  
  100. Notes on the version number:
  101. ----------------------------
  102. Palm Computing uses the following numbering scheme for versioning its
  103. products.  The version number has the following format:
  104.  
  105.     <major>.<minor>.<bug fix>[dab]<prerelease>
  106.  
  107. The "dab" appearing after the bug fix revision indicates the pre-release
  108. stage of the product.  The "d" means that it is currently under
  109. development.  Once all features have been added and it has undergone
  110. enough testing to ensure that it is not DOA, its pre-release stage is
  111. advanced to "alpha", and the version number is suffixed with "a".  Once
  112. all known critical bugs (crashers or bugs that prevent meaningful work)
  113. are fixed, the pre-release stage is advanced to "beta", and the version
  114. number is suffixed with a "b".  Finally, after all designated bugs have
  115. been fixed, the product is released, and the version number no longer
  116. includes a pre-release designation.
  117.  
  118. This version of the Palm OS Emulator is 3.0a7.  This means that the
  119. product is pretty much feature complete, but may have some known bugs in
  120. it.  Even so, during its development stage, the Palm OS Emulator has
  121. been in constant use by the Palm OS engineering team in the development
  122. of future versions of the Palm OS.  Thus, it should be pretty stable for
  123. use by 3rd party developers.
  124.  
  125.  
  126. Notes on the Profile version:
  127. -----------------------------
  128. Some Palm OS Emulator releases include a profiling version (indicated by
  129. its having "Profile" appended to its name).  This version of the
  130. emulator allows users to turn profiling on and off, and to save the
  131. results to disk in a format compatible with the CodeWarrior Profile
  132. application, or in a tab-delimited text file suitable for spreadsheets.
  133.  
  134. Because the extra code involved with profiling an application slows down
  135. all program execution (even when profiling isn't currently being used),
  136. profiling support is provided only in this special version.  If you
  137. don't intend to profile your application, you should use the normal
  138. version of the emulator.
  139.