-
Notifications
You must be signed in to change notification settings - Fork 4
/
Copy pathRelease-notes-for-0-60-0.html
555 lines (496 loc) · 25.1 KB
/
Release-notes-for-0-60-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
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
<!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.60.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-60-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="run_target-can-now-be-used-as-a-dependency">
<code>run_target</code> can now be used as a dependency</h2>
<p>A <code>run_target()</code> can now be saved in a variable and reused as a dependency in
an <code>alias_target()</code>. This can be used to create custom alias rules that ensure
multiple other targets are run, even if those targets don't produce output
files.</p>
<p>For example:</p>
<pre><code>i18n = import('i18n')
all_pot_targets = []
foo_i18n = i18n.gettext('foo')
all_pot_targets += foo_i18n[1]
alias_target('all-pot', all_pot_targets)
</code></pre>
<h2 id="the-python-modules-dependency-method-no-longer-accepts-positional-arguments">The Python Modules dependency method no longer accepts positional arguments</h2>
<p>Previously these were ignored with a warning, now they're a hard error.</p>
<h2 id="unset_variable"><code>unset_variable()</code></h2>
<p><code>unset_variable()</code> can be used to unset a variable. Reading a variable after
calling <code>unset_variable()</code> will raise an exception unless the variable is set
again.</p>
<pre><code class="language-meson"># tests/meson.build
tests = ['test1', 'test2']
# ...
unset_variable('tests')
# tests is no longer usable until it is set again
</code></pre>
<h2 id="override-python-installation-paths">Override python installation paths</h2>
<p>The <code>python</code> module now has options to control where modules are installed:</p>
<ul>
<li>python.platlibdir: Directory for site-specific, platform-specific files.</li>
<li>python.purelibdir: Directory for site-specific, non-platform-specific files.</li>
</ul>
<p>Those options are used by python module methods <code>python.install_sources()</code> and
<code>python.get_install_dir()</code>. By default Meson tries to detect the correct installation
path, but make them relative to the installation <code>prefix</code>, which will often result
in installed python modules to not be found by the interpreter unless <code>prefix</code>
is <code>/usr</code> on Linux, or for example <code>C:\Python39</code> on Windows. These new options
can be absolute paths outside of <code>prefix</code>.</p>
<h2 id="new-subprojects-packagefiles-subcommand">New <code>subprojects packagefiles</code> subcommand</h2>
<p>It is now possible to re-apply <code>meson.build</code> overlays (<code>patch_filename</code> or
<code>patch_directory</code> in the wrap ini file) after a subproject was downloaded and
set up, via <code>meson subprojects packagefiles --apply <wrap-name></code>.</p>
<p>It is also possible for <code>patch_directory</code> overlays in a <code>[wrap-file]</code>, to copy
the packagefiles out of the subproject and back into <code>packagefiles/<patch_directory>/</code>
via <code>meson subprojects packagefiles --save <wrap-name></code>. This is useful for
testing an edit in the subproject and then saving it back to the overlay which
is checked into git.</p>
<h2 id="deprecated-project-options">Deprecated project options</h2>
<p>Project options declared in <code>meson_options.txt</code> can now be marked as deprecated
and Meson will warn when user sets a value to it. It is also possible to deprecate
only some of the choices, and map deprecated values to a new value.</p>
<pre><code class="language-meson"># Option fully deprecated, it warns when any value is set.
option('o1', type: 'boolean', deprecated: true)
# One of the choices is deprecated, it warns only when 'a' is in the list of values.
option('o2', type: 'array', choices: ['a', 'b'], deprecated: ['a'])
# One of the choices is deprecated, it warns only when 'a' is in the list of values
# and replace it by 'c'.
option('o3', type: 'array', choices: ['a', 'b', 'c'], deprecated: {'a': 'c'})
# A boolean option has been replaced by a feature, old true/false values are remapped.
option('o4', type: 'feature', deprecated: {'true': 'enabled', 'false': 'disabled'})
# A feature option has been replaced by a boolean, enabled/disabled/auto values are remapped.
option('o5', type: 'boolean', deprecated: {'enabled': 'true', 'disabled': 'false', 'auto': 'false'})
</code></pre>
<h2 id="more-efficient-static-linking-of-uninstalled-libraries">More efficient static linking of uninstalled libraries</h2>
<p><strong>Note</strong>: This change had to be reverted in 0.60.1 because it caused regressions.
New API will likely be introduced in 0.61.0 to have better control whether or
not to create thin archive.</p>
<p>A somewhat common use case of <a href="Reference-manual_functions.html#static_library"><ins><code>static_library()</code></ins></a> is to create uninstalled
internal convenience libraries which are solely meant to be linked to other
targets. Some build systems call these "object libraries". Meson's
implementation does always create a static archive.</p>
<p>This will now check to see if the static linker supports "thin archives"
(archives which do not contain the actual object code, only references to their
location on disk) and if so, use them to minimize space usage and speed up
linking.</p>
<h2 id="gnomeyelp-variadic-argument-deprecation">gnome.yelp variadic argument deprecation</h2>
<p><code>gnome.yelp</code> previously allowed sources to be passed either as variadic
arguments or as a keyword argument. If the keyword argument was given the
variadic arguments would be silently ignored. This has changed in 0.60.0, the
variadic form has been deprecated, and a warning is printed if both are given.</p>
<h2 id="static-keyword-argument-to-mesonoverride_dependency">
<code>static</code> keyword argument to <code>meson.override_dependency()</code>
</h2>
<p>It is now possible to override shared and/or static dependencies separately.
When the <code>static</code> keyword argument is not specified in <code>dependency()</code>, the first
override will be used (<code>static_dep</code> in the example below).</p>
<pre><code class="language-meson">static_lib = static_library()
static_dep = declare_dependency(link_with: static_lib)
meson.override_dependency('foo', static_dep, static: true)
shared_lib = shared_library()
shared_dep = declare_dependency(link_with: shared_lib)
meson.override_dependency('foo', shared_dep, static: false)
# Returns static_dep
dependency('foo')
# Returns static_dep
dependency('foo', static: true)
# Returns shared_dep
dependency('foo', static: false)
</code></pre>
<p>When the <code>static</code> keyword argument is not specified in <code>meson.override_dependency()</code>,
the dependency is assumed to follow the value of <code>default_library</code> option.</p>
<pre><code class="language-meson">dep = declare_dependency(...)
meson.override_dependency('foo', dep)
# Always works
dependency('foo')
# Works only if default_library is 'static' or 'both'
dependency('foo', static: true)
# Works only if default_library is 'shared' or 'both'
dependency('foo', static: false)
</code></pre>
<h2 id="dependency-sets-default_library-on-fallback-subproject">
<code>dependency()</code> sets <code>default_library</code> on fallback subproject</h2>
<p>When the <code>static</code> keyword argument is set but <code>default_library</code> is missing in
<code>default_options</code>, <code>dependency()</code> will set it when configuring fallback
subproject. <code>dependency('foo', static: true)</code> is now equivalent to
<code>dependency('foo', static: true, default_options: ['default_library=static'])</code>.</p>
<h2 id="install_emptydir-function">install_emptydir function</h2>
<p>It is now possible to define a directory which will be created during
installation, without creating it as a side effect of installing files into it.
This replaces custom <code>meson.add_install_script()</code> routines. For example:</p>
<pre><code class="language-meson">meson.add_install_script('sh', '-c', 'mkdir -p "$DESTDIR/@0@"'.format(path))
</code></pre>
<p>can be replaced by:</p>
<pre><code class="language-meson">install_emptydir(path)
</code></pre>
<p>and as a bonus this works reliably on Windows, prints a sensible progress
message, will be uninstalled by <code>ninja uninstall</code>, etc.</p>
<h2 id="cython-can-now-transpile-to-c-as-an-intermediate-language">Cython can now transpile to C++ as an intermediate language</h2>
<p>Built-in cython support currently only allows C as an intermediate language, now
C++ is also allowed. This can be set via the <code>cython_language</code> option, either on
the command line, or in the meson.build files.</p>
<pre><code class="language-meson">project(
'myproject',
'cython',
default_options : ['cython_language=cpp'],
)
</code></pre>
<p>or on a per target basis with:</p>
<pre><code class="language-meson">python.extension_module(
'mod',
'mod.pyx',
override_options : ['cython_language=cpp'],
)
</code></pre>
<h2 id="new-custom-dependency-for-iconv">New custom dependency for iconv</h2>
<pre><code>dependency('iconv')
</code></pre>
<p>will now check for the functionality of libiconv.so, but first check if it is
provided in the libc (for example in glibc or musl libc on Linux).</p>
<h2 id="unknown-options-are-now-always-fatal">Unknown options are now always fatal</h2>
<p>Passing unknown options to "meson setup" or "meson configure" is now
always fatal. That is, Meson will exit with an error code if this
happens. Previous Meson versions only showed a warning message.</p>
<h2 id="install-destdir-relative-to-build-directory">Install DESTDIR relative to build directory</h2>
<p>When <code>DESTDIR</code> environment or <code>meson install --destdir</code> option is a relative path,
it is now assumed to be relative to the build directory. An absolute path will be
set into environment when executing scripts. It was undefined behavior in prior
Meson versions but was working as relative to build directory most of the time.</p>
<h2 id="java-module">Java Module</h2>
<p>The Java module has been added to Meson. The Java module allows users to
generate native header files without needing to use a <code>custom_target()</code>.</p>
<pre><code class="language-meson">jmod = import('java')
native_header = jmod.generate_native_header('File.java', package: 'com.mesonbuild')
native_header_includes = include_directories('.')
jdkjava = shared_module(
'jdkjava',
[native_header_includes, other_sources],
dependencies : [jdk],
include_directories : [native_header_includes]
)
</code></pre>
<h2 id="link-tests-can-use-sources-for-a-different-compiler">Link tests can use sources for a different compiler</h2>
<p>Usually, the <code>links</code> method of the compiler object uses a single program
invocation to do both compilation and linking. Starting with this version,
whenever the argument to <code>links</code> is a file, Meson will check if the file
suffix matches the compiler object's language. If they do not match,
as in the following case:</p>
<pre><code>cxx = meson.get_compiler('cpp')
cxx.links(files('test.c'))
</code></pre>
<p>then Meson will separate compilation and linking. In the above example
<code>test.c</code> will be compiled with a C compiler and the resulting object file
will be linked with a C++ compiler. This makes it possible to detect
misconfigurations of the compilation environment, for example when the
C++ runtime is not compatible with the one expected by the C compiler.</p>
<p>For this reason, passing file arguments with an unrecognized suffix to
<code>links</code> will cause a warning.</p>
<h2 id="relax-restrictions-of-strjoin">Relax restrictions of <code>str.join()</code>
</h2>
<p>Since 0.60.0, the <a href="Reference-manual_elementary_str.html#strjoin"><ins><code>str.join()</code></ins></a> method can take an arbitrary number of arguments
instead of just one list. Additionally, all lists past to <a href="Reference-manual_elementary_str.html#strjoin"><ins><code>str.join()</code></ins></a> will now
be flattened.</p>
<h2 id="improvements-for-the-rustc-compiler">Improvements for the Rustc compiler</h2>
<ul>
<li>Werror now works, this set's <code>-D warnings</code>, which will cause rustc to error
for every warning not explicitly disabled</li>
<li>warning levels have been implemented</li>
<li>support for meson's pic has been enabled</li>
</ul>
<h2 id="the-qt-modules-now-accept-generated-outputs-as-inputs-for-qtcompile_">The qt modules now accept generated outputs as inputs for qt.compile_*</h2>
<p>This means you can use <code>custom_target</code>, custom_target indices
(<code>custom_target[0]</code>, for example), or the output of <code>generator.process</code> as
inputs to the various <code>qt.compile_*</code> methods.</p>
<pre><code class="language-meson">qt = import('qt5')
ct = custom_target(...)
out = qt.compile_ui(sources : ct)
</code></pre>
<h2 id="waf-support-in-externalproject-module">Waf support in external-project module</h2>
<p>If the first argument is <code>'waf'</code>, special treatment is done for the
<a href="https://waf.io/">waf</a> build system. The waf executable must be
found either in the current directory, or in system <code>PATH</code>.</p>
<h2 id="comparing-two-objects-with-different-types-is-now-an-error">Comparing two objects with different types is now an error</h2>
<p>Using the <code>==</code> and <code>!=</code> operators to compare objects of different (for instance
<code>[1] == 1</code>) types was deprecated and undefined behavior since 0.45.0 and is
now a hard error.</p>
<h2 id="installation-tags">Installation tags</h2>
<p>It is now possible to install only a subset of the installable files using
<code>meson install --tags tag1,tag2</code> command line.</p>
<p>See <a href="Installing.html#installation-tags">documentation</a> for more details.</p>
<h2 id="compilerunittest_args-has-been-removed">Compiler.unittest_args has been removed</h2>
<p>It's never been documented, and it's been marked deprecated for a long time, so
let's remove it.</p>
<h2 id="dependencies-with-multiple-names">Dependencies with multiple names</h2>
<p>More than one name can now be passed to <code>dependency()</code>, they will be tried in order
and the first name to be found will be used. The fallback subproject will be
used only if none of the names are found on the system. Once one of the name has
been found, all other names are added into the cache so subsequent calls for any
of those name will return the same value. This is useful in case a dependency
could have different names, such as <code>png</code> and <code>libpng</code>.</p>
<h2 id="i18n-module-now-returns-gettext-targets">i18n module now returns gettext targets</h2>
<p><code>r = i18n.gettext('mydomain')</code> will now provide access to:</p>
<ul>
<li>a list of built .mo files</li>
<li>the mydomain-pot maintainer target which updates .pot files</li>
<li>the mydomain-update-po maintainer target which updates .po files</li>
</ul>
<h2 id="added-support-for-cla-sources-when-crosscompiling-with-the-c2000-toolchain">Added support for CLA sources when cross-compiling with the C2000 toolchain</h2>
<p>Support for CLA sources has been added for cross-compilation with the C2000 toolchain.</p>
<h2 id="support-for-clippydriver-as-a-rustc-wrapper">Support for clippy-driver as a rustc wrapper</h2>
<p>Clippy is a popular linting tool for Rust, and is invoked in place of rustc as a
wrapper. Unfortunately it doesn't proxy rustc's output, so we need to have a
small wrapper around it so that Meson can correctly detect the underlying rustc,
but still display clippy</p>
<h2 id="force-visual-studio-environment-activation">Force Visual Studio environment activation</h2>
<p>Since <code>0.59.0</code>, meson automatically activates Visual Studio environment on Windows
for all its subcommands, but only if no other compilers (e.g. <code>gcc</code> or <code>clang</code>)
are found, and silently continue if Visual Studio activation fails.</p>
<p><code>meson setup --vsenv</code> command line argument can now be used to force Visual Studio
activation even when other compilers are found. It also make Meson abort with an
error message when activation fails. This is especially useful for GitHub Actions
because their Windows images have gcc in their PATH by default.</p>
<p><code>--vsenv</code> is set by default when using <code>vs</code> backend.</p>
<p>Only <code>setup</code>, <code>compile</code>, <code>dist</code> and <code>devenv</code> subcommands now activate Visual Studio.</p>
<h2 id="msvc-compiler-now-assumes-utf8-source-code-by-default">MSVC compiler now assumes UTF-8 source code by default</h2>
<p>Every project that uses UTF-8 source files had to add manually <code>/utf-8</code> C/C++
compiler argument for MSVC otherwise they wouldn't work on non-English locale.
Meson now switched the default to UTF-8 to be more consistent with all other
compilers.</p>
<p>This can be overridden but using <code>/source-charset</code>:</p>
<pre><code class="language-meson">if cc.get_id() == 'msvc'
add_project_arguments('/source-charset:.XYZ', language: ['c', 'cpp'])
endif
</code></pre>
<p>See Microsoft documentation for details:
https://docs.microsoft.com/en-us/cpp/build/reference/source-charset-set-source-character-set.</p>
<h2 id="add-support-for-find_library-in-emscripten">Add support for <code>find_library</code> in Emscripten</h2>
<p>The <code>find_library</code> method can be used to find your own JavaScript
libraries. The limitation is that they must have the file extension
<code>.js</code>. Other library lookups will look up "native" libraries from the
system like currently. A typical usage would look like this:</p>
<pre><code class="language-meson">glue_lib = cc.find_library('gluefuncs.js',
dirs: meson.current_source_dir())
executable('prog', 'prog.c',
dependencies: glue_lib)
</code></pre>
<h2 id="optional-custom_target-name">Optional <code>custom_target()</code> name</h2>
<p>The name argument is now optional and defaults to the basename of the first
output.</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.60.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>