|
1 | | -Installation Instructions |
2 | | -************************* |
| 1 | +# Packaged Installation |
3 | 2 |
|
4 | | -Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002, 2004, 2005, |
5 | | -2006, 2007, 2008 Free Software Foundation, Inc. |
| 3 | +The RPM package of ibus-array can be found on https://rpmsphere.github.io/ |
6 | 4 |
|
7 | | - This file is free documentation; the Free Software Foundation gives |
8 | | -unlimited permission to copy, distribute and modify it. |
| 5 | +# Basic Installation |
9 | 6 |
|
10 | | -Packaged Installation |
11 | | -===================== |
12 | | - The RPM package of ibus-array can be found on |
13 | | -https://rpmsphere.github.io/ |
| 7 | +This project use the Meason build system. |
14 | 8 |
|
15 | | -Basic Installation |
16 | | -================== |
17 | | - |
18 | | - Briefly, the shell commands `./configure; make; make install' should |
19 | | -configure, build, and install this package. The following |
20 | | -more-detailed instructions are generic; see the `README' file for |
21 | | -instructions specific to this package. |
22 | | - |
23 | | - The `configure' shell script attempts to guess correct values for |
24 | | -various system-dependent variables used during compilation. It uses |
25 | | -those values to create a `Makefile' in each directory of the package. |
26 | | -It may also create one or more `.h' files containing system-dependent |
27 | | -definitions. Finally, it creates a shell script `config.status' that |
28 | | -you can run in the future to recreate the current configuration, and a |
29 | | -file `config.log' containing compiler output (useful mainly for |
30 | | -debugging `configure'). |
31 | | - |
32 | | - It can also use an optional file (typically called `config.cache' |
33 | | -and enabled with `--cache-file=config.cache' or simply `-C') that saves |
34 | | -the results of its tests to speed up reconfiguring. Caching is |
35 | | -disabled by default to prevent problems with accidental use of stale |
36 | | -cache files. |
37 | | - |
38 | | - If you need to do unusual things to compile the package, please try |
39 | | -to figure out how `configure' could check whether to do them, and mail |
40 | | -diffs or instructions to the address given in the `README' so they can |
41 | | -be considered for the next release. If you are using the cache, and at |
42 | | -some point `config.cache' contains results you don't want to keep, you |
43 | | -may remove or edit it. |
44 | | - |
45 | | - The file `configure.ac' (or `configure.in') is used to create |
46 | | -`configure' by a program called `autoconf'. You need `configure.ac' if |
47 | | -you want to change it or regenerate `configure' using a newer version |
48 | | -of `autoconf'. |
49 | | - |
50 | | -The simplest way to compile this package is: |
51 | | - |
52 | | - 1. `cd' to the directory containing the package's source code and type |
53 | | - `./configure' to configure the package for your system. |
54 | | - |
55 | | - Running `configure' might take a while. While running, it prints |
56 | | - some messages telling which features it is checking for. |
57 | | - |
58 | | - 2. Type `make' to compile the package. |
59 | | - |
60 | | - 3. Optionally, type `make check' to run any self-tests that come with |
61 | | - the package. |
62 | | - |
63 | | - 4. Type `make install' to install the programs and any data files and |
64 | | - documentation. |
65 | | - |
66 | | - 5. You can remove the program binaries and object files from the |
67 | | - source code directory by typing `make clean'. To also remove the |
68 | | - files that `configure' created (so you can compile the package for |
69 | | - a different kind of computer), type `make distclean'. There is |
70 | | - also a `make maintainer-clean' target, but that is intended mainly |
71 | | - for the package's developers. If you use it, you may have to get |
72 | | - all sorts of other programs in order to regenerate files that came |
73 | | - with the distribution. |
74 | | - |
75 | | - 6. Often, you can also type `make uninstall' to remove the installed |
76 | | - files again. |
77 | | - |
78 | | -Compilers and Options |
79 | | -===================== |
80 | | - |
81 | | - Some systems require unusual options for compilation or linking that |
82 | | -the `configure' script does not know about. Run `./configure --help' |
83 | | -for details on some of the pertinent environment variables. |
84 | | - |
85 | | - You can give `configure' initial values for configuration parameters |
86 | | -by setting variables in the command line or in the environment. Here |
87 | | -is an example: |
88 | | - |
89 | | - ./configure CC=c99 CFLAGS=-g LIBS=-lposix |
90 | | - |
91 | | - *Note Defining Variables::, for more details. |
92 | | - |
93 | | -Compiling For Multiple Architectures |
94 | | -==================================== |
95 | | - |
96 | | - You can compile the package for more than one kind of computer at the |
97 | | -same time, by placing the object files for each architecture in their |
98 | | -own directory. To do this, you can use GNU `make'. `cd' to the |
99 | | -directory where you want the object files and executables to go and run |
100 | | -the `configure' script. `configure' automatically checks for the |
101 | | -source code in the directory that `configure' is in and in `..'. |
102 | | - |
103 | | - With a non-GNU `make', it is safer to compile the package for one |
104 | | -architecture at a time in the source code directory. After you have |
105 | | -installed the package for one architecture, use `make distclean' before |
106 | | -reconfiguring for another architecture. |
107 | | - |
108 | | - On MacOS X 10.5 and later systems, you can create libraries and |
109 | | -executables that work on multiple system types--known as "fat" or |
110 | | -"universal" binaries--by specifying multiple `-arch' options to the |
111 | | -compiler but only a single `-arch' option to the preprocessor. Like |
112 | | -this: |
113 | | - |
114 | | - ./configure CC="gcc -arch i386 -arch x86_64 -arch ppc -arch ppc64" \ |
115 | | - CXX="g++ -arch i386 -arch x86_64 -arch ppc -arch ppc64" \ |
116 | | - CPP="gcc -E" CXXCPP="g++ -E" |
117 | | - |
118 | | - This is not guaranteed to produce working output in all cases, you |
119 | | -may have to build one architecture at a time and combine the results |
120 | | -using the `lipo' tool if you have problems. |
121 | | - |
122 | | -Installation Names |
123 | | -================== |
124 | | - |
125 | | - By default, `make install' installs the package's commands under |
126 | | -`/usr/local/bin', include files under `/usr/local/include', etc. You |
127 | | -can specify an installation prefix other than `/usr/local' by giving |
128 | | -`configure' the option `--prefix=PREFIX'. |
129 | | - |
130 | | - You can specify separate installation prefixes for |
131 | | -architecture-specific files and architecture-independent files. If you |
132 | | -pass the option `--exec-prefix=PREFIX' to `configure', the package uses |
133 | | -PREFIX as the prefix for installing programs and libraries. |
134 | | -Documentation and other data files still use the regular prefix. |
135 | | - |
136 | | - In addition, if you use an unusual directory layout you can give |
137 | | -options like `--bindir=DIR' to specify different values for particular |
138 | | -kinds of files. Run `configure --help' for a list of the directories |
139 | | -you can set and what kinds of files go in them. |
140 | | - |
141 | | - If the package supports it, you can cause programs to be installed |
142 | | -with an extra prefix or suffix on their names by giving `configure' the |
143 | | -option `--program-prefix=PREFIX' or `--program-suffix=SUFFIX'. |
144 | | - |
145 | | -Optional Features |
146 | | -================= |
147 | | - |
148 | | - Some packages pay attention to `--enable-FEATURE' options to |
149 | | -`configure', where FEATURE indicates an optional part of the package. |
150 | | -They may also pay attention to `--with-PACKAGE' options, where PACKAGE |
151 | | -is something like `gnu-as' or `x' (for the X Window System). The |
152 | | -`README' should mention any `--enable-' and `--with-' options that the |
153 | | -package recognizes. |
154 | | - |
155 | | - For packages that use the X Window System, `configure' can usually |
156 | | -find the X include and library files automatically, but if it doesn't, |
157 | | -you can use the `configure' options `--x-includes=DIR' and |
158 | | -`--x-libraries=DIR' to specify their locations. |
159 | | - |
160 | | -Particular systems |
161 | | -================== |
162 | | - |
163 | | - On HP-UX, the default C compiler is not ANSI C compatible. If GNU |
164 | | -CC is not installed, it is recommended to use the following options in |
165 | | -order to use an ANSI C compiler: |
166 | | - |
167 | | - ./configure CC="cc -Ae" |
168 | | - |
169 | | -and if that doesn't work, install pre-built binaries of GCC for HP-UX. |
170 | | - |
171 | | - On OSF/1 a.k.a. Tru64, some versions of the default C compiler cannot |
172 | | -parse its `<wchar.h>' header file. The option `-nodtk' can be used as |
173 | | -a workaround. If GNU CC is not installed, it is therefore recommended |
174 | | -to try |
175 | | - |
176 | | - ./configure CC="cc" |
177 | | - |
178 | | -and if that doesn't work, try |
179 | | - |
180 | | - ./configure CC="cc -nodtk" |
181 | | - |
182 | | -Specifying the System Type |
183 | | -========================== |
184 | | - |
185 | | - There may be some features `configure' cannot figure out |
186 | | -automatically, but needs to determine by the type of machine the package |
187 | | -will run on. Usually, assuming the package is built to be run on the |
188 | | -_same_ architectures, `configure' can figure that out, but if it prints |
189 | | -a message saying it cannot guess the machine type, give it the |
190 | | -`--build=TYPE' option. TYPE can either be a short name for the system |
191 | | -type, such as `sun4', or a canonical name which has the form: |
192 | | - |
193 | | - CPU-COMPANY-SYSTEM |
194 | | - |
195 | | -where SYSTEM can have one of these forms: |
196 | | - |
197 | | - OS KERNEL-OS |
198 | | - |
199 | | - See the file `config.sub' for the possible values of each field. If |
200 | | -`config.sub' isn't included in this package, then this package doesn't |
201 | | -need to know the machine type. |
202 | | - |
203 | | - If you are _building_ compiler tools for cross-compiling, you should |
204 | | -use the option `--target=TYPE' to select the type of system they will |
205 | | -produce code for. |
206 | | - |
207 | | - If you want to _use_ a cross compiler, that generates code for a |
208 | | -platform different from the build platform, you should specify the |
209 | | -"host" platform (i.e., that on which the generated programs will |
210 | | -eventually be run) with `--host=TYPE'. |
211 | | - |
212 | | -Sharing Defaults |
213 | | -================ |
214 | | - |
215 | | - If you want to set default values for `configure' scripts to share, |
216 | | -you can create a site shell script called `config.site' that gives |
217 | | -default values for variables like `CC', `cache_file', and `prefix'. |
218 | | -`configure' looks for `PREFIX/share/config.site' if it exists, then |
219 | | -`PREFIX/etc/config.site' if it exists. Or, you can set the |
220 | | -`CONFIG_SITE' environment variable to the location of the site script. |
221 | | -A warning: not all `configure' scripts look for a site script. |
222 | | - |
223 | | -Defining Variables |
224 | | -================== |
225 | | - |
226 | | - Variables not defined in a site shell script can be set in the |
227 | | -environment passed to `configure'. However, some packages may run |
228 | | -configure again during the build, and the customized values of these |
229 | | -variables may be lost. In order to avoid this problem, you should set |
230 | | -them in the `configure' command line, using `VAR=value'. For example: |
231 | | - |
232 | | - ./configure CC=/usr/local2/bin/gcc |
233 | | - |
234 | | -causes the specified `gcc' to be used as the C compiler (unless it is |
235 | | -overridden in the site shell script). |
236 | | - |
237 | | -Unfortunately, this technique does not work for `CONFIG_SHELL' due to |
238 | | -an Autoconf bug. Until the bug is fixed you can use this workaround: |
239 | | - |
240 | | - CONFIG_SHELL=/bin/bash /bin/bash ./configure CONFIG_SHELL=/bin/bash |
241 | | - |
242 | | -`configure' Invocation |
243 | | -====================== |
244 | | - |
245 | | - `configure' recognizes the following options to control how it |
246 | | -operates. |
247 | | - |
248 | | -`--help' |
249 | | -`-h' |
250 | | - Print a summary of all of the options to `configure', and exit. |
251 | | - |
252 | | -`--help=short' |
253 | | -`--help=recursive' |
254 | | - Print a summary of the options unique to this package's |
255 | | - `configure', and exit. The `short' variant lists options used |
256 | | - only in the top level, while the `recursive' variant lists options |
257 | | - also present in any nested packages. |
258 | | - |
259 | | -`--version' |
260 | | -`-V' |
261 | | - Print the version of Autoconf used to generate the `configure' |
262 | | - script, and exit. |
263 | | - |
264 | | -`--cache-file=FILE' |
265 | | - Enable the cache: use and save the results of the tests in FILE, |
266 | | - traditionally `config.cache'. FILE defaults to `/dev/null' to |
267 | | - disable caching. |
268 | | - |
269 | | -`--config-cache' |
270 | | -`-C' |
271 | | - Alias for `--cache-file=config.cache'. |
272 | | - |
273 | | -`--quiet' |
274 | | -`--silent' |
275 | | -`-q' |
276 | | - Do not print messages saying which checks are being made. To |
277 | | - suppress all normal output, redirect it to `/dev/null' (any error |
278 | | - messages will still be shown). |
279 | | - |
280 | | -`--srcdir=DIR' |
281 | | - Look for the package's source code in directory DIR. Usually |
282 | | - `configure' can determine that directory automatically. |
283 | | - |
284 | | -`--prefix=DIR' |
285 | | - Use DIR as the installation prefix. *Note Installation Names:: |
286 | | - for more details, including other options available for fine-tuning |
287 | | - the installation locations. |
288 | | - |
289 | | -`--no-create' |
290 | | -`-n' |
291 | | - Run the configure checks, but stop before creating any output |
292 | | - files. |
293 | | - |
294 | | -`configure' also accepts some other, not widely useful, options. Run |
295 | | -`configure --help' for more details. |
| 9 | +For more advanced configuration please refer to the command line help meson |
| 10 | +--help or the Meson documentation located at the |
| 11 | +[Mesonbuild website](https://mesonbuild.com/index.html). |
296 | 12 |
|
| 13 | + $ meson setup build && cd build |
| 14 | + $ meson compile |
| 15 | + $ meson install |
0 commit comments