aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/Release-notes-for-0.59.0.md
blob: 8a04d343d47812410ff35cf12615d774895206d4 (plain)
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
---
title: Release 0.59.0
short-description: Release notes for 0.59.0
...

# New features

## Unescaped variables in pkgconfig files

Spaces in variable values are escaped with `\`, this is required in the case the
value is a path that and is used in `cflags` or `libs` arguments. This was an
undocumented behaviour that caused issues in the case the variable is a space
separated list of items.

For backward compatibility reasons this behaviour could not be changed, new
keyword arguments have thus been added: `unescaped_variables` and
`unescaped_uninstalled_variables`.

```meson
pkg = import('pkgconfig')
...
pkg.generate(lib,
  variables: {
    'mypath': '/path/with spaces/are/escaped',
  },
  unescaped_variables: {
    'mylist': 'Hello World Is Not Escaped',
  },
)
```

## The custom_target() function now accepts a feed argument

It is now possible to provide a `feed: true` argument to `custom_target()` to
pipe the target's input file to the program's standard input.

## Separate functions for qt preprocess

`qt.preprocess` is a large, complicated function that does a lot of things,
a new set of `compile_*` functions have been provided as well. These are
conceptually simpler, as they do a single thing.

## Cython as as first class language

Meson now supports Cython as a first class language. This means you can write:

```meson
project('my project', 'cython')

py = import('python').find_installation()
dep_py = py.dependency()

py.extension_module(
    'foo',
    'foo.pyx',
    dependencies : dep_py,
)
```

And avoid the step through a generator that was previously required.

## Support for the Wine Resource Compiler

Users can now choose `wrc` as the `windres` binary in their cross files and
`windows.compile_resources` will handle it correctly. Together with `winegcc`
patches in Wine 6.12 this enables basic support for compiling projects as a
winelib by specifying `winegcc`/`wineg++` as the compiler and `wrc` as the
resource compiler in a cross file.

## New `vs2012` and `vs2013` backend options

Adds the ability to generate Visual Studio 2012 and 2013 projects.  This is an
extension to the existing Visual Studio 2010 projects so that it is no longer
required to manually upgrade the generated Visual Studio 2010 projects.

Generating Visual Studio 2010 projects has also been fixed since its developer
command prompt does not provide a `%VisualStudioVersion%` envvar.

## Developer environment

Expand the support for the `link_whole:` project option for pre-Visual Studio 2015
Update 2, where previously Visual Studio 2015 Update 2 or later was required for
this, for the Ninja backend as well as the vs2010 (as well as the newly-added
vs2012 and vs2013 backends).

## Fs Module now accepts files objects

It is now possible to define a `files()` object and run most Fs module
functions on the file, rather than passing a string and hoping it is in the
same directory.


## Compiler argument checking for `get_supported_arguments`

The compiler method `get_supported_arguments` now supports
a new keyword argument named `checked` that can be set to
one of `warn`, `require` or `off` (defaults to `off`) to
enforce argument checks.

## New custom dependency for libintl

Meson can now find the library needed for translating messages via gettext.
This works both on systems where libc provides gettext, such as GNU or musl,
and on systems where the gettext project's standalone intl support library is
required, such as macOS.

Rather than doing something such as:

```
intl_dep = dependency('', required: false)

if cc.has_function('ngettext')
  intl_found = true
else
  intl_dep = cc.find_library('intl', required: false)
  intl_found = intl_dep.found()
endif

if intl_found
  # build options that need gettext
  conf.set('ENABLE_NLS', 1)
endif
```

one may simply use:

```
intl_dep = dependency('intl', required: false)

if intl_dep.found()
  # build options that need gettext
  conf.set('ENABLE_NLS', 1)
endif
```

## Parallelized `meson subprojects` commands

All `meson subprojects` commands are now run on each subproject in parallel by
default. The number of processes can be controlled with `--num-processes`
argument.

This speeds up considerably IO-bound operations such as downloads and git fetch.

## Using Vala no longer requires C in the project languages

Meson will now add C automatically. Since the use of C is an implementation
detail of Vala, Meson shouldn't require users to add it.

## The `import()` function gains `required` and `disabler` arguments

In addition, modules now have a `found()` method, like programs and
dependencies. This allows them to be conditionally required, and used in most
places that an object with a `found()` method can be.

## Objective C/C++ standard versions

Objective C and C++ compilations will from now on use the language
versions set in `c_std` and `cpp_std`, respectively. It is not
possible to set the language version separately for Objective C and
plain C.

## Qt.preprocess source arguments deprecated

The `qt.preprocess` method currently has this signature:
`qt.preprocess(name: str | None, *srcs: str)`, this is not a nice signature
because it's confusing, and there's a `sources` keyword argument as well.
Both of these pass sources through unmodified, this is a bit of a historical
accident, and not the way that any other module works. These have been
deprecated, so instead of:
```meson
sources = qt.preprocess(
    name,
    list, of, sources,
    sources : [more, sources],
    ... # things to process,
)

executable(
    'foo',
    sources,
)
```
use
```meson
processed = qt.preprocess(
    name,
    ... # thins to process
)

executable(
    'foo',
    'list', 'of', 'sources', 'more', 'sources', processed,
)
```

## New `build target` methods

The [[@build_tgt]] object now supports
the following two functions, to ensure feature compatebility with
[[@external_program]] objects:

- `found()`: Always returns `true`. This function is meant
  to make executables objects feature compatible with
  `external program` objects. This simplifies
  use-cases where an executable is used instead of an external program.

- `path()`: **(deprecated)** does the exact same as `full_path()`.
  **NOTE:** This function is solely kept for compatebility
  with `external program` objects. It will be
  removed once the, also deprecated, corresponding `path()` function in the
  `external program` object is removed.

## Automatically set up Visual Studio environment

When Meson is run on Windows it will automatically set up the
environment to use Visual Studio if no other compiler toolchain
can be detected. This means that you can run Meson commands from
any command prompt or directly from any IDE. This sets up the
64 bit native environment. If you need any other, then you
need to set it up manually as before.

## `gnome.compile_schemas()` sets `GSETTINGS_SCHEMA_DIR` into devenv

When using `gnome.compile_schemas()` the location of the compiled schema is
added to `GSETTINGS_SCHEMA_DIR` environment variable when using
[`meson devenv`](Commands.md#devenv) command.

## `update_desktop_database` added to `gnome.post_install()`

Applications that install a `.desktop` file containing a `MimeType` need to update
the cache upon installation. Most applications do that using a custom script,
but it can now be done by Meson directly.

See [`gnome.post_install()`](Gnome-module.md#gnomepost_install).