home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 Mobile / Chip_Mobile_2001.iso / palm / system / _palmemu / palmemu.exe / Docs / _Building.txt < prev    next >
Encoding:
Text File  |  2000-08-14  |  5.9 KB  |  120 lines

  1. ========================================================================
  2. Build Notes 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. ========================================================================
  10. Windows
  11. ========================================================================
  12. To build the Palm OS Emulator under Windows, you will need Visual C++
  13. 6.0.  The Emulator runs under Windows 95, Windows 98, and Windows NT
  14. 4.0, so you should be able to build under those environments, too.
  15.  
  16. To build, simply load the workspace (Emulator.dsw) or project
  17. (Emulator.dsp) from the BuildWin directory, select the project target
  18. (you'll mostly likely be interested in building "Win 32 Release"), and
  19. select the the "Build/Build Emulator.exe" menu item.  For that target,
  20. the resulting executable will end up in
  21. ".../BuildWin/Release/Emulator.exe".
  22.  
  23. If you want to build the ROM Transfer Palm OS application, you will
  24. need CodeWarrior for Palm OS Release 6.
  25.  
  26. ========================================================================
  27. Macintosh
  28. ========================================================================
  29. To build the Palm OS Emulator under Mac OS, you will need CodeWarrior
  30. Pro 5.2.  Palm OS Emulator makes use of some C++ language features that
  31. are supported only in the version of the compiler that comes with that
  32. update.
  33.  
  34. To build, simply load the project Emulator.mcp in the BuildMac folder,
  35. select the project target (you'll mostly likely be interested in
  36. building "POSER PPC"), and select the the "Make" menu item.  For that
  37. target, the resulting executable will end up in
  38. "...:BuildMac:Built:Palm OS Emulator".
  39.  
  40. If you want to build the ROM Transfer Palm OS application, you will
  41. need CodeWarrior for Palm OS Release 6.
  42.  
  43. ========================================================================
  44. Unix
  45. ========================================================================
  46. Palm OS Emulator for Unix has been built on a number of platforms, but
  47. the one it's developed under is RedHat Linux 6.0 (kernel 2.2.5,
  48. glibc-devel 2.1.1-6 using XFree86 3.3.3.1-49 running a 16 bit display).
  49. People have also built it under Solaris 2.6 and 2.7, as well as QNX
  50. Neutrino, so you may have luck under those or other environments.
  51.  
  52. We use pthreads, so you need GNU glibc2 (aka Linux libc6) C library and
  53. a 2.x kernel on a Linux system.  Other operating systems need to support
  54. true threads.
  55.  
  56. The source makes heavy use of C++ templates and exceptions.  On Linux,
  57. you must have egcs-1.1.1 or better to compile it.  egcs-1.1 or any gcc
  58. below 2.95 may not work.  RedHat Linux 6.0 comes with egcs 1.1.2, so you
  59. should be OK there.  If you are running RedHat Linux 5.2, you will need
  60. to download the latest from <http://egcs.cygnus.com> and build it.  For
  61. other OS'es, either use egcs, or be sure your compiler supports these
  62. C++ features.
  63.  
  64.     (Note that egcs needs to be built with the HANDLE_SYSV_PRAGMA
  65.      option turned on in order to have the support to pack
  66.      structures correctly.  The Linux version of egcs has this
  67.      turned on, but other variants -- such as the compiler that
  68.      comes with FreeBSD -- may not.  If you're using gcc 2.95
  69.      or later, make sure it was compiled with the
  70.      HANDLE_PRAGMA_PACK option.)
  71.  
  72.     (Sparc note: the Sparc assembler doesn't seem able to handle
  73.      the mangled C++ names emitted by GCC.  You may have to follow
  74.      the instructions in the GCC FAQ "How to work around too long
  75.      C++ symbol names?")
  76.  
  77. We use the FLTK X toolkit.  I'm not going to get into an X GUI Toolkit
  78. religious war, so don't ask why not some other toolkit.  You are
  79. encouraged to add support for other toolkits, like Qt or GTK+ or even
  80. Xt.  I have tried to keep all of the FLTK code in the fltk_*.cpp files.
  81. If you add support for another toolkit, please follow that pattern.
  82. Don't pollute the UNIX-generic code with toolkit specific code.  FLTK
  83. is available from <http://www.fltk.org>, is a quick download, and is
  84. easy to build on a variety of OS'es.  We've tested with the binary
  85. install RPMs for 1.0.3 and 1.0.4, as well as the source install of
  86. 1.0.5 and 1.0.7.  "fluid" (the FLTK User Interface Design tool) is now
  87. also part of the build, so make sure it gets installed, too.
  88.  
  89.     NOTE: Not all FLTK's install the same way.  Some install their
  90.           includes in an "Fl" directory, some install their includes
  91.           in an "FL" directory.  The emulator is written to look for
  92.           them in "FL".  If you don't have that directory, you may
  93.           need to create a symbolic link with that name to "Fl".
  94.  
  95.           Additionally, the Emulator's build script expects libfltk.a
  96.           to be installed in /usr/lib or /usr/local/lib.  If you've
  97.           installed it elsewhere, use the --with-fltk=DIR configure
  98.           flag.  The directory you specify will be used as the prefix
  99.           for additional "include" and "lib" dirs to search.
  100.  
  101. To build the Emulator, first build and/or install FLTK.  Doing this
  102. first is very important.  Otherwise, the Emulator's build script won't
  103. find it.  After that, switch to the BuildUnix directory and execute
  104. the following commands:
  105.  
  106.      ./configure
  107.      make
  108.  
  109. You will end up with an application called "pose" that you can run.
  110.  
  111. If you want, the "configure" script understands the following command-
  112. line switches:
  113.  
  114.   --enable-palm-profile   Include support for profiling Palm applications
  115.   --enable-profile        Include support for profiling Poser itself
  116.   --enable-debug          Include debugging symbols.  This option also
  117.                           turns on palm-profile, turns off profile,
  118.                           compiles the source code without optimizations.
  119.   --with-fltk=DIR         Use the fltk which is installed on DIR.
  120.