Debian Codegraph @

doc/gauche-config.1.in

raw
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/