unison/unison-src/transcripts-manual/gen-racket-libs.output.md

When we start out, ./scheme-libs/racket contains a bunch of library files that we'll need. They define the Unison builtins for Racket.

Next, we'll download the jit project and generate a few Racket files from it.

jit-setup/main> lib.install @unison/internal/releases/0.0.18

  Downloaded 14917 entities.

  I installed @unison/internal/releases/0.0.18 as
  unison_internal_0_0_18.

go = generateSchemeBoot "scheme-libs/racket"

  Loading changes detected in scratch.u.

  I found and typechecked these definitions in scratch.u. If you
  do an `add` or `update`, here's how your codebase would
  change:
  
    ⍟ These new definitions are ok to `add`:
    
      go : '{IO, Exception} ()

jit-setup/main> run go

  ()

After executing this, scheme-libs/racket will contain the full complement of unison libraries for a given combination of ucm version and @unison/internal version.

To set up racket to use these files, we need to create a package with them. This is accomplished by running.

raco pkg install -t dir unison

in the directory where the `unison directory is located. Then the runtime executable can be built with

raco exe scheme-libs/racket/unison-runtime.rkt

and a distributable directory can be produced with:

raco distribute <output-dir> scheme-libs/racket/unison-runtime

At that point, should contain the executable and all dependencies necessary to run it.