CAPS Universe documentation  1.0.4
All you need to know to be successful
Using libcapsraster

Use pkg-config

Don't try to be smart, use pkg-config instead to retrieve the information you need to compile and link your application against libcapsraster.

To compile your code, just include its header:

API declaration to render documents page by page.

And ask pkg-config what include path is required to find this header file.

pkg-config --cflags libcapsraster

To link your application against libcapsraster ask pkg-config as well. Use the output of this command to parametrize the linker:

pkg-config --libs libcapsraster
Note
Whenever you call a function from libcapsraster in your application you also must link it against libcapsraster. Different libraries you use may already be linked against libcapsraster, but that does not work for your application when the linker option --as-needed is in use (which is the default in the CAPS universe).

Use autotools

Don't invent your own Makefile to build your package. Use the autotools or something similar to manage your buildsystem.

For the autotools just use the PKG_CHECK_MODULES m4 macro in your configure.ac to get the information you need to use libcapsraster:

PKG_CHECK_MODULES([LIBCAPSRASTER], [libcapsraster >= 1])

And then just refer this information in your Makefile.am:

my_application_CPPFLAGS = \
     @LIBCAPSRASTR_CFLAGS@
my_application_LDADD = \
     @LIBCAPSRASTER_LIBS@

Refer libcapsraster: API description for details.