From 581ec60b57d21dba846f0c34648f8968ad1bd7fc Mon Sep 17 00:00:00 2001
From: Sebastian Ehlert <28669218+awvwgk@users.noreply.github.com>
Date: Sun, 8 Nov 2020 12:13:53 +0100
Subject: Add specification for build.link in manifest reference

---
 manifest-reference.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

(limited to 'manifest-reference.md')

diff --git a/manifest-reference.md b/manifest-reference.md
index 5f0227a..f97136a 100644
--- a/manifest-reference.md
+++ b/manifest-reference.md
@@ -29,6 +29,8 @@ Every manifest file consists of the following sections:
     Toggle automatic discovery of test executables
   - [*auto-executables*](#automatic-target-discovery):
     Toggle automatic discovery of executables
+  - [*link*](#link-external-libraries):
+    Link with external dependencies
 - Target sections:
   - [*library*](#library-configuration)
     Configuration of the library target
@@ -282,6 +284,32 @@ helloff = { git = "https://gitlab.com/everythingfunctional/helloff.git" }
 ```
 
 
+## Link external libraries
+
+> Supported in Fortran fpm only
+
+To declare link time dependencies on external libraries a list of native libraries can be specified in the *link* entry.
+Specify either one library as string or a list of strings in case several libraries should be linked.
+When possible the project should only link one native library.
+The list of library dependencies is exported to dependent packages.
+
+*Example:*
+
+To link against the zlib compression library use
+
+```toml
+link = "z"
+```
+
+To dependent on LAPACK also BLAS should be linked.
+In this case the order of the libraries matters:
+
+```toml
+[build]
+link = ["blas", "lapack"]
+```
+
+
 ## Automatic target discovery
 
 > Supported in Fortran fpm only
-- 
cgit v1.2.3