Virtualization
/
meson
mirror of https://gitlab.com/qemu-project/meson.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
meson/docs/markdown/Feature-autodetection.md

42 lines
1.6 KiB
Markdown
Raw Normal View History

docs: add a short description for all top pages in the Manual
2017-05-03 17:38:41 +08:00
---
short-description: Auto-detection of features like ccache and code coverage
...
docs: Import the website and wiki and build with hotdoc This allows us to more easily have the documentation in sync with the source code as people will have to document new features etc right at the time where they implement it.
2017-03-30 02:03:43 +08:00
# Feature autodetection
Rewrap text. [skip ci]
2019-04-25 04:19:13 +08:00
Meson is designed for high productivity. It tries to do as many things
automatically as it possibly can.
docs: Import the website and wiki and build with hotdoc This allows us to more easily have the documentation in sync with the source code as people will have to document new features etc right at the time where they implement it.
2017-03-30 02:03:43 +08:00
Update to new ccache URL ccache’s web site is now located at https://ccache.dev. Bonus: Use the preferred capitalization “Ccache” instead of “CCache”.
2019-05-26 16:05:16 +08:00
Ccache
docs: Import the website and wiki and build with hotdoc This allows us to more easily have the documentation in sync with the source code as people will have to document new features etc right at the time where they implement it.
2017-03-30 02:03:43 +08:00
--
Update to new ccache URL ccache’s web site is now located at https://ccache.dev. Bonus: Use the preferred capitalization “Ccache” instead of “CCache”.
2019-05-26 16:05:16 +08:00
[Ccache](https://ccache.dev/) is a cache system designed to make
Rewrap text. [skip ci]
2019-04-25 04:19:13 +08:00
compiling faster. When you run Meson for the first time for a given
Update to new ccache URL ccache’s web site is now located at https://ccache.dev. Bonus: Use the preferred capitalization “Ccache” instead of “CCache”.
2019-05-26 16:05:16 +08:00
project, it checks if Ccache is installed. If it is, Meson will use it
Rewrap text. [skip ci]
2019-04-25 04:19:13 +08:00
automatically.
docs: Import the website and wiki and build with hotdoc This allows us to more easily have the documentation in sync with the source code as people will have to document new features etc right at the time where they implement it.
2017-03-30 02:03:43 +08:00
Update to new ccache URL ccache’s web site is now located at https://ccache.dev. Bonus: Use the preferred capitalization “Ccache” instead of “CCache”.
2019-05-26 16:05:16 +08:00
If you do not wish to use Ccache for some reason, just specify your
Rewrap text. [skip ci]
2019-04-25 04:19:13 +08:00
compiler with environment variables `CC` and/or `CXX` when first
Change "can not" to "cannot" throughout project The word "cannot" expresses inability to do something whereas "can not" expresses the ability to refrain from doing something.
2023-04-10 02:00:51 +08:00
running Meson (remember that once specified the compiler cannot be
Update to new ccache URL ccache’s web site is now located at https://ccache.dev. Bonus: Use the preferred capitalization “Ccache” instead of “CCache”.
2019-05-26 16:05:16 +08:00
changed). Meson will then use the specified compiler without Ccache.
docs: Import the website and wiki and build with hotdoc This allows us to more easily have the documentation in sync with the source code as people will have to document new features etc right at the time where they implement it.
2017-03-30 02:03:43 +08:00
Coverage
--
Rewrap text. [skip ci]
2019-04-25 04:19:13 +08:00
When doing a code coverage build, Meson will check for existence of
the binaries `gcovr`, `lcov` and `genhtml`. If version 3.3 or higher
of the first is found, targets called *coverage-text*, *coverage-xml*
Add support for gcovr --sonarqube report Sonarcloud.io only can read the sonarqube based report that gcovr can produce. This change enables support for this output in meson and ninja. Signed-off-by: Weston Schmidt <Weston_Schmidt@alumni.purdue.edu>
2021-07-13 18:17:27 +08:00
and *coverage-html* are generated. If version 4.2 or higher of the
first is found, targets *coverage-text*, *coverage-xml*, *coverage-sonarqube*
Rewrap text. [skip ci]
2019-04-25 04:19:13 +08:00
and *coverage-html* are generated. Alternatively, if the latter two
are found, only the target *coverage-html* is generated. Coverage
Replaced `ninja` with `meson` [skip ci]
2020-06-30 23:32:27 +08:00
reports can then be produced simply by calling e.g. `meson compile
Rewrap text. [skip ci]
2019-04-25 04:19:13 +08:00
coverage-xml`. As a convenience, a high-level *coverage* target is
also generated which will produce all 3 coverage report types, if
possible.
Document the requirement to run tests before coverage [skip ci] Co-authored-by: Vedran Miletić <vedran@miletic.net>
2020-03-10 03:55:17 +08:00
Note that generating any of the coverage reports described above
docs: replaced `ninja` with appropriate `meson` commands [skip ci]
2020-06-15 23:36:08 +08:00
requires the tests (i.e. `meson test`) to finish running so the
Document the requirement to run tests before coverage [skip ci] Co-authored-by: Vedran Miletić <vedran@miletic.net>
2020-03-10 03:55:17 +08:00
information about the functions that are called in the tests can be
gathered for the report.