| 1 |
.\" -*-nroff-*- |
| 2 |
.TH GAUCHE\-CONFIG "1" "" "Gauche @GAUCHE_VERSION@" "Gauche Commands" |
| 3 |
.SH NAME |
| 4 |
gauche-config \- retrieve configuration parameters of Gauche |
| 5 |
.SH SYNOPSIS |
| 6 |
.B gauche-config |
| 7 |
.I option |
| 8 |
.br |
| 9 |
.sp 0.3 |
| 10 |
.SH DESCRIPTION |
| 11 |
.I Gauche-config |
| 12 |
displays various parameters specified at the configuration time |
| 13 |
of the Gauche Scheme implementation. It can be used in Makefile |
| 14 |
and other configuration scripts that uses Gauche. |
| 15 |
|
| 16 |
.SH OPTIONS |
| 17 |
|
| 18 |
.SS General parameter |
| 19 |
.TP |
| 20 |
.B -V |
| 21 |
The current Gauche version. |
| 22 |
|
| 23 |
.SS Parameters to compile applications using Gauche |
| 24 |
.TP |
| 25 |
.B -I |
| 26 |
Include path options required to compile programs using Gauche |
| 27 |
(Note: This doesn't work if Gauche installation directory |
| 28 |
path contains whitespaces. See --incdirs below.) |
| 29 |
.TP |
| 30 |
.B -L |
| 31 |
Library path options required to link programs using Gauche |
| 32 |
(Note: This doesn't work if Gauche installation directory |
| 33 |
path contains whitespaces. See --archdirs below.) |
| 34 |
.TP |
| 35 |
.B -l |
| 36 |
Link library options required to link programs using Gauche. |
| 37 |
.TP |
| 38 |
.B --cc |
| 39 |
The name of the C compiler used to compile this Gauche. |
| 40 |
.TP |
| 41 |
.B --cpp |
| 42 |
The command to run the C preprocessor. |
| 43 |
.TP |
| 44 |
.B --ac |
| 45 |
The directory that contains Gauche-specific autoconf macros. |
| 46 |
.TP |
| 47 |
.B --reconfigure |
| 48 |
The command line used to configure the current installation. |
| 49 |
.TP |
| 50 |
.B --arch |
| 51 |
The autoconf-style architecture signature (cpu-vendor-kernel-os). |
| 52 |
.TP |
| 53 |
.B --incdirs, --archdirs |
| 54 |
The list of directory names to be looked for include files and |
| 55 |
libraries, respectively. Each directory name may be quoted if |
| 56 |
it contains whitespaces, and separated by ':' on Unix platforms, or |
| 57 |
by ';' on Windows platforms. |
| 58 |
.TP |
| 59 |
.B --local-incdir, --local-libdir |
| 60 |
These are '-I' and '-L' flags for additional local headers/libraries |
| 61 |
to search, given by '--with-local' configure flags. Note that those |
| 62 |
are also included in '-I', '-L', '--incdirs', and '--archdirs'. |
| 63 |
|
| 64 |
.SS Parameters to install files |
| 65 |
.TP |
| 66 |
.B --prefix |
| 67 |
The directory prefix set by configure. |
| 68 |
.TP |
| 69 |
.B --sysincdir, --siteincdir, --pkgincdir |
| 70 |
Directories where system|site|package header files of extensions go. |
| 71 |
.TP |
| 72 |
.B --syslibdir, --sitelibdir, --pkglibdir |
| 73 |
Directories where system|site|package scheme files go. |
| 74 |
.TP |
| 75 |
.B --sysarchdir, --sitearchdir, --pkgarchdir |
| 76 |
Directories where system|site|package DSO files go. |
| 77 |
.TP |
| 78 |
.B --mandir, --infodir |
| 79 |
Directories where gauche manpage and info docs are installed. |
| 80 |
|
| 81 |
.SS Parameters to help building extensions |
| 82 |
.TP |
| 83 |
.B --object-suffix |
| 84 |
The extension of the compiled objects (e.g. 'o' or 'obj'). |
| 85 |
.TP |
| 86 |
.B --executable-suffix |
| 87 |
The extension of the executable including a period (empty on Unix systems, |
| 88 |
'.exe' on Windows. |
| 89 |
.TP |
| 90 |
.B --so-suffix |
| 91 |
The extension for dynamically loadable (dlopen-able) modules (e.g. 'so'). |
| 92 |
.TP |
| 93 |
.B --so-cflags |
| 94 |
Additional CFLAGS to create dynamically loadable modules. |
| 95 |
.TP |
| 96 |
.B --so-ldflags |
| 97 |
Additional LDFLAGS to create dynamically loadable modules. |
| 98 |
.TP |
| 99 |
.B --so-libs |
| 100 |
Additional libraries required to create dynamically loadable modules. |
| 101 |
.TP |
| 102 |
.B --dylib-suffix |
| 103 |
The extension for dynamically linked libraries (as opposed to dlopen()ed) |
| 104 |
Usually the same as --so-suffix, but OSX wants 'dylib'. |
| 105 |
.TP |
| 106 |
.B --dylib-ldflags |
| 107 |
LDFLAGS to create dynamically linked libraries. |
| 108 |
.TP |
| 109 |
.B --rpath-flag |
| 110 |
Compiler flag(s) to embed RPATH |
| 111 |
.TP |
| 112 |
.B --default-cflags |
| 113 |
This is the CFLAGS used to compile Gauche, and to be used to compile |
| 114 |
extensions as well. |
| 115 |
.TP |
| 116 |
.B --cppflags |
| 117 |
Compiler flag(s) passed to C preprocessor |
| 118 |
.TP |
| 119 |
.B --static-libs |
| 120 |
List of library link flags ('-llib') required to link Gauche statically. |
| 121 |
Similar to '-l', but this includes the libraries that are used |
| 122 |
for extension modules, and also the static library itself, |
| 123 |
that is -lgauche-static-X.X. |
| 124 |
.TP |
| 125 |
.B --libgauche-so |
| 126 |
The base name of dynamically linked libgauche. |
| 127 |
|
| 128 |
.SH AUTHORS |
| 129 |
Shiro Kawai (shiro @ acm . org) |
| 130 |
|
| 131 |
.SH SEE ALSO |
| 132 |
gosh(1), gauche-package(1) |
| 133 |
.PP |
| 134 |
Gauche Scheme script engine: |
| 135 |
.br |
| 136 |
https://practical-scheme.net/gauche/ |