▼ |  | 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

On this page:

find-collects-dir
find-user-collects-dir
get-collects-search-dirs
find-doc-dir
find-user-doc-dir
get-doc-search-dirs
find-lib-dir
find-dll-dir
find-user-lib-dir
get-lib-search-dirs
find-include-dir
find-user-include-dir
get-include-search-dirs
find-console-bin-dir
find-gui-bin-dir
absolute-installation?

top ← prev up next →

### 4`` Finding Installation Directories

( require setup/dirs )

The setup/dirs library provides several procedures for locating installation directories:

( find-collects-dir ) → ( or/c path? false/c )

Returns a path to the installation’s main "collects" directory, or #f if none can be found. A #f result is likely only in a stand-alone executable that is distributed without libraries.

( find-user-collects-dir ) → path?

Returns a path to the user-specific "collects" directory; the directory indicated by the returned path may or may not exist.

( get-collects-search-dirs ) → ( listof path? )

Returns the same result as ( current-library-collection-paths ), which means that this result is not sensitive to the value of the use-user-specific-search-paths parameter.

( find-doc-dir ) → ( or/c path? false/c )

Returns a path to the installation’s "doc" directory. The result is #f if no such directory is available.

( find-user-doc-dir ) → path?

Returns a path to a user-specific "doc" directory. The directory indicated by the returned path may or may not exist.

( get-doc-search-dirs ) → ( listof path? )

Returns a list of paths to search for documentation, not including documentation stored in individual collections. Unless it is configured otherwise, the result includes any non-#f result of ( find-doc-dir ) and ( find-user-doc-dir ) – but the latter is included only if the value of the use-user-specific-search-paths parameter is #t.

( find-lib-dir ) → ( or/c path? false/c )

Returns a path to the installation’s "lib" directory, which contains libraries and other build information. The result is #f if no such directory is available.

( find-dll-dir ) → ( or/c path? false/c )

Returns a path to the directory that contains DLLs for use with the current executable (e.g., "libmzsch.dll" under Windows). The result is #f if no such directory is available, or if no specific directory is available (i.e., other than the platform’s normal search path).

( find-user-lib-dir ) → path?

Returns a path to a user-specific "lib" directory; the directory indicated by the returned path may or may not exist.

( get-lib-search-dirs ) → ( listof path? )

Returns a list of paths to search for libraries. Unless it is configured otherwise, the result includes any non-#f result of ( find-lib-dir ), ( find-dll-dir ), and ( find-user-lib-dir ) – but the last is included only if the value of the use-user-specific-search-paths parameter is #t.

( find-include-dir ) → ( or/c path? false/c )

Returns a path to the installation’s "include" directory, which contains ".h" files for building MzScheme extensions and embedding programs. The result is #f if no such directory is available.

( find-user-include-dir ) → path?

Returns a path to a user-specific "include" directory; the directory indicated by the returned path may or may not exist.

( get-include-search-dirs ) → ( listof path? )

Returns a list of paths to search for ".h" files. Unless it is configured otherwise, the result includes any non-#f result of ( find-include-dir ) and ( find-user-include-dir ) – but the latter is included only if the value of the use-user-specific-search-paths parameter is #t.

( find-console-bin-dir ) → ( or/c path? false/c )

Returns a path to the installation’s executable directory, where the stand-alone MzScheme executable resides. The result is #f if no such directory is available.

( find-gui-bin-dir ) → ( or/c path? false/c )

Returns a path to the installation’s executable directory, where the stand-alone MrEd executable resides. The result is #f if no such directory is available.

absolute-installation? : boolean?

A binary boolean flag that is true if this installation is using absolute path names.
top ← prev up next →