Danek Duvall wrote:
On Tue, Apr 28, 2009 at 03:41:36PM -0700, Brock Pytlik wrote:

http://cr.opensolaris.org/~bpytlik/ips-7364-checkformatting/

Please only look at client.py. I'm specifically looking for comments on
the formatting of the docstrings before I go through the entire code base
to adjust for the comments I got last time.

So I think you're going to do it as a dt/dd-style table, the various bits
should line up better, and there's no need to punctuate the argument name:

    tup       a four-tuple with each entry corresponding to a column
              of the output

    first     a boolean stating whether this is the first time this
              function has been called.  This controls the printing
              of the header information

But if you were to choose to do it the way it's done for the inventory()
method in image.py, that would be fine, too.

Danek

Thanks for the pointer, I'll probably use the inventory styling
Brock
_______________________________________________
pkg-discuss mailing list
[email protected]
http://mail.opensolaris.org/mailman/listinfo/pkg-discuss

Reply via email to