[openstack-dev] [all] Please do *not* use git (and specifically "git log") when generating the docs

Dolph Mathews dolph.mathews at gmail.com
Sun Feb 21 00:51:43 UTC 2016


On Saturday, February 20, 2016, Thomas Goirand <zigo at debian.org> wrote:

> 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
> <javascript:;>
> > <mailto:zigo at debian.org <javascript:;>>> 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?


Mike Bayer already answered my question politely.


>
> Cheers,
>
> Thomas Goirand (zigo)
>
>
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20160220/391c75cd/attachment.html>


More information about the OpenStack-dev mailing list