[openstack-dev] [all] Please do *not* use git (and specifically "git log") when generating the docs
Thomas Goirand
zigo at debian.org
Sat Feb 20 07:56:25 UTC 2016
On 02/19/2016 05:39 AM, Dolph Mathews wrote:
>
> On Thu, Feb 18, 2016 at 11:17 AM, Thomas Goirand <zigo at debian.org
> <mailto:zigo at debian.org>> wrote:
>
> Hi,
>
> I've seen Reno doing it, then some more. It's time that I raise the
> issue globally in this list before the epidemic spreads to the whole of
> OpenStack ! :)
>
> The last occurence I have found is in oslo.config (but please keep in
> mind this message is for all projects), which has, its
> doc/source/conf.py:
>
> git_cmd = ["git", "log", "--pretty=format:'%ad, commit %h'",
> "--date=local","-n1"]
> html_last_updated_fmt = subprocess.check_output(git_cmd,
> stdin=subprocess.PIPE)
>
>
> Probably a dumb question, but why do you need to build the HTML docs
> when you're building a package for Debian?
If the doc is useful at all, why wouldn't it be useful in Debian?
Cheers,
Thomas Goirand (zigo)
More information about the OpenStack-dev
mailing list