Add commenting and make 'call-test.c' more understandable for developers
looking at using libspiro for other projects. Also clarify that PTHREADS
is not part of libspiro, but helps check that multithreading is safe now
for thread-heavy processes such as GEGL.