【问题标题】:php documentation tags in gitgit中的php文档标签
【发布时间】:2011-09-06 12:29:12
【问题描述】:

有没有办法自动获取 git/github 来更新 PHP 文档中的 doc 标签以反映当前版本/标签?类似的东西

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

如果我手动查找/替换这些标签,那么它会弄乱提交历史记录,因为每个文件看起来都像是在只是版本更改时被更改了。

谢谢

【问题讨论】:

  • git 系统也必须修改文件,所以不管它看起来如何,即使是版本更改,它也会被更改。那就是说我确信有办法,但我想我会指出这一点。
  • 嗨布拉德——我在想 if 这可以像我想象的那样工作,变量 {tag} 和 {data} 将保持原样,并且只有在下载档案时才会被解释。
  • 如果文件没有更改,为什么要更改版本? :)
  • hi magnus--因为文件中的版本将对应于 git 标签(例如,我在 v 2.0 标记了代码的当前状态,这将在那个标签——即使有些文件没有从 v 1.0 版本修改,它们仍然属于 v2.0 产品)。

标签: php git documentation github


【解决方案1】:

您必须在更改代码注释后进行标记。 Git 基于提交的内容来确定提交的 id。构建工件最好包含版本引用。您还可以查看 smudge/clean 脚本。

希望这会有所帮助。

【讨论】:

  • @adymitruk--感谢您提供的信息,您能解释一下如何使用工件或它们是什么吗?谢谢!
  • 当然。正式发布后,请依赖 export TAG_NAME=v2.2.0 && git tag TAG_NAME && git push --tags && git export | tar xvzf /some/path/$TAG_NAME && echo release $TAG_NAME >> /some/path/releasenotes.txt && tar a /some/path . 之类的内容
猜你喜欢
  • 1970-01-01
  • 2011-07-18
  • 2011-01-20
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 2010-11-24
  • 2020-12-21
相关资源
最近更新 更多