-
Notifications
You must be signed in to change notification settings - Fork 4
/
Copy pathRelease-notes-for-0-53-0.html
428 lines (389 loc) · 15.7 KB
/
Release-notes-for-0-53-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
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
<!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.53.0</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-53-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="a-new-module-for-filesystem-operations">A new module for filesystem operations</h2>
<p>The new <code>fs</code> module can be used to examine the contents of the current
file system.</p>
<pre><code class="language-meson">fs = import('fs')
assert(fs.exists('important_file'),
'The important file is missing.')
</code></pre>
<h2 id="meson-dist-includesubprojects">meson dist --include-subprojects</h2>
<p><code>meson dist</code> command line now gained <code>--include-subprojects</code> command
line option. When enabled, the source tree of all subprojects used by
the current build will also be included in the final tarball. This is
useful to distribute self contained tarball that can be built offline
(i.e. <code>--wrap-mode=nodownload</code>).</p>
<h2 id="added-new-meson-templates-for-dlang-rust-objectivec">Added new Meson templates for <code>Dlang</code>, <code>Rust</code>, <code>Objective-C</code>
</h2>
<p>Meson now ships with predefined project templates for <code>Dlang</code>,
<code>Fortran</code>, <code>Rust</code>, <code>Objective-C</code>, and by passing the associated flags <code>d</code>,
<code>fortran</code>, <code>rust</code>, <code>objc</code> to <code>meson init --language</code>.</p>
<h2 id="add-a-new-summary-function">Add a new summary() function</h2>
<p>A new function <a href="Reference-manual_functions.html#summary"><ins><code>summary()</code></ins></a> has been
added to summarize build configuration at the end of the build
process.</p>
<p>Example:</p>
<pre><code class="language-meson">project('My Project', version : '1.0')
summary({'bindir': get_option('bindir'),
'libdir': get_option('libdir'),
'datadir': get_option('datadir'),
}, section: 'Directories')
summary({'Some boolean': false,
'Another boolean': true,
'Some string': 'Hello World',
'A list': ['string', 1, true],
}, section: 'Configuration')
</code></pre>
<p>Output:</p>
<pre><code>My Project 1.0
Directories
prefix: /opt/gnome
bindir: bin
libdir: lib/x86_64-linux-gnu
datadir: share
Configuration
Some boolean: False
Another boolean: True
Some string: Hello World
A list: string
1
True
</code></pre>
<h2 id="generic-overrider-for-dynamic-linker-selection">Generic Overrider for Dynamic Linker selection</h2>
<p>Previous to Meson 0.52.0 you set the dynamic linker using compiler
specific flags passed via language flags and hoped things worked out.
In version 0.52.0 Meson started detecting the linker and making
intelligent decisions about using it. Unfortunately this broke
choosing a non-default linker.</p>
<p>Now there is a generic mechanism for doing this. In 0.53.0, you can
use the <code>LD</code> environment variable. <strong>In 0.53.1</strong> this was changed to
<code><compiler_variable>_LD</code>, such as <code>CC_LD</code>, <code>CXX_LD</code>, <code>D_LD</code>, etc due
to regressions. The usual Meson <a href="https://mesonbuild.com/Running-Meson.html#environment-variables">environment variable
rules</a>
apply. Alternatively, you can add the following to a cross or native
file:</p>
<p>In 0.53.0:</p>
<pre><code class="language-ini">[binaries]
ld = 'gold'
</code></pre>
<p><strong>In 0.53.1 or newer</strong>:</p>
<pre><code class="language-ini">[binaries]
c = 'gcc'
c_ld = 'gold'
</code></pre>
<pre><code class="language-ini">[binaries]
c = 'clang'
c_ld = 'lld'
</code></pre>
<p>And Meson will select the linker if possible.</p>
<h2 id="fortran_std-option">
<code>fortran_std</code> option</h2>
<p><strong>new in 0.53.0</strong> Akin to the <code>c_std</code> and <code>cpp_std</code> options, the
<code>fortran_std</code> option sets Fortran compilers to warn or error on
non-Fortran standard code. Only the Gfortran and Intel Fortran
compilers have support for this option. Other Fortran compilers ignore
the <code>fortran_std</code> option.</p>
<p>Supported values for <code>fortran_std</code> include:</p>
<ul>
<li>
<code>legacy</code> for non-conforming code--this is especially important for Gfortran, which by default errors on old non-compliant Fortran code</li>
<li>
<code>f95</code> for Fortran 95 compliant code.</li>
<li>
<code>f2003</code> for Fortran 2003 compliant code.</li>
<li>
<code>f2008</code> for Fortran 2008 compliant code.</li>
<li>
<code>f2018</code> for Fortran 2018 compliant code.</li>
</ul>
<h2 id="pythondependency-embed-kwarg">python.dependency() embed kwarg</h2>
<p>Added the <code>embed</code> kwarg to the python module dependency function to
select the python library that can be used to embed python into an
application.</p>
<h2 id="scalapack">Scalapack</h2>
<p>added in <strong>0.53.0</strong>:</p>
<pre><code class="language-meson">scalapack = dependency('scalapack')
</code></pre>
<p>Historically and through today, typical Scalapack setups have broken
and incomplete pkg-config or FindScalapack.cmake. Meson handles
finding Scalapack on setups including:</p>
<ul>
<li>Linux: Intel MKL or OpenMPI + Netlib</li>
<li>MacOS: Intel MKL or OpenMPI + Netlib</li>
<li>Windows: Intel MKL (OpenMPI not available on Windows)</li>
</ul>
<h2 id="search-directories-for-find_program">Search directories for <code>find_program()</code>
</h2>
<p>It is now possible to give a list of absolute paths where <code>find_program()</code> should
also search, using the <code>dirs</code> keyword argument.</p>
<p>For example on Linux <code>/sbin</code> and <code>/usr/sbin</code> are not always in the <code>$PATH</code>:</p>
<pre><code class="language-meson">prog = find_program('mytool', dirs : ['/usr/sbin', '/sbin'])
</code></pre>
<h2 id="source-tags-targets">Source tags targets</h2>
<p>When the respective tools are available, 'ctags', 'TAGS' and 'cscope'
targets will be generated by Meson, unless you have defined your own.</p>
<h2 id="dictionary-entry-using-string-variable-as-key">Dictionary entry using string variable as key</h2>
<p>Keys can now be any expression evaluating to a string value, not limited
to string literals any more.</p>
<pre><code class="language-meson">d = {'a' + 'b' : 42}
k = 'cd'
d += {k : 43}
</code></pre>
<h2 id="improved-cmake-subprojects-support">Improved CMake subprojects support</h2>
<p>With this release even more CMake projects are supported via <a href="CMake-module.html#cmake-subprojects">CMake
subprojects</a> due to these internal
improvements:</p>
<ul>
<li>Use the CMake file API for CMake >=3.14</li>
<li>Handle the explicit dependencies via <code>add_dependency</code>
</li>
<li>Basic support for <code>add_custom_target</code>
</li>
<li>Improved <code>add_custom_command</code> support</li>
<li>Object library support on Windows</li>
</ul>
<h2 id="compilerget_linker_id">compiler.get_linker_id()</h2>
<p>since 0.53.0, <code>compiler.get_linker_id()</code> allows retrieving a lowercase
name for the linker. Since each compiler family can typically use a
variety of linkers depending on operating system, this helps users
define logic for corner cases not otherwise easily handled.</p>
<h2 id="cuda-dependency">CUDA dependency</h2>
<p>Native support for compiling and linking against the CUDA Toolkit
using the <code>dependency</code> function:</p>
<pre><code class="language-meson">project('CUDA test', 'cpp', meson_version: '>= 0.53.0')
exe = executable('prog', 'prog.cc', dependencies: dependency('cuda'))
</code></pre>
<p>See <a href="Dependencies.html#cuda">the CUDA dependency</a> for more information.</p>
<h2 id="added-global-option-to-disable-c-rtti">Added global option to disable C++ RTTI</h2>
<p>The new boolean option is called <code>cpp_rtti</code>.</p>
<h2 id="introspection-api-changes">Introspection API changes</h2>
<p>dependencies (--dependencies, intro-dependencies.json):</p>
<ul>
<li>added the <code>version</code> key</li>
</ul>
<p>scanning dependencies (--scan-dependencies):</p>
<ul>
<li>added the <code>version</code> key containing the required dependency version</li>
</ul>
<p>tests and benchmarks (--tests, --benchmarks, intro-tests.json,
intro-benchmarks.json):</p>
<ul>
<li>added the <code>protocol</code> key</li>
</ul>
</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.53.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>