-
Notifications
You must be signed in to change notification settings - Fork 4
/
Copy pathRelease-notes-for-0-37-0.html
403 lines (366 loc) · 14.8 KB
/
Release-notes-for-0-37-0.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
<!DOCTYPE html>
<html lang="en">
<head>
<base href=".">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Release 0.37</title>
<link rel="stylesheet" href="assets/css/dark-frontend.css" type="text/css" title="dark">
<link rel="alternate stylesheet" href="assets/css/light-frontend.css" type="text/css" title="light">
<link rel="stylesheet" href="assets/css/bootstrap-toc.min.css" type="text/css">
<link rel="stylesheet" href="assets/css/jquery.mCustomScrollbar.min.css">
<link rel="stylesheet" href="assets/js/search/enable_search.css" type="text/css">
<link rel="stylesheet" href="assets/css/notes.css" type="text/css">
<link rel="stylesheet" href="assets/css/prism-tomorrow.css" type="text/css" title="dark">
<link rel="alternate stylesheet" href="assets/css/prism.css" type="text/css" title="light">
<script src="assets/js/mustache.min.js"></script>
<script src="assets/js/jquery.js"></script>
<script src="assets/js/bootstrap.js"></script>
<script src="assets/js/scrollspy.js"></script>
<script src="assets/js/typeahead.jquery.min.js"></script>
<script src="assets/js/search.js"></script>
<script src="assets/js/compare-versions.js"></script>
<script src="assets/js/jquery.mCustomScrollbar.concat.min.js"></script>
<script src="assets/js/bootstrap-toc.min.js"></script>
<script src="assets/js/jquery.touchSwipe.min.js"></script>
<script src="assets/js/anchor.min.js"></script>
<script src="assets/js/tag_filtering.js"></script>
<script src="assets/js/language_switching.js"></script>
<script src="assets/js/styleswitcher.js"></script>
<script src="assets/js/lines_around_headings.js"></script>
<script src="assets/js/prism-core.js"></script>
<script src="assets/js/prism-autoloader.js"></script>
<script src="assets/js/prism_autoloader_path_override.js"></script>
<script src="assets/js/prism-keep-markup.js"></script>
<script src="assets/js/trie.js"></script>
<link rel="icon" type="image/png" href="assets/images/favicon.png">
<link rel="shortcut icon" href="assets/images/favicon.png">
</head>
<body class="no-script
">
<script>
$('body').removeClass('no-script');
</script>
<nav class="navbar navbar-fixed-top navbar-default" id="topnav">
<div class="container-fluid">
<div class="navbar-right">
<a id="toc-toggle">
<span class="glyphicon glyphicon-menu-right"></span>
<span class="glyphicon glyphicon-menu-left"></span>
</a>
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar-wrapper" aria-expanded="false">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<span title="light mode switch" class="glyphicon glyphicon-sunglasses pull-right" id="lightmode-icon"></span>
<form class="navbar-form pull-right" id="navbar-search-form">
<div class="form-group has-feedback">
<input type="text" class="form-control input-sm" name="search" id="sidenav-lookup-field" placeholder="search" disabled>
<span class="glyphicon glyphicon-search form-control-feedback" id="search-mgn-glass"></span>
</div>
</form>
</div>
<div class="navbar-header">
<a id="sidenav-toggle">
<span class="glyphicon glyphicon-menu-right"></span>
<span class="glyphicon glyphicon-menu-left"></span>
</a>
<a id="home-link" href="index.html" class="hotdoc-navbar-brand">
<img src="assets/images/meson_logo.png" alt="Home">
</a>
</div>
<div class="navbar-collapse collapse" id="navbar-wrapper">
<ul class="nav navbar-nav" id="menu">
<li class="dropdown">
<a class="dropdown-toggle" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
Modules <span class="caret"></span>
</a>
<ul class="dropdown-menu" id="modules-menu">
<li>
<a href="CMake-module.html">CMake</a>
</li>
<li>
<a href="Cuda-module.html">CUDA</a>
</li>
<li>
<a href="Dlang-module.html">Dlang</a>
</li>
<li>
<a href="External-Project-module.html">External Project</a>
</li>
<li>
<a href="Fs-module.html">Filesystem</a>
</li>
<li>
<a href="Gnome-module.html">GNOME</a>
</li>
<li>
<a href="Hotdoc-module.html">Hotdoc</a>
</li>
<li>
<a href="i18n-module.html">i18n</a>
</li>
<li>
<a href="Icestorm-module.html">Icestorm</a>
</li>
<li>
<a href="Java-module.html">Java</a>
</li>
<li>
<a href="Keyval-module.html">Keyval</a>
</li>
<li>
<a href="Pkgconfig-module.html">Pkgconfig</a>
</li>
<li>
<a href="Python-3-module.html">Python 3</a>
</li>
<li>
<a href="Python-module.html">Python</a>
</li>
<li>
<a href="Qt4-module.html">Qt4</a>
</li>
<li>
<a href="Qt5-module.html">Qt5</a>
</li>
<li>
<a href="Qt6-module.html">Qt6</a>
</li>
<li>
<a href="Rust-module.html">Rust</a>
</li>
<li>
<a href="Simd-module.html">Simd</a>
</li>
<li>
<a href="SourceSet-module.html">SourceSet</a>
</li>
<li>
<a href="Wayland-module.html">Wayland</a>
</li>
<li>
<a href="Windows-module.html">Windows</a>
</li>
</ul>
</li>
<li class="dropdown">
<a class="dropdown-toggle" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
Quick References <span class="caret"></span>
</a>
<ul class="dropdown-menu" id="quick-refs-menu">
<li>
<a href="Reference-manual.html">Functions</a>
</li>
<li>
<a href="Build-options.html">Options</a>
</li>
<li>
<a href="Configuration.html">Configuration</a>
</li>
<li>
<a href="Dependencies.html">Dependencies</a>
</li>
<li>
<a href="Unit-tests.html">Tests</a>
</li>
<li>
<a href="Syntax.html">Syntax</a>
</li>
</ul>
</li>
</ul>
<div class="hidden-xs hidden-sm navbar-text navbar-center">
<p><b>The Meson Build System</b></p>
</div>
</div>
</div>
</nav>
<main>
<div data-extension="core" data-hotdoc-in-toplevel="True" data-hotdoc-project="Meson-documentation" data-hotdoc-ref="Release-notes-for-0-37-0.html" class="page_container" id="page-wrapper">
<script src="assets/js/utils.js"></script>
<div class="panel panel-collapse oc-collapsed" id="sidenav" data-hotdoc-role="navigation">
<script src="assets/js/full-width.js"></script>
<div id="sitenav-wrapper">
<iframe src="hotdoc-sitemap.html" id="sitenav-frame"></iframe>
</div>
</div>
<div id="body">
<div id="main">
<div id="page-description" data-hotdoc-role="main">
<h1 id="new-features">New features</h1>
<h2 id="mesontest">Mesontest</h2>
<p>Mesontest is a new testing tool that allows you to run your tests in
many different ways. As an example you can run tests multiple times:</p>
<pre><code>mesontest --repeat=1000 a_test
</code></pre>
<p>or with an arbitrary wrapper executable:</p>
<pre><code>mesontest --wrap='valgrind --tool=helgrind' a_test
</code></pre>
<p>or under <code>gdb</code>, 1000 times in a row. This is handy for tests that fail
spuriously, as when the crash happens you are given the full GDB
command line:</p>
<pre><code>mesontest --repeat=1000 --gdb a_test
</code></pre>
<h2 id="mesonrewriter">Mesonrewriter</h2>
<p>Mesonrewriter is an experimental tool to manipulate your build
definitions programmatically. It is not installed by default yet but
those interested can run it from the source repository.</p>
<p>As an example, here is how you would add a source file to a build target:</p>
<pre><code>mesonrewriter add --target=program --filename=new_source.c
</code></pre>
<h2 id="shared-modules">Shared modules</h2>
<p>The new <code>shared_module</code> function allows the creation of shared
modules, that is, extension modules such as plugins that are meant to
be used solely with <code>dlopen</code> rather than linking them to targets.</p>
<h2 id="gnome-module">Gnome module</h2>
<ul>
<li>Detect required programs and print useful errors if missing</li>
</ul>
<h3 id="gtkdoc">gtkdoc</h3>
<ul>
<li>Allow passing a list of directories to <code>src_dir</code> keyword argument</li>
<li>Add <code>namespace</code> keyword argument</li>
<li>Add <code>mode</code> keyword argument</li>
<li>Fix <code>gtkdoc-scangobj</code> finding local libraries</li>
</ul>
<h3 id="compile_resources">compile_resources</h3>
<ul>
<li>Add <code>gresource_bundle</code> keyword argument to output <code>.gresource</code> files</li>
<li>Add <code>export</code> and <code>install_header</code> keyword arguments</li>
<li>Use depfile support available in GLib >= 2.52.0</li>
</ul>
<h2 id="i18n-module">i18n module</h2>
<ul>
<li>Add <code>merge_file()</code> function for creating translated files</li>
<li>Add <code>preset</code> keyword argument to included common gettext flags</li>
<li>Read languages from <code>LINGUAS</code> file</li>
</ul>
<h2 id="llvm-ir-compilation">LLVM IR compilation</h2>
<p>Meson has long had support for compiling assembler (GAS) files. In
this release we add support for compiling LLVM IR files in a similar
way when building with the Clang compiler. Just add it to the list of
files when creating a <code>library</code> or <code>executable</code> target like any other
source file. No special handling is required:</p>
<pre><code class="language-meson">executable('some-exe', 'main.c', 'asm-file.S', 'ir-file.ll')
</code></pre>
<p>As always, you can also mix LLVM IR files with C++, C, and Assembly
(GAS) sources.</p>
<h2 id="vim-indent-and-syntax-files">ViM indent and syntax files</h2>
<p>We now include filetype, indent, and syntax files for ViM <a href="https://github.com/mesonbuild/meson/tree/master/data/syntax-highlighting/vim">with the
source
tree</a>.
Please file issues (or pull requests!) for enhancements or if you face
any problems using them.</p>
<h2 id="push-urls-in-wrap-files">Push URLs in .wrap files</h2>
<p><a href="Using-the-WrapDB.html">.wrap files</a> for subprojects can now include a
separate push URL to allow developers to push changes directly from a
subproject git checkout.</p>
<h2 id="pkgconfig-dependencies">pkg-config dependencies</h2>
<p>Meson now supports multiple version restrictions while searching for pkg-config dependencies.</p>
<pre><code class="language-meson"># Just want a lower limit
dependency('zlib', version : '>1.2.1')
# Want both a lower and an upper limit
dependency('opencv', version : ['>=2.3.0', '<=3.1.0'])
# Want to exclude one specific broken version
dependency('foolite', version : ['>=3.12.1', '!=3.13.99'])
</code></pre>
<h2 id="overriding-more-binaries-with-environment-variables">Overriding more binaries with environment variables</h2>
<p>You can now specify the binary to be used for the following tools by
setting the corresponding environment variable</p>
<table>
<thead>
<tr>
<th> Name</th>
<th> Environment variable</th>
</tr>
</thead>
<tbody>
<tr>
<td> pkg-config</td>
<td> PKG_CONFIG</td>
</tr>
<tr>
<td> readelf</td>
<td> READELF</td>
</tr>
<tr>
<td> nm</td>
<td> NM</td>
</tr>
</tbody>
</table>
<h2 id="support-for-localstatedir">Support for <code>localstatedir</code>
</h2>
<p>Similar to other options such as <code>bindir</code> and <code>datadir</code>, you can now
specify the <code>localstatedir</code> for a project by passing
<code>--localstatedir=dir</code> to <code>meson</code> or <code>-Dlocalstatedir=dir</code> to
<code>mesonconf</code> after configuration. You can also access it from inside
the <code>meson.build</code> file with <code>get_option('localstatedir')</code>.</p>
<h2 id="new-compiler-function-symbols_have_underscore_prefix">New compiler function <code>symbols_have_underscore_prefix</code>
</h2>
<p>Checks if the compiler prefixes an underscore to C global symbols with
the default calling convention. This is useful when linking to
compiled assembly code, or other code that does not have its C symbol
mangling handled transparently by the compiler.</p>
<pre><code class="language-meson">cc = meson.get_compiler('c')
conf = configuration_data()
if cc.symbols_have_underscore_prefix()
conf.set('SYMBOLS_HAVE_UNDERSCORE', true)
endif
</code></pre>
<p>C symbol mangling is platform and architecture dependent, and a helper
function is needed to detect it. For example, Windows 32-bit prefixes
underscore, but 64-bit does not. Linux does not prefix an underscore
but OS X does.</p>
<h2 id="vala">Vala</h2>
<p>GLib Resources compiled with
<a href="Gnome-module.html#compile_resources"><code>gnome.compile_resources</code></a> that
are added to the sources of a Vala build target will now cause the
appropriate <code>--gresources</code> flag to be passed to the Vala compiler so
you don't need to add that yourself to <code>vala_args:</code>.</p>
<h2 id="improvements-to-install-scripts">Improvements to install scripts</h2>
<p>You can now pass arguments to install scripts added with
<a href="Reference-manual_builtin_meson.html#mesonadd_install_script"><ins><code>meson.add_install_script()</code></ins></a>. All
arguments after the script name will be passed to the script.</p>
<p>The <code>MESON_INSTALL_DESTDIR_PREFIX</code> environment variable is now set
when install scripts are called. This contains the values of the
<code>DESTDIR</code> environment variable and the <code>prefix</code> option passed to Meson
joined together. This is useful because both those are usually
absolute paths, and joining absolute paths in a cross-platform way is
tricky. <a href="https://docs.python.org/3/library/os.path.html#os.path.join"><code>os.path.join</code> in
Python</a>
will discard all previous path segments when it encounters an absolute
path, and simply concatenating them will not work on Windows where
absolute paths begin with the drive letter.</p>
<h2 id="more-install-directories">More install directories</h2>
<p>Added new options <code>sbindir</code> and <code>infodir</code> that can be used for
installation.</p>
</div>
</div>
<div id="search_results">
<p>The results of the search are</p>
</div>
<div id="footer">
<hr>
<div class="license-description">
Website licensing information are available on the <a href="legal.html">Legal</a> page.
</div>
</div>
</div>
<div id="toc-column">
<div class="edit-button">
<a href="https://github.com/mesonbuild/meson/edit/master/docs/markdown/Release-notes-for-0.37.0.md" data-hotdoc-role="edit-button">Edit on GitHub</a>
</div>
<div id="toc-wrapper">
<nav id="toc"></nav>
</div>
</div>
</div>
</main>
<script src="assets/js/navbar_offset_scroller.js"></script>
</body>
</html>