<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&#39;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">&lt;<a href="mailto:crobinso@redhat.com" target="_blank">crobinso@redhat.com</a>&gt;</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>
&gt; The docstring for Bugzilla.query<br>
&gt;<br>
&gt;     def query(self, query):<br>
&gt;         &#39;&#39;&#39;Query bugzilla and return a list of matching bugs.<br>
&gt;         query must be a dict with fields like those in in<br>
&gt; querydata[&#39;fields&#39;].<br>
&gt;         Returns a list of Bug objects.<br>
&gt;         Also see the _query() method for details about the underlying<br>
&gt;         implementation.<br>
&gt;         &#39;&#39;&#39;<br>
&gt; refers to _query, but this method is no longer very informative:<br>
&gt;<br>
&gt;     def _query(self, query):<br>
&gt;         # This is kinda redundant now, but various scripts call<br>
&gt;         # _query with their own assembled dictionaries, so don&#39;t<br>
&gt;         # drop this lest we needlessly break those users<br>
&gt;         log.debug(&quot;Calling Bug.search with: %s&quot;, query)<br>
&gt;         return self._proxy.Bug.search(query)<br>
&gt;<br>
&gt; So it&#39;s a bit difficult to figure out how to actually compose queries.<br>
&gt;<br>
<br>
</span>Yeah many of the docstrings are out of date, sorry about that.<br>
<br>
If you&#39;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>