aboutsummaryrefslogtreecommitdiff
path: root/manifest-reference.md
diff options
context:
space:
mode:
authorLKedward <laurence.kedward@bristol.ac.uk>2021-04-12 16:54:35 +0100
committerLKedward <laurence.kedward@bristol.ac.uk>2021-04-12 16:54:35 +0100
commit2c0975b729e173042bec227e10fb6bf40a1609dd (patch)
treebe79339f08172f293bbf198846598ca47475b263 /manifest-reference.md
parenta49b0177f8d7ca74b3bfaa325fd37ee614975367 (diff)
downloadfpm-2c0975b729e173042bec227e10fb6bf40a1609dd.tar.gz
fpm-2c0975b729e173042bec227e10fb6bf40a1609dd.zip
Update: manifest-reference with new external-modules key
Diffstat (limited to 'manifest-reference.md')
-rw-r--r--manifest-reference.md22
1 files changed, 22 insertions, 0 deletions
diff --git a/manifest-reference.md b/manifest-reference.md
index 1a33dc1..89bf1db 100644
--- a/manifest-reference.md
+++ b/manifest-reference.md
@@ -33,6 +33,8 @@ Every manifest file consists of the following sections:
Toggle automatic discovery of executables
- [*link*](#link-external-libraries):
Link with external dependencies
+ - [*external-modules*](#use-system-installed-modules):
+ Specify modules used that are not within your fpm package
- Target sections:
- [*library*](#library-configuration)
Configuration of the library target
@@ -353,6 +355,26 @@ In this case the order of the libraries matters:
link = ["blas", "lapack"]
```
+## Use system-installed modules
+
+To use modules that are not defined within your fpm package or its dependencies,
+specify the module name using the *external-modules* key in the *build* table.
+
+*Example:*
+
+```toml
+[build]
+external-modules = "netcdff"
+```
+
+Multiple external modules can be specified as a list.
+
+*Example:*
+
+```toml
+[build]
+external-modules = ["netcdff","h5lt"]
+```
## Automatic target discovery