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?
Version: 4.0.2

 

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.