[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?


Thomas Goirand (zigo)

More information about the OpenStack-dev mailing list