aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJon Turney <jon.turney@dronecode.org.uk>2018-06-05 23:32:39 +0100
committerNirbheek Chauhan <nirbheek.chauhan@gmail.com>2018-06-10 01:47:51 +0000
commitc2cb2f5c1c73b64e3176abbe19f8de59458f81e6 (patch)
tree8394cf9c4b80fa82636bcda71b9dd866d666c664 /docs
parent7529606f4c1fb6ddaf53797c99d55b6756a9b241 (diff)
downloadmeson-c2cb2f5c1c73b64e3176abbe19f8de59458f81e6.zip
meson-c2cb2f5c1c73b64e3176abbe19f8de59458f81e6.tar.gz
meson-c2cb2f5c1c73b64e3176abbe19f8de59458f81e6.tar.bz2
Alphabetize custom dependencies [skip ci]
Diffstat (limited to 'docs')
-rw-r--r--docs/markdown/Dependencies.md123
1 files changed, 62 insertions, 61 deletions
diff --git a/docs/markdown/Dependencies.md b/docs/markdown/Dependencies.md
index 85125a6..8e8ce2f 100644
--- a/docs/markdown/Dependencies.md
+++ b/docs/markdown/Dependencies.md
@@ -111,6 +111,26 @@ of all the work behind the scenes to make this work.
# Dependencies with custom lookup functionality
+## Dependencies using config tools
+
+CUPS, [LLVM](#llvm), PCAP, [WxWidgets](#wxwidgets), libwmf, and GnuStep either do not
+provide pkg-config modules or additionally can be detected via a config tool
+(cups-config, llvm-config, etc). Meson has native support for these tools, and
+they can be found like other dependencies:
+
+```meson
+pcap_dep = dependency('pcap', version : '>=1.0')
+cups_dep = dependency('cups', version : '>=1.4')
+llvm_dep = dependency('llvm', version : '>=4.0')
+```
+
+Some of these tools (like wmf and cups) provide both pkg-config and config
+tools support. You can force one or another via the method keyword:
+
+```meson
+wmf_dep = dependency('libwmf', method : 'config-tool')
+```
+
## AppleFrameworks
Use the `modules` keyword to list frameworks required, e.g.
@@ -167,6 +187,36 @@ gtest_dep = dependency('gtest', main : true, required : false)
e = executable('testprog', 'test.cc', dependencies : gtest_dep)
test('gtest test', e)
```
+
+## LLVM
+
+Meson has native support for LLVM going back to version LLVM version 3.5.
+It supports a few additional features compared to other config-tool based
+dependencies.
+
+As of 0.44.0 Meson supports the `static` keyword argument for LLVM. Before this
+LLVM >= 3.9 would always dynamically link, while older versions would
+statically link, due to a quirk in `llvm-config`.
+
+### Modules, a.k.a. Components
+
+Meson wraps LLVM's concept of components in it's own modules concept.
+When you need specific components you add them as modules as meson will do the
+right thing:
+
+```meson
+llvm_dep = dependency('llvm', version : '>= 4.0', modules : ['amdgpu'])
+```
+
+As of 0.44.0 it can also take optional modules (these will affect the arguments
+generated for a static link):
+
+```meson
+llvm_dep = dependency(
+ 'llvm', version : '>= 4.0', modules : ['amdgpu'], optional_modules : ['inteljitevents'],
+)
+```
+
## MPI
MPI is supported for C, C++ and Fortran. Because dependencies are
@@ -190,6 +240,18 @@ for OpenMP support.
The `language` keyword may used.
+## Python3
+
+Python3 is handled specially by meson:
+1. Meson tries to use `pkg-config`.
+1. If `pkg-config` fails meson uses a fallback:
+ - On Windows the fallback is the current `python3` interpreter.
+ - On OSX the fallback is a framework dependency from `/Library/Frameworks`.
+
+Note that `python3` found by this dependency might differ from the one used in
+`python3` module because modules uses the current interpreter, but dependency tries
+`pkg-config` first.
+
## Qt4 & Qt5
Meson has native Qt support. Its usage is best demonstrated with an
@@ -250,26 +312,6 @@ and avoids trying to link with it's non-PIC static libs.
Vulkan can be located using `pkg-config`, or the `VULKAN_SDK` environment variable.
-## Dependencies using config tools
-
-CUPS, LLVM, PCAP, [WxWidgets](#wxwidgets), libwmf, and GnuStep either do not
-provide pkg-config modules or additionally can be detected via a config tool
-(cups-config, llvm-config, etc). Meson has native support for these tools, and
-they can be found like other dependencies:
-
-```meson
-pcap_dep = dependency('pcap', version : '>=1.0')
-cups_dep = dependency('cups', version : '>=1.4')
-llvm_dep = dependency('llvm', version : '>=4.0')
-```
-
-Some of these tools (like wmf and cups) provide both pkg-config and config
-tools support. You can force one or another via the method keyword:
-
-```meson
-wmf_dep = dependency('libwmf', method : 'config-tool')
-```
-
## WxWidgets
Similar to [Boost](#boost), WxWidgets is not a single library but rather
@@ -293,44 +335,3 @@ $ wx-config --cxxflags std stc
# link_args:
$ wx-config --libs std stc
```
-
-## LLVM
-
-Meson has native support for LLVM going back to version LLVM version 3.5.
-It supports a few additional features compared to other config-tool based
-dependencies.
-
-As of 0.44.0 Meson supports the `static` keyword argument for LLVM. Before this
-LLVM >= 3.9 would always dynamically link, while older versions would
-statically link, due to a quirk in `llvm-config`.
-
-### Modules, a.k.a. Components
-
-Meson wraps LLVM's concept of components in it's own modules concept.
-When you need specific components you add them as modules as meson will do the
-right thing:
-
-```meson
-llvm_dep = dependency('llvm', version : '>= 4.0', modules : ['amdgpu'])
-```
-
-As of 0.44.0 it can also take optional modules (these will affect the arguments
-generated for a static link):
-
-```meson
-llvm_dep = dependency(
- 'llvm', version : '>= 4.0', modules : ['amdgpu'], optional_modules : ['inteljitevents'],
-)
-```
-
-## Python3
-
-Python3 is handled specially by meson:
-1. Meson tries to use `pkg-config`.
-1. If `pkg-config` fails meson uses a fallback:
- - On Windows the fallback is the current `python3` interpreter.
- - On OSX the fallback is a framework dependency from `/Library/Frameworks`.
-
-Note that `python3` found by this dependency might differ from the one used in
-`python3` module because modules uses the current interpreter, but dependency tries
-`pkg-config` first.