[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