quarnster/SublimeClang — pull request #30 by berenm (2012-02-04 21:23:49+00:00)
Title: Added replacement of ${home} ${project_path:} and ${folder:} tokens in the configuration values. 

${home} is replaced with the value of the HOME environment variable.

${project_path:} tries to find a file with the given name in all the registered project folders and
returns the first file found, or the original file name if none is found.
Example: ${project_path:project.sublime-project} tries to find a file named "project.sublime-project" relative
to the current project's folders. If none is found, it is replaced with "project.sublime-project".

${folder:} is replaced with the dirname of the given path.
Example: ${folder:/path/to/file} is replaced with "/path/to".

Replacement is done sequencially, first all ${home} tokens, then all ${project_path:} are resolved, and then the
${folder:} are replaced.

--

This allows users to have include paths relative to the project location, and solves the problem of updating the settings if the project location changes.