<div dir="ltr">It would be good for issues to get created for things that we know are wrong. Currently the homepage says to e-mail the list with issues, but I'll suggest that using a bugtracker would be better. Now that the code is hosted on github, what do users think about using the github issue tracker? The irony of using bugzilla to track python-bugzilla bugs is not lost on me, but it would be very convenient. Wherever bugs are kept, consider creating an issue to update specific docstrings that are out of date.<div><br></div><div>-Brian</div><div><br></div><div><br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Jun 1, 2015 at 10:08 AM, Cole Robinson <span dir="ltr"><<a href="mailto:crobinso@redhat.com" target="_blank">crobinso@redhat.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 06/01/2015 05:26 AM, Florian Weimer wrote:<br>
> The docstring for Bugzilla.query<br>
><br>
> def query(self, query):<br>
> '''Query bugzilla and return a list of matching bugs.<br>
> query must be a dict with fields like those in in<br>
> querydata['fields'].<br>
> Returns a list of Bug objects.<br>
> Also see the _query() method for details about the underlying<br>
> implementation.<br>
> '''<br>
> refers to _query, but this method is no longer very informative:<br>
><br>
> def _query(self, query):<br>
> # This is kinda redundant now, but various scripts call<br>
> # _query with their own assembled dictionaries, so don't<br>
> # drop this lest we needlessly break those users<br>
> log.debug("Calling Bug.search with: %s", query)<br>
> return self._proxy.Bug.search(query)<br>
><br>
> So it's a bit difficult to figure out how to actually compose queries.<br>
><br>
<br>
</span>Yeah many of the docstrings are out of date, sorry about that.<br>
<br>
If you're looking for code examples I recommend checking what<br>
/usr/bin/bugzilla does, it generally represents the preferred API usage.<br>
<span class="HOEnZb"><font color="#888888"><br>
- Cole<br>
</font></span><div class="HOEnZb"><div class="h5">_______________________________________________<br>
python-bugzilla mailing list<br>
<a href="mailto:python-bugzilla@lists.fedorahosted.org">python-bugzilla@lists.fedorahosted.org</a><br>
<a href="https://lists.fedorahosted.org/mailman/listinfo/python-bugzilla" target="_blank">https://lists.fedorahosted.org/mailman/listinfo/python-bugzilla</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr">Brian Bouterse<br></div></div>
</div>