giscanner: Make sure we use real paths in more places

Ensure we are using the real path also for cflags comming from
pkg_config files and command line options. This fixes the generation of
the gir files when include paths contain symlinks.

https://bugzilla.gnome.org/show_bug.cgi?id=712211