fix: README -> README.md (working, this time)
This commit is contained in:
parent
57d9b129d8
commit
9fe3effa7d
2 changed files with 74 additions and 57 deletions
71
README.md
71
README.md
|
|
@ -1,60 +1,17 @@
|
||||||
[](https://github.com/cisco/ChezScheme/actions/workflows/test.yml)
|
# chez-openbsd - mirror of ChezScheme with OpenBSD boot files
|
||||||
|
## ChezScheme v9.5.9
|
||||||
|
|
||||||
Chez Scheme is both a programming language and an implementation
|
**THIS REPO IS A MIRROR OF [CHEZSCHEME](https://github.com/cisco/ChezScheme) CONTAINING OPENBSD BOOT FILES.**
|
||||||
of that language, with supporting tools and documentation.
|
I am not the owner of ChezScheme nor a developer of ChezScheme.
|
||||||
|
Please send issues related to ChezScheme directly to their [Github repo](https://github.com/cisco/ChezScheme).
|
||||||
|
You'll find a copy of the original README in `README.original.md`.
|
||||||
|
|
||||||
As a superset of the language described in the
|
To build on OpenBSD, simply do:
|
||||||
[Revised<sup>6</sup> Report on the Algorithmic Language Scheme](http://www.r6rs.org)
|
```bash
|
||||||
(R6RS), Chez Scheme supports all standard features of Scheme,
|
$ ./configure --threads
|
||||||
including first-class procedures, proper treatment of tail calls,
|
$ gmake -jN
|
||||||
continuations, user-defined records, libraries, exceptions, and
|
```
|
||||||
hygienic macro expansion.
|
`--threads` enables (posix) thread support and the `N` in `-jN` being the number of cores in your system.
|
||||||
|
|
||||||
Chez Scheme also includes extensive support for interfacing with C
|
See [releases](https://basedwa.re/tmtt/chez-openbsd/releases).
|
||||||
and other languages, support for multiple threads possibly running
|
See [the original blogpost](https://heimdall.pm/blog/2022/07/28/how-to-build-chezscheme-on-openbsd.html) for more information.
|
||||||
on multiple cores, non-blocking I/O, and many other features.
|
|
||||||
|
|
||||||
The Chez Scheme implementation consists of a compiler, run-time
|
|
||||||
system, and programming environment.
|
|
||||||
Although an interpreter is available, all code is compiled by
|
|
||||||
default.
|
|
||||||
Source code is compiled on-the-fly when loaded from a source file
|
|
||||||
or entered via the shell.
|
|
||||||
A source file can also be precompiled into a stored binary form and
|
|
||||||
automatically recompiled when its dependencies change.
|
|
||||||
Whether compiling on the fly or precompiling, the compiler produces
|
|
||||||
optimized machine code, with some optimization across separately
|
|
||||||
compiled library boundaries.
|
|
||||||
The compiler can also be directed to perform whole-program compilation,
|
|
||||||
which does full cross-library optimization and also reduces a
|
|
||||||
program and the libraries upon which it depends to a single binary.
|
|
||||||
|
|
||||||
The run-time system interfaces with the operating system and supports,
|
|
||||||
among other things, binary and textual (Unicode) I/O, automatic
|
|
||||||
storage management (dynamic memory allocation and generational
|
|
||||||
garbage collection), library management, and exception handling.
|
|
||||||
By default, the compiler is included in the run-time system, allowing
|
|
||||||
programs to be generated and compiled at run time, and storage for
|
|
||||||
dynamically compiled code, just like any other dynamically allocated
|
|
||||||
storage, is automatically reclaimed by the garbage collector.
|
|
||||||
|
|
||||||
The programming environment includes a source-level debugger, a
|
|
||||||
mechanism for producing HTML displays of profile counts and program
|
|
||||||
"hot spots" when profiling is enabled during compilation, tools for
|
|
||||||
inspecting memory usage, and an interactive shell interface (the
|
|
||||||
expression editor, or "expeditor" for short) that supports multi-line
|
|
||||||
expression editing.
|
|
||||||
|
|
||||||
The R6RS core of the Chez Scheme language is described in
|
|
||||||
[The Scheme Programming Language](http://www.scheme.com/tspl4/),
|
|
||||||
which also includes an introduction to Scheme and a set of example programs.
|
|
||||||
Chez Scheme's additional language, run-time system, and
|
|
||||||
programming environment features are described in the
|
|
||||||
[Chez Scheme User's Guide](http://cisco.github.io/ChezScheme/csug9.5/csug.html).
|
|
||||||
The latter includes a shared index and a shared summary of forms,
|
|
||||||
with links where appropriate to the former, so it is often the best
|
|
||||||
starting point.
|
|
||||||
|
|
||||||
Get started with Chez Scheme by [Building Chez Scheme](BUILDING).
|
|
||||||
|
|
||||||
For more information see the [Chez Scheme Project Page](https://cisco.github.io/ChezScheme/).
|
|
||||||
|
|
|
||||||
60
README.original.md
Normal file
60
README.original.md
Normal file
|
|
@ -0,0 +1,60 @@
|
||||||
|
[](https://github.com/cisco/ChezScheme/actions/workflows/test.yml)
|
||||||
|
|
||||||
|
Chez Scheme is both a programming language and an implementation
|
||||||
|
of that language, with supporting tools and documentation.
|
||||||
|
|
||||||
|
As a superset of the language described in the
|
||||||
|
[Revised<sup>6</sup> Report on the Algorithmic Language Scheme](http://www.r6rs.org)
|
||||||
|
(R6RS), Chez Scheme supports all standard features of Scheme,
|
||||||
|
including first-class procedures, proper treatment of tail calls,
|
||||||
|
continuations, user-defined records, libraries, exceptions, and
|
||||||
|
hygienic macro expansion.
|
||||||
|
|
||||||
|
Chez Scheme also includes extensive support for interfacing with C
|
||||||
|
and other languages, support for multiple threads possibly running
|
||||||
|
on multiple cores, non-blocking I/O, and many other features.
|
||||||
|
|
||||||
|
The Chez Scheme implementation consists of a compiler, run-time
|
||||||
|
system, and programming environment.
|
||||||
|
Although an interpreter is available, all code is compiled by
|
||||||
|
default.
|
||||||
|
Source code is compiled on-the-fly when loaded from a source file
|
||||||
|
or entered via the shell.
|
||||||
|
A source file can also be precompiled into a stored binary form and
|
||||||
|
automatically recompiled when its dependencies change.
|
||||||
|
Whether compiling on the fly or precompiling, the compiler produces
|
||||||
|
optimized machine code, with some optimization across separately
|
||||||
|
compiled library boundaries.
|
||||||
|
The compiler can also be directed to perform whole-program compilation,
|
||||||
|
which does full cross-library optimization and also reduces a
|
||||||
|
program and the libraries upon which it depends to a single binary.
|
||||||
|
|
||||||
|
The run-time system interfaces with the operating system and supports,
|
||||||
|
among other things, binary and textual (Unicode) I/O, automatic
|
||||||
|
storage management (dynamic memory allocation and generational
|
||||||
|
garbage collection), library management, and exception handling.
|
||||||
|
By default, the compiler is included in the run-time system, allowing
|
||||||
|
programs to be generated and compiled at run time, and storage for
|
||||||
|
dynamically compiled code, just like any other dynamically allocated
|
||||||
|
storage, is automatically reclaimed by the garbage collector.
|
||||||
|
|
||||||
|
The programming environment includes a source-level debugger, a
|
||||||
|
mechanism for producing HTML displays of profile counts and program
|
||||||
|
"hot spots" when profiling is enabled during compilation, tools for
|
||||||
|
inspecting memory usage, and an interactive shell interface (the
|
||||||
|
expression editor, or "expeditor" for short) that supports multi-line
|
||||||
|
expression editing.
|
||||||
|
|
||||||
|
The R6RS core of the Chez Scheme language is described in
|
||||||
|
[The Scheme Programming Language](http://www.scheme.com/tspl4/),
|
||||||
|
which also includes an introduction to Scheme and a set of example programs.
|
||||||
|
Chez Scheme's additional language, run-time system, and
|
||||||
|
programming environment features are described in the
|
||||||
|
[Chez Scheme User's Guide](http://cisco.github.io/ChezScheme/csug9.5/csug.html).
|
||||||
|
The latter includes a shared index and a shared summary of forms,
|
||||||
|
with links where appropriate to the former, so it is often the best
|
||||||
|
starting point.
|
||||||
|
|
||||||
|
Get started with Chez Scheme by [Building Chez Scheme](BUILDING).
|
||||||
|
|
||||||
|
For more information see the [Chez Scheme Project Page](https://cisco.github.io/ChezScheme/).
|
||||||
Reference in a new issue