Document additional configuration needed for using the iconv binding

Author: jonas

build.sbt

@@ -215,13 +215,18 @@ lazy val bindings = project("bindings")
 lazy val libiconv = bindingProject("iconv")
   .configure(binding("iconv.h"))
   .settings(
-    Test / nativeLinkingOptions ++= {
-      // Link with libiconv on macOS.
+    //#sbt-iconv-linking-options
+    Compile / nativeLinkingOptions ++= {
       Option(System.getProperty("os.name")) match {
         case Some("Mac OS X") => Seq("-liconv")
         case _                => Seq.empty
       }
     }
+    //#sbt-iconv-linking-options
+    ,
+    Test / nativeLinkingOptions ++= {
+      (Compile / nativeLinkingOptions).value
+    }
   )
 
 //#sbt-binding-project-multi-header

docs/src/paradox/bindings/iconv.md

@@ -6,6 +6,11 @@ To use this binding add the following resolver and the dependency:
 
 @@binding[iconv]
 
+You also need to configure your build tool to link with the iconv library on macOS.
+For sbt, you can use the following code:
+
+@@snip[sbt-iconv](../../../../build.sbt) { #sbt-iconv-linking-options }
+
 ## Example
 
 @@snip [iconv](../../../../bindings/iconv/src/test/scala/org/scalanative/bindgen/bindings/tests/IconvSpec.scala) { #usage-example }