From 32d3c8b607bee7ad35b26e68355dea03b47005a9 Mon Sep 17 00:00:00 2001 From: Sam Tobin-Hochstadt Date: Fri, 29 Jan 2021 21:56:48 -0500 Subject: [PATCH] Describe Racket CS as the default. Relevant to #3663. --- .../scribblings/guide/performance.scrbl | 28 +++++++++++-------- 1 file changed, 16 insertions(+), 12 deletions(-) diff --git a/pkgs/racket-doc/scribblings/guide/performance.scrbl b/pkgs/racket-doc/scribblings/guide/performance.scrbl index 99ed253afb..1ff6ab9bca 100644 --- a/pkgs/racket-doc/scribblings/guide/performance.scrbl +++ b/pkgs/racket-doc/scribblings/guide/performance.scrbl @@ -52,13 +52,25 @@ Non-interactive mode should be used instead of the @section[#:tag "virtual-machines"]{Racket Virtual Machine Implementations} -Racket is available in three implementation variants: @deftech{3m}, -@deftech{CGC}, and @deftech{CS}: +Racket is available in three implementation variants: @deftech{CS}, +@deftech{3m}, and @deftech{CGC}: @itemlist[ - @item{@tech{3m} is the current default implementation, so it's - probably the one that you're using. + @item{@tech{CS} is the current default implementation. It is + a newer implementation that builds on + @hyperlink["https://www.scheme.com/"]{Chez Scheme} as its core + virtual machine. This implementation performs better than + the @tech{3m} implementation for most programs. + + For this variant, @racket[(system-type 'vm)] reports + @racket['chez-scheme] and @racket[(system-type 'gc)] reports + @racket['cs].} + + @item{@tech{3m} is an older variant, and was the default until version 8.0. + The implementation features a compiler and runtime written in C, + with a precise garbage collector and a just-in-time compiler (JIT) + on most platforms. For this variant, @racket[(system-type 'vm)] reports @racket['racket] and @racket[(system-type 'gc)] reports @@ -75,15 +87,7 @@ Racket is available in three implementation variants: @deftech{3m}, @racket['racket] and @racket[(system-type 'gc)] reports @racket['cgc].} - @item{@tech{CS} is a newer implementation that builds on - @hyperlink["https://www.scheme.com/"]{Chez Scheme} as its core - virtual machine. This implementation performs better for some - programs, and it is likely to improve and eventually replace - the @tech{3m} implementation as the default. - For this variant, @racket[(system-type 'vm)] reports - @racket['chez-scheme] and @racket[(system-type 'gc)] reports - @racket['cs].} ]