Question

is there a way to automatically get git/github to update the doc tags in a PHP document to reflect the current version/tag? Something like

/**
 * @version {tag} - {date}
 * @package My Product
 * @copyright (C) 2011 Me Inc.
 * @license see mylicense.txt
 */

If I go in and manually do a find/replace for these tags then it messes up the commit history, since every file looks like it was altered when it was simply a version change.

Thanks

Answer 1

You would have to tag after you change the code comment. Git bases the ids of commits based upon the contents of them. It’s better for build artifacts to contain version references. You can also take a look at smudge/clean scripts.

Hope this helps.