WINDOWS.txt 3.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899
  1. Scheme 48 Windows port
  2. ----------------------
  3. Copyright (c) 1993-2005 by Richard Kelsey and Jonathan Rees. See file COPYING.
  4. Starting with version 1.3, Scheme 48 has a native Windows port, which
  5. works on Windows NT 4.0 and above (including Windows 2000 and XP, but
  6. not Windows 95, Windows 98, or Windows ME). At this time, the port is
  7. considered experimental.
  8. Specifically, the following caveats apply to the Windows port:
  9. o I/O is always binary; the I/O system doesn't perform any kind of
  10. automatic CR/LF conversion.
  11. o UDP sockets don't work. (But TCP sockets do.)
  12. o The "old-style" interface to loading external code dynamically
  13. doesn't work. (But the new interface works---see doc\news.txt and
  14. the documentation.)
  15. o The Posix libraries don't work (and probably never will, at least
  16. not in the current form).
  17. Installing Scheme 48 from the installer
  18. ---------------------------------------
  19. To install Scheme 48, download the .msi file and double-click on it.
  20. This requires Windows Installer version 2.0 or greater to work.
  21. Building Scheme 48 from source
  22. ------------------------------
  23. The Scheme 48 developers build the VM using Microsoft Visual C++
  24. 6.0SP6. To build the VM, load the scheme48.dsw workspace file into
  25. Visual C++, choose a configuration ("Win32 Debug" or "Win32 Release")
  26. and build. You'll need to have run build\generate-c-header.bat
  27. previously---see below. To generate the standard Scheme 48 image,
  28. you'll need to run build\build-usual-image.bat---also described below.
  29. You can then start Scheme 48 by saying
  30. scheme48vm -i scheme48.image
  31. (The installer creates a suitable front-end batch file for this
  32. incantation.)
  33. A number of batch files are supposed to do the jobs of the various
  34. other make targets in the Unix Makefile. To run them, you should be
  35. sitting in a shell in the root of the Scheme 48 hierarchy. Note that,
  36. for all except build-usual-image.bat you'll need to have a working
  37. Scheme 48 available your machine:
  38. build\generate-c-header.bat
  39. This generates the c\scheme48.h header file needed for compiling
  40. various VM extensions.
  41. It requires a command-line argument specifying how to start up a
  42. Scheme 48 REPL.
  43. Example:
  44. build\generate-c-header.bat "C:\Program Files\Scheme 48\Scheme 48 1.3\scheme48"
  45. build\build-usual-image.bat
  46. This generates the default scheme48.image from build\initial.image.
  47. It requires five command-line arguments:
  48. - the root directory of the Scheme 48 sources
  49. *with a trailing backslash*
  50. - the full path of the installed scheme/ subdirectory of the Scheme
  51. 48 sources
  52. - the name of the image file to be generated
  53. - the name of the VM executable
  54. - the filename of the initial image
  55. Example (supposing the Scheme 48 root directory sits at c:\scheme48)
  56. build\build-usual-image ".\" c:\scheme48\ "C:\Program Files\Scheme 48\Scheme 48 1.3\scheme" scheme48vm.exe build\initial.image
  57. build\build-initial-image.bat
  58. This builds build\initial.image from source.
  59. It requires a command-line argument specifying how to start up a
  60. Scheme 48 REPL.
  61. Before running it, you need to generate build\filenames.bat via
  62. <Scheme 48> -a batch < build\filenames.scm
  63. where <Scheme 48> starts up a Scheme 48 REPL, for example
  64. "C:\Program Files\Scheme 48\Scheme 48 1.3\scheme48" -a batch < build\filenames.scm
  65. build\build-initial-image.bat "C:\Program Files\Scheme 48\Scheme 48 1.3\scheme48"
  66. build\i-know-what-i-am-doing.bat
  67. This builds the VM C sources from Scheme.
  68. It requires a command-line argument specifying how to start up a
  69. Scheme 48 REPL.
  70. build\i-know-what-i-am-doing.bat "C:\Program Files\Scheme 48\Scheme 48 1.3\scheme48"