README 4.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107
  1. ; Copyright (c) 1993-2007 by Richard Kelsey and Jonathan Rees. See file COPYING.
  2. Please report bugs to scheme-48-bugs@s48.org, and include
  3. the version number in your message.
  4. Installation instructions in file INSTALL.
  5. A user's guide is in file doc/user-guide.txt.
  6. Recent changes are listed in file doc/news.txt.
  7. Known bugs and things to do in the future are listed in doc/todo.txt.
  8. Send mail to scheme-48-request@s48.org to be put on a
  9. mailing list for announcements, discussion, bug reports, and bug
  10. fixes.
  11. -----
  12. The Scheme 48 root directory is organized as follows (not all files are
  13. listed here):
  14. README this file
  15. WINDOWS.txt notes on the Windows port
  16. INSTALL installation instructions
  17. COPYING copyright notice
  18. COPYING.rtf copyright notice in RTF format
  19. configure configuration script
  20. Makefile.in input to configure
  21. doc/ some documentation
  22. scheme48.man a Unix-style manual page
  23. manual.ps manual in Postscript
  24. manual.pdf manual in PDF
  25. html/ manual in html (the root is html/index.html)
  26. src/ manual sources
  27. todo.txt list of improvements we hope to make someday
  28. news.txt list of improvements we have already made
  29. io.txt how the I/O system works
  30. scheme/ scheme source files
  31. packages.scm meta-module definitions
  32. interfaces.scm system interface definitions
  33. more-interfaces.scm system interface definitions
  34. *-packages.scm module definitions
  35. bcomp/ the byte-code compiler
  36. vm/ virtual machine sources (written in Pre-Scheme)
  37. rts/ run-time system sources
  38. link/ static linker
  39. env/ development environment modules (debugger, etc.)
  40. big/ useful Scheme libraries and extensions ("Big Scheme")
  41. cml/ Concurrent ML libraries
  42. alt/ portable implementations of some Scheme 48 features
  43. opt/ optional code optimizer for the byte-code compiler
  44. prescheme/ code for running the VM using Scheme 48
  45. debug/ debugging utilities, tests, etc.
  46. misc/ very miscellaneous things (e.g. AMB operator)
  47. posix/ interface to POSIX system calls
  48. srfi/ SRFI implementations
  49. sort/ sorting libraries
  50. ps-compiler/ Pre-Scheme -> C compiler
  51. c/ c source files
  52. sysdep.h.in input to configure
  53. scheme48vm.c most of the VM (generated by Pre-Scheme compiler)
  54. scheme48vm.h extern declarations for scheme48vm.c
  55. scheme48vm-prelude.h internal declarations for scheme48vm.c
  56. scheme48heap.c storage management (generated by Pre-Scheme compiler)
  57. scheme48heap.h extern declarations for scheme48heap.c
  58. scheme48read-image.c reading a heap from a file
  59. scheme48write-image.c writing a heap to a file
  60. scheme48image.h extern declarations for scheme48...-image.c
  61. scheme48write-barrier.h WRITE_BARRIER(...) macro
  62. main.c entry point for the VM
  63. prescheme.h part of the VM
  64. bignum.c large integers
  65. bignum.h declarations for large integers
  66. bignumint.h internal declarations for large integers
  67. external.c support for calling C and being called from C
  68. extension.c default definition of vm_extension()
  69. scheme48.h C declarations and macros for Scheme 48 data structures
  70. scheme48.h.in template for scheme48.h
  71. old-scheme48.h old version, included for compatibility
  72. c-mods.h minor additions to the C language
  73. event.h header file for OS interface
  74. io.h ditto
  75. fd-io.h ditto
  76. srfi-27.c C-side support for SRFI 27 (random bits)
  77. asm-glue.c support code for (upcoming) native code
  78. unix/ Unix-specific source files
  79. unix.h header file for unix/* files
  80. posix/ C half of interface to POSIX system calls
  81. fake/ C files for insufficiently POSIX-compliant systems
  82. build/ code for building the system
  83. filenames.make included by Makefile, generated automatically
  84. filenames.scm code for generating filenames.make
  85. initial.image an image file containing a minimal Scheme system
  86. initial.debug debugging database for same
  87. initial.scm script for creating initial.image
  88. build-usual-image script for creating scheme48.image
  89. load-linker.exec script for loading the external linker
  90. build-external-modules script for creating external-module initializer
  91. minor-version-number current version number
  92. generate-c-header.bat Windows batch file for generating c/scheme48.h
  93. build-usual-image.bat Windows batch file for creating scheme48.image
  94. build-initial-image.bat Windows batch file for creating build/initial.image
  95. i-know-what-i-am-doing.bat Windows batch file for compiling VM to C
  96. scheme48.wxs WiX script for generating scheme48.msi
  97. emacs/ Emacs support