<div dir="ltr"><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Feb 18, 2016 at 11:17 AM, Thomas Goirand <span dir="ltr"><<a href="mailto:zigo@debian.org" target="_blank">zigo@debian.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">Hi,<br>
<br>
I've seen Reno doing it, then some more. It's time that I raise the<br>
issue globally in this list before the epidemic spreads to the whole of<br>
OpenStack ! :)<br>
<br>
The last occurence I have found is in oslo.config (but please keep in<br>
mind this message is for all projects), which has, its doc/source/conf.py:<br>
<br>
git_cmd = ["git", "log", "--pretty=format:'%ad, commit %h'",<br>
           "--date=local","-n1"]<br>
html_last_updated_fmt = subprocess.check_output(git_cmd,<br>
                                                stdin=subprocess.PIPE)<br></blockquote><div><br></div><div>Probably a dumb question, but why do you need to build the HTML docs when you're building a package for Debian?<br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<br>
Of course, the .git folder is *NOT* available when building a package in<br>
Debian (and more generally, in downstream distros). This means that this<br>
kind of joke *will* break the build of the packages when they also build<br>
the docs of your project. And consequently, the package maintainers have<br>
to patch out the above lines from conf.py. It'd be best if it wasn't<br>
needed to do so.<br>
<br>
As a consequence, it is *not ok* to do "git log" anywhere in the sphinx<br>
docs. Please keep this in mind.<br>
<br>
More generally, it is wrong to assume that even the git command is<br>
present. For Mitaka b2, I had to add git as build-dependency on nearly<br>
all server packages, otherwise they would FTBFS (fail to build from<br>
source). This is plain wrong and makes no sense. I hope this can be<br>
reverted somehow.<br>
<br>
Thanks in advance for considering the above, and to try to see things<br>
from the package maintainer's perspective,<br>
Cheers,<br>
<br>
Thomas Goirand (zigo)<br>
<br>
<br>
__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</blockquote></div><br></div></div>