irony-header-comp -> irony-pp
Improve shorten-path method
renaming/reformatting of some code for clarity
Fix unit test of renamed function
CBD: Make it faster by avoiding parsing all the compile commands

The parsing is done only for the files in use. The downside is that the
flags for the headers may not be found until the main file is opened.
Small doc update: fix typos, FAQ takes less space