linking requirements for macros

Signed-off-by: Mattias Andrée <maandree@member.fsf.org>

2 files changed, 44 insertions, 5 deletions

diff --git a/doc/info/chap/clut-manipulation.texinfo b/doc/info/chap/clut-manipulation.texinfo
index d0d24fd..7659992 100644
--- a/doc/info/chap/clut-manipulation.texinfo
+++ b/doc/info/chap/clut-manipulation.texinfo
@@ -56,6 +56,8 @@ In this context, contrast is a measure of difference between
 the whitepoint and blackpoint, if the difference is 0 than
 they are both grey.
 
+Requires linking with @option{-lclut}.
+
 Parameters:
 @table @code
 @item r
@@ -90,6 +92,8 @@ Apply brightness correction on the colour curves using CIE xyY.
 In this context, brightness is a measure of the whiteness
 of the whitepoint.
 
+Requires linking with @option{-lclut}.
+
 Parameters:
 @table @code
 @item r
@@ -104,6 +108,8 @@ The brightness parameter for the blue curve.
 @item libclut_linearise(clut, max, type, r, g, b)
 Convert the curves from formatted in standard RGB to linear RGB.
 
+Requires linking with @option{-lclut}.
+
 Parameters:
 @table @code
 @item r
@@ -118,6 +124,8 @@ Whether to convert the blue colour curve.
 @item libclut_standardise(clut, max, type, r, g, b)
 Convert the curves from formatted in linear RGB to standard RGB.
 
+Requires linking with @option{-lclut}.
+
 Parameters:
 @table @code
 @item r
@@ -132,6 +140,8 @@ Whether to convert the blue colour curve.
 @item libclut_gamma(clut, max, type, r, g, b)
 Apply gamma correction on the colour curves.
 
+Requires linking with @option{-lm}.
+
 Parameters:
 @table @code
 @item r
@@ -176,6 +186,8 @@ Whether to invert the blue colour curve.
 Invert the colour curves (negative image with gamma
 invertion), using CIE xyY.
 
+Requires linking with @option{-lclut}.
+
 Parameters:
 @table @code
 @item r
@@ -196,6 +208,8 @@ before this to adjust the blackpoint as that is
 the only way to adjust the blackpoint on many LCD
 monitors.
 
+Requires linking with @option{-lm}.
+
 Parameters:
 @table @code
 @item rp
@@ -239,6 +253,8 @@ That is, the contrast on the blue channel.
 @item libclut_cie_limits(clut, max, type, rmin, rmax, gmin, gmax, bmin, bmax)
 Changes the blackpoint and the whitepoint, using CIE xyY.
 
+Requires linking with @option{-lclut}.
+
 Parameters:
 @table @code
 @item rmin
@@ -299,6 +315,8 @@ should be @code{double (*)(double)}.
 Manipulate the colour curves using a function on the
 CIE xyY colour space.
 
+Requires linking with @option{-lclut}.
+
 Parameters:
 @table @code
 @item r
@@ -413,6 +431,8 @@ Whether to apply the filter for the blue curve.
 @item libclut_cie_apply(clut, max, type, filter, fmax, ftype, r, g, b)
 Applies a filter or calibration, using CIE xyY.
 
+Requires linking with @option{-lclut}.
+
 Parameters:
 @table @code
 @item filter
@@ -429,10 +449,5 @@ Whether to apply the filter for the green curve.
 @item b
 Whether to apply the filter for the blue curve.
 @end table
-
-
-
 @end table
 
-@c TODO Which macros require -lclut?
-
diff --git a/src/libclut.h b/src/libclut.h
index 9421b29..2e5949d 100644
--- a/src/libclut.h
+++ b/src/libclut.h
@@ -61,6 +61,8 @@
  * 
  * None of the parameter may have side-effects.
  * 
+ * Requires linking with '-lclut'.
+ * 
  * @param  clut  Pointer to the gamma ramps, must have the arrays
  *               `red`, `green`, and `blue`, and the scalars
  *               `red_size`, `green_size`, and `blue_size`. Ramp
@@ -110,6 +112,8 @@
  * 
  * None of the parameter may have side-effects.
  * 
+ * Requires linking with '-lclut'.
+ * 
  * @param  clut  Pointer to the gamma ramps, must have the arrays
  *               `red`, `green`, and `blue`, and the scalars
  *               `red_size`, `green_size`, and `blue_size`. Ramp
@@ -130,6 +134,8 @@
  * 
  * None of the parameter may have side-effects.
  * 
+ * Requires linking with '-lclut'.
+ * 
  * @param  clut  Pointer to the gamma ramps, must have the arrays
  *               `red`, `green`, and `blue`, and the scalars
  *               `red_size`, `green_size`, and `blue_size`. Ramp
@@ -159,6 +165,8 @@
  * 
  * None of the parameter may have side-effects.
  * 
+ * Requires linking with '-lclut'.
+ * 
  * @param  clut  Pointer to the gamma ramps, must have the arrays
  *               `red`, `green`, and `blue`, and the scalars
  *               `red_size`, `green_size`, and `blue_size`. Ramp
@@ -188,6 +196,8 @@
  * 
  * None of the parameter may have side-effects.
  * 
+ * Requires linking with '-lm'.
+ * 
  * @param  clut  Pointer to the gamma ramps, must have the arrays
  *               `red`, `green`, and `blue`, and the scalars
  *               `red_size`, `green_size`, and `blue_size`. Ramp
@@ -286,6 +296,8 @@
  * 
  * None of the parameter may have side-effects.
  * 
+ * Requires linking with '-lclut'.
+ * 
  * @param  clut  Pointer to the gamma ramps, must have the arrays
  *               `red`, `green`, and `blue`, and the scalars
  *               `red_size`, `green_size`, and `blue_size`. Ramp
@@ -311,6 +323,8 @@
  * 
  * None of the parameter may have side-effects.
  * 
+ * Requires linking with '-lm'.
+ * 
  * @param  clut  Pointer to the gamma ramps, must have the arrays
  *               `red`, `green`, and `blue`, and the scalars
  *               `red_size`, `green_size`, and `blue_size`. Ramp
@@ -391,6 +405,8 @@
  * 
  * None of the parameter may have side-effects.
  * 
+ * Requires linking with '-lclut'.
+ * 
  * @param  clut  Pointer to the gamma ramps, must have the arrays
  *               `red`, `green`, and `blue`, and the scalars
  *               `red_size`, `green_size`, and `blue_size`. Ramp
@@ -450,6 +466,8 @@
  * 
  * None of the parameter may have side-effects.
  * 
+ * Requires linking with '-lclut'.
+ * 
  * @param  clut  Pointer to the gamma ramps, must have the arrays
  *               `red`, `green`, and `blue`, and the scalars
  *               `red_size`, `green_size`, and `blue_size`. Ramp
@@ -694,6 +712,8 @@
  * 
  * None of the parameter may have side-effects.
  * 
+ * Requires linking with '-lclut'.
+ * 
  * @param  clut    Pointer to the gamma ramps, must have the arrays
  *                 `red`, `green`, and `blue`, and the scalars
  *                 `red_size`, `green_size`, and `blue_size`. Ramp
@@ -756,6 +776,8 @@
  * 
  * None of the parameter may have side-effects.
  * 
+ * Requires linking with '-lclut'.
+ * 
  * This is intended for internal use.
  * 
  * @param  clut   Pointer to the gamma ramps, must have the arrays
@@ -854,6 +876,8 @@
  * 
  * None of the parameter may have side-effects.
  * 
+ * Requires linking with '-lclut'.
+ * 
  * This is intended for internal use.
  * Assumes the existence of variables defined in `libclut_cie__`.
  *