Testsuite: Fix globbing command for all-headers tests, cleanup code

Turns out that globbing together a full path and manually extracting
relative paths is not the best idea. Clean up this mess by using
FILE(GLOB_RECURSE [base path] [...]) that produces nice relative paths.
Merge pull request #133 from tamiko/fix_header_tests

Bugfix: Fix all_header tests