▼ |  | setup-plt: PLT Configuration and Installation

1 | Running setup-plt Executable
2 | Running setup-plt from Scheme
3 | ".plt" Archives
4 | Finding Installation Directories
5 | "info.ss" File Format
6 | Reading "info.ss" Files
7 | Paths Relative to "collects"
8 | Cross-References for Installed Manuals
| Index

► | 2 | Running setup-plt from Scheme

2.1 | setup-plt Unit
2.2 | Options Unit
2.3 | Options Signature

On this page:

2.1`` setup-plt Unit
setup@
2.2`` Options Unit
setup: option@
2.3`` Options Signature
setup-option^
verbose
make-verbose
compiler-verbose
clean
compile-mode
make-zo
make-so
make-launchers
make-info-domain
avoid-main-installation
call-install
force-unpack
pause-on-errors
specific-collections
archives
archive-implies-reindex
current-target-directory-getter
current-target-plt-directory-getter

top← prev up next →

### 2`` Running setup-plt from Scheme

The setup/setup-unit library provides setup-plt in unit form. The associated setup/option-sig and setup/option-unit libraries provides the interface for setting options for the run of setup-plt.

For example, to unpack a single ".plt" archive "x.plt", set the archives parameter to (list "x.plt") and leave specific-collections as null.

Link the options and setup units so that your option-setting code is initialized between them, e.g.:

(compound-unit
...
(link ...
[(OPTIONS : setup-option^) setup:option@]
[() my-init-options@ OPTIONS]
[() setup@ OPTIONS ...])
...)

#### 2.1`` setup-plt Unit

(require setup/setup-unit)

setup@ : unit?

Imports

- setup-option^

- compiler^

- compiler:option^

- launcher^

and exports nothing. Invoking setup@ starts the setup process.

#### 2.2`` Options Unit

(require setup/option-unit)

setup:option@ : unit?

Imports nothing and exports setup-option^.

#### 2.3`` Options Signature

(require setup/option-sig)

setup-option^ : signature

Provides parameters used to control setup-plt in unit form.

> (verbose) → boolean?
> (verbose on?) → void?
> on? : any/c

> If on, prints message from make to stderr. The default is #f.

> (make-verbose) → boolean?
> (make-verbose on?) → void?
> on? : any/c

> If on, verbose make. The default is #f.

> (compiler-verbose) → boolean?
> (compiler-verbose on?) → void?
> on? : any/c

> If on, verbose compiler. The default is #f.

> (clean) → boolean?
> (clean on?) → void?
> on? : any/c

> If on, delete ".zo" and ".so"/".dll"/".dylib" files in the specified collections. The default is #f.

> (compile-mode) → (or/c path? false/c)
> (compile-mode path) → void?
> path : (or/c path? false/c)

> If a path is given, use a ".zo" compiler other than plain compile, and build to (build-path "compiled" (compile-mode)). The default is #f.

> (make-zo) → boolean?
> (make-zo on?) → void?
> on? : any/c

> If on, compile ".zo". The default is #t.

> (make-so) → boolean?
> (make-so on?) → void?
> on? : any/c

> If on, compile ".so"/".dll" files. The default is #f.

> (make-launchers) → boolean?
> (make-launchers on?) → void?
> on? : any/c

> If on, make collection "info.ss"-specified launchers. The default is #t.

> (make-info-domain) → boolean?
> (make-info-domain on?) → void?
> on? : any/c

> If on, update "info-domain/compiled/cache.ss" for each collection path. The default is #t.

> (avoid-main-installation) → boolean?
> (avoid-main-installation on?) → void?
> on? : any/c

> If on, avoid building bytecode in the main installation tree when building other bytecode (e.g., in a user-specific collection). The default is #f.

> (call-install) → boolean?
> (call-install on?) → void?
> on? : any/c

> If on, call collection "info.ss"-specified setup code. The default is #t.

> (force-unpack) → boolean?
> (force-unpack on?) → void?
> on? : any/c

> If on, ignore version and already-installed errors when unpacking a ".plt" archive. The default is #f.

> (pause-on-errors) → boolean?
> (pause-on-errors on?) → void?
> on? : any/c

> If on, in the event of an error, prints a summary error and waits for stdin input before terminating. The default is #f.

> (specific-collections) → (listof path-string?)
> (specific-collections coll) → void?
> coll : (listof path-string?)

> A list of collections to set up; the empty list means set-up all collections if the archives list is also empty The default is null.

> (archives) → (listof path-string?)
> (archives arch) → void?
> arch : (listof path-string?)

> A list of ".plt" archives to unpack; any collections specified by the archives are set-up in addition to the collections listed in specific-collections. The default is null.

> (archive-implies-reindex) → boolean?
> (archive-implies-reindex on?) → void?
> on? : any/c

> If on, when archives has a non-empty list of packages, if any documentation is built, then suitable documentation start pages, search pages, and master index pages are re-built. The default is #t.

> (current-target-directory-getter) → (-> . path-string?)
> (current-target-directory-getter thunk) → void?
> thunk : (-> . path-string?)

> A thunk that returns the target directory for unpacking a relative ".plt" archive; when unpacking an archive, either this or the procedure in current-target-plt-directory-getter will be called. The default is current-directory.

> (current-target-plt-directory-getter)

> →

> (path-string?
> path-string?
> (listof path-string?) . -> . path-string?)

> (current-target-plt-directory-getter proc) → void?

> proc

> :

> (path-string?
> path-string?
> (listof path-string?) . -> . path-string?)

> A procedure that takes a preferred path, a path to the parent of the main "collects" directory, and a list of path choices; it returns a path for a "plt-relative" install; when unpacking an archive, either this or the procedure in current-target-directory-getter will be called, and in the former case, this procedure may be called multiple times. The default is (lambda (preferred main-parent-dir choices) preferred).

top← prev up next →